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

2. 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 não estão listados de forma explícita no PDF da documentação, mas podes encontrá-los facilmente tu mesmo com os seguintes passos.

Passo a passo para encontrar um endpoint

1. Acede à secção da Metricool onde vês a informação que queres obter via API (por exemplo: análises do YouTube, publicações do Instagram, etc.).
2. Abre as ferramentas de desenvolvimento do navegador:

• Na maioria dos navegadores: botão direito → “Inspecionar” → separador Network.
• Recarrega a página, se necessário.

3. Filtra por tipo fetch/XHR para ver os pedidos que a Metricool faz ao backend.
4. Procura o endpoint que contenha os dados apresentados no ecrã.

Por exemplo: na secção de análises do YouTube, vais ver algo como youtube/videosStats.

5. Copia esse URL e adapta-o aos teus pedidos de API.

Este processo está explicado em mais detalhe a partir da página 8 do PDF da documentação da API. Podes fazer o download aqui: 👉 Documentação API Metricool (PDF)

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>

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

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

Actualizado em: 06/08/2025