Ler dados
Cada chamada de painel exige o âmbito pt:read e um pacote ativo nesse painel. Se o pacote de um painel terminou, as chamadas devolvem 402 package_inactive e GET /v1/panels mostra package_active: false.
curl https://api.messgeo.com/v1/panels -H "Authorization: Bearer mgk_xxxxxxxxxx_your_secret"O que cada chamada devolve
| Chamada | Resultado |
|---|---|
/panels | Os seus painéis |
/panels/{panel_id} | Marca, mercado, motores, pacote |
/panels/{panel_id}/prompts | Prompts. Filtros: active, topic |
/panels/{panel_id}/stats | Visibilidade por medição, a mesma série do painel. Filtros: runs ou from e to, até 90 dias |
/panels/{panel_id}/prompts/{prompt_id}/results | Resultado por motor de um prompt |
/panels/{panel_id}/answers | Respostas de IA, uma por medição, prompt e motor |
/panels/{panel_id}/sources | Fontes citadas |
/panels/{panel_id}/competitors | Concorrentes e quota |
/panels/{panel_id}/opportunities | Oportunidades de prompts ativos e as suas marcas |
/panels/{panel_id}/alerts, /events, /actions | Alertas, eventos do gráfico, ações |
/panels/{panel_id}/market, /brand, /insights | Mapa do mercado, imagem da marca, recomendações |
/panels/{panel_id}/prompts/metrics, /engines, /sources/gaps | Métricas de prompts, detalhes dos motores, lacunas de fontes |
/panels/{panel_id}/gsc, /ga4, /integrations, /shares | Search Console, tráfego de IA, ligações, partilhas |
/panels/{panel_id}/export?tab=overview | O mesmo CSV do painel, uma vez por minuto por chave |
Paginação
Listas longas usam limit e cursor. Envie o next_cursor da resposta como cursor até ser null.