Perguntas frequentes e erros comuns ao usar a API

Tira dúvidas sobre o uso da API com ferramentas externas

Usas ferramentas como n8n, Make, Zapier ou Postman para agendar publicações ou automatizar tarefas com a API da Metricool? Aqui respondemos às perguntas mais frequentes e aos erros mais comuns.

❓ Perguntas frequentes

Onde devo colocar o token de autenticação?

Em todos os casos, o token da tua conta Metricool deve ser enviado no cabeçalho:

X-Mc-Auth: O TEU API TOKEN

Também é obrigatório incluir:
Content-Type: application/json

⚠️ Verifica que o pedido inclui sempre os parâmetros blogId e userId.

📋 Tabela resumo por ferramenta

Como posso obter o meu blogId?

Tens duas formas:

1. A partir da URL da Metricool
   Quando acedes a uma marca na tua conta, vais ver um URL como este.
   Deves copiar o número que aparece depois de blogId, que identifica a marca.

   • (O número depois de userId identifica a tua conta.)*

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

1. Via API:
   Faz um pedido a este endpoint. Ele devolve uma lista com todas as marcas que geres ou que foram partilhadas contigo, cada uma com o respetivo blogId:

https://app.metricool.com/api/admin/simpleProfiles?userId=O_TEU_USER_ID

Que formato deve ter a data de publicação (publicationDate)?

Deve seguir o formato ISO 8601, incluindo o fuso horário. Exemplo:

"publicationDate": {
"dateTime": "2025-07-23T10:00:00",
"timezone": "Europe/Lisbon"
}

Como posso encontrar o endpoint da API da Metricool de que preciso?

Alguns endpoints da API do Metricool não estão listados explicitamente na documentação em PDF, mas você pode obtê-los facilmente por conta própria inspecionando o navegador.

📝 O vídeo está disponível em espanhol e inglês. Se você estiver visualizando o artigo em outro idioma, será necessário mudar para uma dessas versões para assisti-lo.

Posso carregar imagens ou vídeos através da API?

Sim. Primeiro, tens de carregar o ficheiro na Metricool com o endpoint correspondente, obter o mediaId e referenciá-lo no teu post.
Certifica-te de que o link é público e não expira.
Recomendamos também fazer um pedido ao endpoint normalize, que garante que o ficheiro seja armazenado nos servidores da Metricool.

Posso usar a API com outras ferramentas?

Sim. Qualquer ferramenta que permita fazer pedidos HTTP com cabeçalhos personalizados pode ser integrada com a API da Metricool.

⚠️ Erros comuns (e como resolvê-los)

Acesso negado (ou semelhante)

Este erro indica que o token não foi enviado corretamente ou não tem acesso à marca (blog).

✅ Solução:

• Verifica se estás a usar o token correto da tua conta Metricool.

• Confirma que está colocado como indicado na tabela.

• Garante que o blogId e userId pertencem à tua conta.
  🔎 Exemplo n8n:

A publicação é agendada mas não tem imagem ou vídeo

Isto acontece quando os ficheiros multimédia não foram tratados corretamente antes de enviar o pedido.

✅ Solução:

1. Verifica que o link é público e não expira.

2. Confirma que o mediaId está incluído no corpo do post.

3. Antes de chamares https://app.metricool.com/api/v2/scheduler/posts, normaliza o URL do ficheiro:

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

1. Depois, usa o mediaId devolvido no teu post:

"media": {
"mediaId": "ID_DO_MEDIA"
}