Limites e erros

LimitesCopiar link da seção

Chamadas por minuto120 por chave

Folga de sobra pra um assistente encadeando várias consultas numa resposta. Ao passar do limite, a chave espera um minuto antes de voltar.

Janela de datas366 dias

start_date e end_date podem cobrir no máximo 366 dias. Não existe o atalho "todo o período".

Listas nos parâmetros100 itens

Parâmetros que recebem lista, como exclude_terms, aceitam até 100 itens.

Tamanho da requisição256 KB

Limite do corpo de cada chamada.

Erros de conexãoCopiar link da seção

Estes voltam como status HTTP, antes de qualquer tool rodar.

401invalid_token

Chave ausente, errada ou revogada. Confira o cabeçalho Authorization: Bearer SUA_CHAVE ou crie outra chave.

429muitas chamadas

Passou de 120 chamadas no minuto. O cabeçalho Retry-After diz quantos segundos esperar.

413requisição grande demais

O corpo passou de 256 KB.

405método não permitido

O servidor só aceita POST. Não há stream nem sessão pra abrir com GET.

Erros das toolsCopiar link da seção

Quando a conexão está certa mas a consulta não, a resposta vem normal, com isError: true e uma mensagem em português. O assistente costuma ler a mensagem e tentar de novo com os parâmetros corrigidos.

Argumento inválido

Um parâmetro com tipo errado, valor fora da lista, abaixo do mínimo ou acima do máximo. A mensagem diz qual, por exemplo period: valor inválido. Use um de: today, 7d, ....

Obrigatório

Faltou um parâmetro obrigatório, normalmente o brand_id.

Operação não permitida

O brand_id é de uma marca que a sua chave não enxerga.

Nenhuma marca liberada

A sua conta não tem nenhuma marca em empresa com o MCP ativo.

Erro interno

Falha do nosso lado. Por segurança, o detalhe não é exposto. Se repetir, fale com o suporte dizendo a tool e o horário.