Referência da API
Endereço base https://api.messgeo.com. Transfira o ficheiro OpenAPI.
Conta
/v1/meConta, pacote, âmbitos da chave e limites
/v1/me/creditsSaldo de créditos
/v1/me/usageUtilização diária da conta
/v1/me/alert-prefsAtualiza as preferências de email do Monitorização de Prompts
{
"digest": false,
"dry_run": false
}/v1/me/packagesPacotes, painel e site de cada um, lugares livres
Ferramentas
/v1/toolsLista ferramentas com o custo em créditos
/v1/tools/{slug}/runsExecuta uma ferramenta. Exige o cabeçalho Idempotency-Key, gasta créditos
{
"url": "https://example.com/",
"dry_run": false
}/v1/runsLista execuções
/v1/runs/{run_id}Devolve uma execução
Relatórios premium
/v1/ordersLista encomendas de relatórios premium
/v1/orders/{order_id}Devolve uma encomenda
/v1/orders/{order_id}/reportRelatório entregue em HTML
Monitorização de Prompts: leitura
/v1/panelsLista painéis
/v1/panels/{panel_id}Devolve um painel
/v1/panels/{panel_id}/promptsLista prompts
/v1/panels/{panel_id}/prompts/{prompt_id}/resultsResultados por motor de um prompt
/v1/panels/{panel_id}/statsVisibilidade por medição
/v1/panels/{panel_id}/answersRespostas de IA. O Starter recebe excertos em lista e texto completo com filtro de prompt
/v1/panels/{panel_id}/sourcesFontes citadas
/v1/panels/{panel_id}/competitorsConcorrentes
/v1/panels/{panel_id}/opportunitiesOportunidades de fontes
/v1/panels/{panel_id}/alertsAlertas
/v1/panels/{panel_id}/eventsEventos do painel
/v1/panels/{panel_id}/actionsAções
/v1/panels/{panel_id}/exportExportação CSV, uma vez por minuto por chave
/v1/panels/{panel_id}/setupEstado de configuração de um rascunho com prompts candidatos
/v1/panels/{panel_id}/prompts/metricsPosição, primeiro lugar e sentimento por prompt
/v1/panels/{panel_id}/marketMapa do mercado
/v1/panels/{panel_id}/brandImagem da marca e verificação do site
/v1/panels/{panel_id}/insightsRecomendações e prompts em foco
/v1/panels/{panel_id}/enginesTaxas de funcionalidades por motor
/v1/panels/{panel_id}/sources/gapsFontes que citam rivais mas não a sua marca
/v1/panels/{panel_id}/gscConsultas do Search Console
/v1/panels/{panel_id}/ga4Visitas de assistentes de IA
/v1/panels/{panel_id}/integrationsEstado das integrações e endereço de ligação
/v1/panels/{panel_id}/sharesLigações de partilha
Monitorização de Prompts: escrita
/v1/panelsCria um painel num pacote Pro livre e devolve um rascunho
{
"brand": "Acme Ltd",
"website": "https://example.com/",
"competitors": [
"Rival One"
],
"country": "pt",
"language": "en",
"dry_run": true
}/v1/panels/{panel_id}Altera país, idioma e motores. Remover um motor apaga os dados e exige confirm true
{
"country": "tr",
"language": "tr",
"engines": [
"chatgpt",
"gemini"
],
"confirm": false,
"dry_run": true
}/v1/panels/{panel_id}Apaga um painel e os dados. Exige confirm true
{
"confirm": true,
"dry_run": true
}/v1/panels/{panel_id}/promptsAdiciona prompts, no máximo 20 por chamada
{
"prompts": [
{
"text": "best ai visibility tools for agencies",
"topic": "tools",
"tags": [
"agency"
],
"category": "compare",
"critical": false
}
],
"dry_run": true
}/v1/panels/{panel_id}/promptsAtiva ou desativa até 150 prompts
{
"ids": [
"promptid0000"
],
"active": false,
"dry_run": true
}/v1/panels/{panel_id}/competitorsAdiciona um concorrente
{
"name": "Example Ltd",
"domain": "example.com",
"aliases": [
"Example"
],
"dry_run": true
}/v1/panels/{panel_id}/actionsAdiciona uma ação a partir de uma recomendação
{
"key": "invisible_prompts",
"status": "todo",
"due": "2026-12-01",
"remind": true
}/v1/panels/{panel_id}/prompts/{prompt_id}Atualiza um prompt. O texto não muda
{
"active": true,
"topic": "tools",
"tags": [
"agency"
],
"category": "buy",
"critical": true
}/v1/panels/{panel_id}/prompts/{prompt_id}Desativa um prompt. O histórico mantém-se
/v1/panels/{panel_id}/competitors/{competitor_id}Remove um concorrente. Exige confirm true
{
"confirm": true
}/v1/panels/{panel_id}/aliasesSubstitui os nomes adicionais da marca, no máximo 10
{
"aliases": [
"Former Name",
"second-domain.com"
]
}/v1/panels/{panel_id}/actions/{action_id}/doneMarca uma ação como concluída
/v1/panels/{panel_id}/actions/{action_id}/undoRemove uma ação
/v1/panels/{panel_id}/opportunities/markMarca uma oportunidade
{
"url": "https://forum.example/thread/1",
"state": "added"
}/v1/panels/{panel_id}/setupEdita um rascunho
{
"description": "What the business does.",
"services": [
"Service"
],
"sector": "Software",
"competitors": [
{
"name": "Rival One",
"aliases": [
"Rival"
]
}
],
"aliases": [
"Former Name"
]
}/v1/panels/{panel_id}/sharesCria uma ligação protegida
{
"label": "Agency",
"password": "at-least-8-chars",
"sections": [
"kpi",
"rivals"
]
}/v1/panels/{panel_id}/setup/topicsAdiciona um tópico e gera prompts candidatos
{
"topic": "Pricing"
}/v1/panels/{panel_id}/setup/approveAtiva o painel e inicia a primeira medição. Exige confirm true
{
"prompt_ids": [
"promptid0000"
],
"critical_ids": [],
"extra": [
"another prompt"
],
"engines": [
"chatgpt"
],
"confirm": true
}/v1/panels/{panel_id}/pausePausa as medições
/v1/panels/{panel_id}/resumeRetoma as medições
/v1/panels/{panel_id}/actions/{action_id}Altera a data
{
"due": "2026-12-15"
}/v1/panels/{panel_id}/market/hideOculta ou mostra um nome no mapa
{
"name": "Example",
"undo": false
}/v1/panels/{panel_id}/brand/confirmConfirma um item da verificação
{
"id": "0000000000000000000000000000000000000000"
}/v1/panels/{panel_id}/shares/{share_id}Revoga uma ligação. Exige confirm true
{
"confirm": true
}/v1/panels/{panel_id}/integrations/{service}/syncAtualiza dados gsc ou ga4
/v1/panels/{panel_id}/integrations/{service}/disconnectDesliga gsc ou ga4. Exige confirm true
{
"confirm": true
}