API REST

Os dados do seu painel em JSON, com um token por acesso. Todos os exemplos desta página correm tal como estão; troque só o token.

Começar por um token

1. No painel, em Definições → API, crie um token com um rótulo que reconheça («Looker», «Zapier»). O valor notado_… aparece uma vez: copie-o ali.
2. Envie-o em todos os pedidos: Authorization: Bearer notado_….

O tecto é de 60 pedidos por minuto, por token. Ao ultrapassar, a API responde 429 com um Retry-After em segundos. Um token perdido revoga-se no mesmo ecrã e cria-se outro; não há forma de o voltar a mostrar.

Quatro endpoints

Todos em https://notado.pt/api/v1, todos GET e só de leitura, confinados à organização do token.

GET /me: quem sou, e o que me resta

curl -s https://notado.pt/api/v1/me \
  -H "Authorization: Bearer notado_O_SEU_TOKEN"

Devolve a organização e o plano. No plano Parceiro, também o saldo de créditos do ciclo: dotação, usados, restantes. Sem tecto, allowance vem null (não um zero inventado). Nos outros planos credits vem null e work_done traz o que o ciclo mediu e corrigiu.

GET /visibility: a série semanal

curl -s "https://notado.pt/api/v1/visibility?weeks=12" \
  -H "Authorization: Bearer notado_O_SEU_TOKEN"

Uma linha por semana, com visibility e days_measured. A semana sem medições vem "visibility": null com "days_measured": 0: é «não sondado», não é 0. O argumento weeks vai de 1 a 52; por omissão, 12.

GET /prompts: perguntas e últimos estados

curl -s https://notado.pt/api/v1/prompts \
  -H "Authorization: Bearer notado_O_SEU_TOKEN"

Cada pergunta monitorizada com a última corrida por motor. Estados possíveis: present, absent, unattributable (sem forma de atribuir) e failed. Em failed, appeared vem null, porque falhado não é ausente. Motores nunca sondados ficam fora da lista.

GET /citations: citado vs. lido

curl -s "https://notado.pt/api/v1/citations?days=30" \
  -H "Authorization: Bearer notado_O_SEU_TOKEN"

Hosts citados com citations e citing_runs, hosts lidos-sem-citar com read_only_runs, e o read_signal com o denominador honesto: só corridas em que o motor revelou o que leu. Com "runs": 0, os zeros são «não sondado». O argumento days vai de 1 a 90; por omissão, 30.

Erros, todos em JSON

Para o mesmo token servir um agente de IA em vez de um script, veja Agentes de IA (MCP).