Integrações através da API do Metricool

Perguntas frequentes e erros comuns ao usar a API

Atualizado mês passado

Use este guia para dúvidas comuns de configuração da API do Metricool e erros ao trabalhar com ferramentas como n8n, Make, Zapier ou Postman.

Perguntas frequentes

Estas respostas cobrem autenticação, IDs, datas, endpoints, mídia e ferramentas que não estão listadas na tabela.

Onde devo colocar o token de autenticação?

Inclua o token da sua conta Metricool no cabeçalho da solicitação assim:

X-Mc-Auth: YOUR API TOKEN

Inclua também:

Content-Type: application/json

Sua solicitação deve incluir os parâmetros blogId e userId.

Tabela-resumo das ferramentas

Ferramenta

Onde colocar o token (X-Mc-Auth)

Precisa de Content-Type?

Dicas úteis

n8n

Em credenciais: Header Auth

✅ application/json

Use “Generic Credential Type” + “Header Auth”. Você pode reutilizar entre os nós.

Make

No módulo HTTP: seção Headers

✅ application/json

Use um módulo HTTP personalizado ou o oficial da Metricool.

Zapier

Em “Webhooks by Zapier”: seção Headers

✅ application/json

Adicione o cabeçalho na configuração avançada do Webhook.

Postman

Na aba Headers da solicitação

✅ application/json

Perfeito para testes manuais.

Como consigo meu blogId?

Você tem duas opções:

  1. Pela URL do Metricool
    Quando você acessa uma marca na sua conta, vai ver uma URL como esta. Copie o número depois de blogId; ele identifica cada marca. O número depois de userId identifica sua conta. Para ver um passo a passo detalhado do ID da conta, consulte Como encontrar seu ID de usuário do Metricool.

https://app.metricool.com/evolution/web?blogId=00000&userId=0000000

  1. Via API
    Chame este endpoint. Ele retorna uma lista de todas as marcas que você gerencia ou que foram compartilhadas com você. Cada entrada inclui seu blogId correspondente:

https://app.metricool.com/api/admin/simpleProfiles?userId=YOUR_USER_ID
Qual formato a publicationDate deve usar?

Use ISO 8601, incluindo fuso horário. Exemplo:

"publicationDate": {
"dateTime": "2025-07-23T10:00:00",
"timezone": "Europe/Madrid"
}
Como posso encontrar o endpoint da API de que preciso no Metricool?

Alguns endpoints da API do Metricool não estão listados na documentação em PDF. Você pode obtê-los inspecionando o navegador.

Siga o guia completo em Como obter um endpoint passo a passo. Esse artigo inclui um tutorial em vídeo.

Posso enviar imagens ou vídeos pela API?

Sim. Primeiro faça o upload da mídia para o Metricool e obtenha um mediaId, depois faça a referência a ele no seu post. Os links da mídia precisam ser públicos e não podem expirar. Chame o endpoint normalize para que o arquivo seja hospedado nos servidores do Metricool.

Posso usar a API com ferramentas não listadas acima?

Sim. Qualquer ferramenta que permita solicitações HTTP com cabeçalhos personalizados pode ser integrada à API do Metricool.

Erros comuns e como corrigi-los

Use estas correções quando uma solicitação for rejeitada ou quando um post for agendado sem mídia.

Acesso negado (ou مشابه)

Esse erro significa que o token não está sendo enviado corretamente ou não tem acesso à marca (blog) em que você está tentando publicar.

✅ Correção

  • Confirme duas vezes que você está usando o token correto da sua conta Metricool.

  • Certifique-se de que ele esteja colocado exatamente como mostrado na tabela acima.

  • Confirme se blogId e userId pertencem à sua conta.

Exemplo no n8n:

O post está agendado, mas sem imagem ou vídeo

Isso significa que a mídia não foi tratada corretamente antes da solicitação à API.

✅ Correção

  1. Certifique-se de que o link da mídia seja público e não expire. URLs privadas ou temporárias são ignoradas.

  2. Inclua o mediaId no seu post. Sem ele, o post é agendado sem mídia.

  3. Antes de chamar https://app.metricool.com/api/v2/scheduler/posts, normalize a URL da mídia com uma solicitação GET para:

https://app.metricool.com/api/actions/normalize/image/url?url=<URL_OF_YOUR_MEDIA>

Isso hospeda o arquivo nos servidores do Metricool quando necessário e retorna uma URL válida que você pode transformar em um mediaId.

  1. Use o mediaId retornado no seu post:

"media": {
"mediaId": "ID_OF_MEDIA"
}

Isso foi útil?
Isso foi útil?