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
Ferramenta | Onde colocar o token ( | | Dicas úteis |
---|---|---|---|
n8n | Nas credenciais: Header Auth | ✅ | Usa “Generic Credential Type” + “Header Auth”. Podes reutilizá-lo entre nós. |
Make | No módulo HTTP: secção Headers | ✅ | Usa módulos personalizados ou o oficial da Metricool. |
Zapier | Em “Webhooks by Zapier”: secção Headers | ✅ | Adiciona o cabeçalho na configuração avançada do Webhook. |
Postman | No separador Headers do pedido | ✅ | Ideal para testar pedidos manualmente. |
Como posso obter o meu blogId
?
Tens duas formas:
- 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
- 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"
}
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
euserId
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:
- Verifica que o link é público e não expira.
- Confirma que o
mediaId
está incluído no corpo do post. - 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>
- Depois, usa o
mediaId
devolvido no teu post:
"media": {
"mediaId": "ID_DO_MEDIA"
}
Actualizado em: 30/07/2025
Obrigado!