Hulp bij het gebruik van de API met externe tools

Gebruik je tools zoals n8n, Make, Zapier of Postman om posts in te plannen of taken te automatiseren met de API van Metricool? Hier beantwoorden we de meest voorkomende vragen en typische fouten bij het instellen van de API.

❓ Veelgestelde vragen

Waar moet ik de authenticatietoken plaatsen?

In alle gevallen moet je de token van je Metricool-account in de header opnemen als:

X-Mc-Auth: YOUR API TOKEN

Je moet ook toevoegen:

Content-Type: application/json

⚠️ ​Zorg ervoor dat je request zowel de parameters blogId als userId bevat.

📋 Overzichtstabel per tool

Hoe krijg ik mijn blogId?

Je hebt twee opties:

1. Via de Metricool-URL

Wanneer je een merk opent in je account, zie je een URL zoals hieronder. Kopieer het nummer achter blogId, dat elk merk identificeert. (Het nummer achter userId identificeert je account.)

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

2. Via de API:

Je kunt een call maken naar deze endpoint. Deze geeft een lijst terug van alle merken die je beheert of die met je zijn gedeeld. Elke entry bevat de bijbehorende blogId:

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

Welk formaat moet publicationDate hebben?

Gebruik ISO 8601, inclusief tijdzone. Voorbeeld:

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

Hoe vind ik de API-endpoint die ik nodig heb in Metricool?

Sommige API-endpoints staan niet expliciet in de PDF-documentatie, maar je kunt ze eenvoudig zelf vinden door deze stappen te volgen.

Stap-voor-stap een endpoint vinden

1. Ga naar het Metricool-onderdeel waar je de informatie ziet die je via de API wilt ophalen (bijv. YouTube-analytics, Instagram-posts, enz.).
2. Open de developer tools van je browser:

• In de meeste browsers: rechtsklik → “Inspecteren” → tabblad Network.
• Laad de pagina opnieuw indien nodig.

3. Filter op type fetch/XHR om de calls te zien die Metricool naar de backend maakt.
4. Zoek de endpoint die de data bevat die je op het scherm ziet.

Bijvoorbeeld bij de YouTube-analytics

Kan ik afbeeldingen of video’s uploaden via de API?

Ja. Eerst moet je de media uploaden naar Metricool en een mediaId verkrijgen, daarna verwijs je ernaar in je post. Zorg ervoor dat je medialinks openbaar zijn en niet verlopen. We raden ook aan om een call te maken naar de normalize endpoint om ervoor te zorgen dat het bestand op de servers van Metricool wordt gehost.

Kan ik de API gebruiken met tools die hierboven niet genoemd worden?

Ja. Elke tool die HTTP-requests met custom headers ondersteunt, kan worden geïntegreerd met de API van Metricool.

⚠️ Veelvoorkomende fouten (en hoe je ze oplost)

Access denied (of vergelijkbaar)

Deze fout betekent dat de token niet correct wordt meegestuurd of geen toegang heeft tot het merk (blog) waarop je probeert te posten.

✅ Oplossing

• Controleer of je de juiste token uit je Metricool-account gebruikt.
• Zorg dat deze exact zo is geplaatst als in de tabel hierboven.
• Controleer of blogId en userId bij jouw account horen.

🔎 n8n-voorbeeld:

De post is ingepland maar zonder afbeelding of video

Dit betekent dat de media niet correct is verwerkt voordat de API-request werd verzonden.

✅ Oplossing

1. Zorg ervoor dat de medialink openbaar is en niet verloopt. Privé- of tijdelijke URL’s worden overgeslagen.
2. Controleer of je de mediaId in je post opneemt. Zo niet, dan wordt de post zonder media ingepland.
3. Voordat je https://app.metricool.com/api/v2/scheduler/posts aanroept, normaliseer je de media-URL met een GET-request naar:

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

Dit zorgt ervoor dat het bestand indien nodig op de servers van Metricool wordt gehost en geeft een geldige URL terug die kan worden omgezet naar een mediaId.

4. Gebruik de geretourneerde mediaId in je post zoals hieronder:

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

Bijgewerkt op: 14/02/2026