MessGEODocs
Obter chave de API

Referência da API

Endereço base https://api.messgeo.com. Transfira o ficheiro OpenAPI.

Conta

GET/v1/me

Conta, pacote, âmbitos da chave e limites

account:read
GET/v1/me/credits

Saldo de créditos

account:read
GET/v1/me/usage

Utilização diária da conta

account:read
PATCH/v1/me/alert-prefs

Atualiza as preferências de email do Monitorização de Prompts

account:write
{
    "digest": false,
    "dry_run": false
}
GET/v1/me/packages

Pacotes, painel e site de cada um, lugares livres

account:read

Ferramentas

GET/v1/tools

Lista ferramentas com o custo em créditos

account:read
POST/v1/tools/{slug}/runs

Executa uma ferramenta. Exige o cabeçalho Idempotency-Key, gasta créditos

tools:run
{
    "url": "https://example.com/",
    "dry_run": false
}
GET/v1/runs

Lista execuções

tools:read

Consulta: tool status since until target limit cursor

GET/v1/runs/{run_id}

Devolve uma execução

tools:read

Relatórios premium

GET/v1/orders

Lista encomendas de relatórios premium

tools:orders
GET/v1/orders/{order_id}

Devolve uma encomenda

tools:orders
GET/v1/orders/{order_id}/report

Relatório entregue em HTML

tools:orders

Monitorização de Prompts: leitura

GET/v1/panels

Lista painéis

pt:read
GET/v1/panels/{panel_id}

Devolve um painel

pt:read
GET/v1/panels/{panel_id}/prompts

Lista prompts

pt:read

Consulta: active topic

GET/v1/panels/{panel_id}/prompts/{prompt_id}/results

Resultados por motor de um prompt

pt:read

Consulta: runs from to

GET/v1/panels/{panel_id}/stats

Visibilidade por medição

pt:read

Consulta: runs from to

GET/v1/panels/{panel_id}/answers

Respostas de IA. O Starter recebe excertos em lista e texto completo com filtro de prompt

pt:read

Consulta: prompt engine limit cursor

GET/v1/panels/{panel_id}/sources

Fontes citadas

pt:read
GET/v1/panels/{panel_id}/competitors

Concorrentes

pt:read
GET/v1/panels/{panel_id}/opportunities

Oportunidades de fontes

pt:read
GET/v1/panels/{panel_id}/alerts

Alertas

pt:read
GET/v1/panels/{panel_id}/events

Eventos do painel

pt:read
GET/v1/panels/{panel_id}/actions

Ações

pt:read
GET/v1/panels/{panel_id}/export

Exportação CSV, uma vez por minuto por chave

pt:read

Consulta: tab format

GET/v1/panels/{panel_id}/setup

Estado de configuração de um rascunho com prompts candidatos

pt:read
GET/v1/panels/{panel_id}/prompts/metrics

Posição, primeiro lugar e sentimento por prompt

pt:read
GET/v1/panels/{panel_id}/market

Mapa do mercado

pt:read
GET/v1/panels/{panel_id}/brand

Imagem da marca e verificação do site

pt:read
GET/v1/panels/{panel_id}/insights

Recomendações e prompts em foco

pt:read
GET/v1/panels/{panel_id}/engines

Taxas de funcionalidades por motor

pt:read
GET/v1/panels/{panel_id}/sources/gaps

Fontes que citam rivais mas não a sua marca

pt:read
GET/v1/panels/{panel_id}/gsc

Consultas do Search Console

pt:read

Consulta: sort

GET/v1/panels/{panel_id}/ga4

Visitas de assistentes de IA

pt:read
GET/v1/panels/{panel_id}/integrations

Estado das integrações e endereço de ligação

pt:read
GET/v1/panels/{panel_id}/shares

Ligações de partilha

pt:read

Monitorização de Prompts: escrita

POST/v1/panels

Cria um painel num pacote Pro livre e devolve um rascunho

pt:writePro
{
    "brand": "Acme Ltd",
    "website": "https://example.com/",
    "competitors": [
        "Rival One"
    ],
    "country": "pt",
    "language": "en",
    "dry_run": true
}
PATCH/v1/panels/{panel_id}

Altera país, idioma e motores. Remover um motor apaga os dados e exige confirm true

pt:writePro
{
    "country": "tr",
    "language": "tr",
    "engines": [
        "chatgpt",
        "gemini"
    ],
    "confirm": false,
    "dry_run": true
}
DELETE/v1/panels/{panel_id}

Apaga um painel e os dados. Exige confirm true

pt:writePro
{
    "confirm": true,
    "dry_run": true
}
POST/v1/panels/{panel_id}/prompts

Adiciona prompts, no máximo 20 por chamada

pt:writePro
{
    "prompts": [
        {
            "text": "best ai visibility tools for agencies",
            "topic": "tools",
            "tags": [
                "agency"
            ],
            "category": "compare",
            "critical": false
        }
    ],
    "dry_run": true
}
PATCH/v1/panels/{panel_id}/prompts

Ativa ou desativa até 150 prompts

pt:writePro
{
    "ids": [
        "promptid0000"
    ],
    "active": false,
    "dry_run": true
}
POST/v1/panels/{panel_id}/competitors

Adiciona um concorrente

pt:writePro
{
    "name": "Example Ltd",
    "domain": "example.com",
    "aliases": [
        "Example"
    ],
    "dry_run": true
}
POST/v1/panels/{panel_id}/actions

Adiciona uma ação a partir de uma recomendação

pt:writePro
{
    "key": "invisible_prompts",
    "status": "todo",
    "due": "2026-12-01",
    "remind": true
}
PATCH/v1/panels/{panel_id}/prompts/{prompt_id}

Atualiza um prompt. O texto não muda

pt:writePro
{
    "active": true,
    "topic": "tools",
    "tags": [
        "agency"
    ],
    "category": "buy",
    "critical": true
}
DELETE/v1/panels/{panel_id}/prompts/{prompt_id}

Desativa um prompt. O histórico mantém-se

pt:writePro
DELETE/v1/panels/{panel_id}/competitors/{competitor_id}

Remove um concorrente. Exige confirm true

pt:writePro
{
    "confirm": true
}
PUT/v1/panels/{panel_id}/aliases

Substitui os nomes adicionais da marca, no máximo 10

pt:writePro
{
    "aliases": [
        "Former Name",
        "second-domain.com"
    ]
}
POST/v1/panels/{panel_id}/actions/{action_id}/done

Marca uma ação como concluída

pt:writePro
POST/v1/panels/{panel_id}/actions/{action_id}/undo

Remove uma ação

pt:writePro
POST/v1/panels/{panel_id}/opportunities/mark

Marca uma oportunidade

pt:writePro
{
    "url": "https://forum.example/thread/1",
    "state": "added"
}
PATCH/v1/panels/{panel_id}/setup

Edita um rascunho

pt:writePro
{
    "description": "What the business does.",
    "services": [
        "Service"
    ],
    "sector": "Software",
    "competitors": [
        {
            "name": "Rival One",
            "aliases": [
                "Rival"
            ]
        }
    ],
    "aliases": [
        "Former Name"
    ]
}
POST/v1/panels/{panel_id}/shares

Cria uma ligação protegida

pt:writePro
{
    "label": "Agency",
    "password": "at-least-8-chars",
    "sections": [
        "kpi",
        "rivals"
    ]
}
POST/v1/panels/{panel_id}/setup/topics

Adiciona um tópico e gera prompts candidatos

pt:writePro
{
    "topic": "Pricing"
}
POST/v1/panels/{panel_id}/setup/approve

Ativa o painel e inicia a primeira medição. Exige confirm true

pt:writePro
{
    "prompt_ids": [
        "promptid0000"
    ],
    "critical_ids": [],
    "extra": [
        "another prompt"
    ],
    "engines": [
        "chatgpt"
    ],
    "confirm": true
}
POST/v1/panels/{panel_id}/pause

Pausa as medições

pt:writePro
POST/v1/panels/{panel_id}/resume

Retoma as medições

pt:writePro
PATCH/v1/panels/{panel_id}/actions/{action_id}

Altera a data

pt:writePro
{
    "due": "2026-12-15"
}
POST/v1/panels/{panel_id}/market/hide

Oculta ou mostra um nome no mapa

pt:writePro
{
    "name": "Example",
    "undo": false
}
POST/v1/panels/{panel_id}/brand/confirm

Confirma um item da verificação

pt:writePro
{
    "id": "0000000000000000000000000000000000000000"
}
DELETE/v1/panels/{panel_id}/shares/{share_id}

Revoga uma ligação. Exige confirm true

pt:writePro
{
    "confirm": true
}
POST/v1/panels/{panel_id}/integrations/{service}/sync

Atualiza dados gsc ou ga4

pt:writePro
POST/v1/panels/{panel_id}/integrations/{service}/disconnect

Desliga gsc ou ga4. Exige confirm true

pt:writePro
{
    "confirm": true
}