Basisgids voor API-integratie

Bijgewerkt vorige week

De Metricool API koppelt je eigen tools en scripts aan Metricool, zodat je gegevens kunt exporteren en posts van buiten de app kunt maken, inplannen en beheren. In deze gids leer je hoe je toegang krijgt en je eerste API-call uitvoert.

Voordat je begint

De API is beschikbaar bij de abonnementen Advanced en Custom. De abonnementen Free en Starter bieden geen API-toegang.

Ga naar Accountinstellingen > API.
Kopieer je API-toegangstoken.
Open de officiële API-documentatie via het ℹ️-infopictogram naast het tokenveld, of rechtstreeks via https://app.metricool.com/resources/apidocs/index.html. Er is ook een downloadbare pdf-gids beschikbaar: API English PDF.

Elke call authenticeren

Voor alle endpoints is authenticatie met drie waarden vereist: je token in de header X-Mc-Auth, plus userId en blogId als requestparameters. Requests met een body gebruiken ook Content-Type: application/json.

X-Mc-Auth: YOUR_API_TOKEN
Content-Type: application/json

userId identificeert je Metricool-account en blogId identificeert het merk. Je kunt beide aflezen uit de URL in je browser wanneer je een merk opent in de app:

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

Als je elk merk wilt weergeven dat je beheert of dat met je is gedeeld, voer je een call uit naar https://app.metricool.com/api/admin/simpleProfiles?userId=YOUR_USER_ID. Elke vermelding bevat de bijbehorende blogId. Bekijk Zo vind je je Metricool-gebruikers-ID voor een uitgebreide uitleg over de account-ID.

Een post maken en inplannen

Stuur een POST-request naar het scheduler-endpoint met de publicatiedatum, de tekst van de post en ten minste één netwerk:

POST https://app.metricool.com/api/v2/scheduler/posts?blogId={blogId}&userId={userId}

De requestbody vereist:

publicationDate: de datum moet in de toekomst liggen en de ISO 8601-indeling met een tijdzone gebruiken, bijvoorbeeld Europe/Madrid.
text: de inhoud van de post.
providers: ten minste één netwerk, bijvoorbeeld { "network": "facebook" }.

Voorbeeld van een requestbody:

{
  "publicationDate": {
    "dateTime": "2025-07-23T10:00:00",
    "timezone": "Europe/Madrid"
  },
  "text": "Hello! This is a scheduled post test.",
  "providers": [
    { "network": "facebook" }
  ]
}

Optionele instellingen zijn onder meer draft (stel in op true om de post als concept op te slaan in plaats van deze in te plannen), autoPublish, firstCommentText en netwerkspecifieke blokken zoals facebookData, instagramData, twitterData, linkedinData, pinterestData, youtubeData, tiktokData, gmbData, threadsData en blueskyData voor opties per netwerk, zoals het Facebook-posttype of automatisch publiceren op Instagram. De volledige referentie van parameters staat in de .yaml- en .json-Swaggerbestanden waarnaar vanuit de API-documentatie wordt gelinkt.

Wat je met ingeplande posts kunt doen

De scheduler-endpoints ondersteunen de volgende acties. Alle paden zijn relatief ten opzichte van de basis-URL https://app.metricool.com/api.

Actie	Methode en pad
Een ingeplande post maken	`POST /v2/scheduler/posts`
Ingeplande posts tussen twee datums weergeven	`GET /v2/scheduler/posts`
Een ingeplande post ophalen op ID	`GET /v2/scheduler/posts/{id}`
Een ingeplande post bijwerken	`PUT /v2/scheduler/posts/{id}`
Geselecteerde velden bewerken en bijwerken	`PATCH /v2/scheduler/posts/{id}`
Een ingeplande post verwijderen	`DELETE /v2/scheduler/posts/{id}`
Meerdere posts van een merk in bulk ter controle verzenden	`PUT /v2/scheduler/posts`
Een ingeplande post goedkeuren of afwijzen	`PUT /v2/scheduler/posts/{id}/approvals`
De merkconfiguratie ophalen voor het ter controle verzenden van een post	`GET /v2/scheduler/posts/approvals-config`
De Instagram-posteigenschappen van een merk ophalen	`GET /v2/scheduler/posts/instagram-properties`

Media aan een ingeplande post toevoegen

Medialinks moeten openbaar zijn en mogen niet verlopen: privé- of tijdelijke URL's worden overgeslagen en de post wordt zonder media ingepland. Bereid de media voor voordat je het scheduler-endpoint aanroept om media toe te voegen:

Normaliseer de media-URL met een GET-request, zodat het bestand indien nodig op de servers van Metricool wordt gehost:
https://app.metricool.com/api/actions/normalize/image/url?url=<URL_OF_YOUR_MEDIA>
Verwijs naar de media in je post via de bijbehorende mediaId:
"media": { "mediaId": "ID_OF_MEDIA" }

Zonder de media-identificatie in het request wordt de post zonder media ingepland. Bekijk het volledige uitgewerkte voorbeeld in Veelgestelde vragen en fouten bij het gebruik van de API.

Beperkingen voor publiceren

Elk sociaal netwerk beperkt wat tools van derden via de eigen API kunnen publiceren. Daarom is niet elke plannerfunctie beschikbaar via de Metricool API. Bekijk API-beperkingen per sociaal netwerk voor de lijst per netwerk met niet-ondersteunde acties voor publiceren, Inbox en Rapportage.

De netwerkspecifieke velden in de requestbody verschillen ook per netwerk. Controleer de .yaml- en .json-Swaggerbestanden in de API-documentatie om te zien welke velden voor elk netwerk beschikbaar zijn voordat je het request opbouwt.

API-implementatie

Volg deze algemene stappen om gegevens uit Metricool te exporteren via onze API naar andere platforms, zoals Excel, Google Sheets, MySQL en andere:

Haal het toegangstoken op via Accountinstellingen > API, zoals hierboven beschreven.
Stel de HTTP-client in: gebruik een integratietool zoals Postman of een programmeertaal (bijvoorbeeld Python met requests) en configureer de header X-Mc-Auth met je token.
Stuur een GET-request naar het endpoint voor de gegevens die je wilt ophalen (posts, statistieken, Rapportage). Voor alle calls zijn userId en blogId vereist. Gebruik de browserinspecteur om de calls te bekijken die Metricool uitvoert en hun parameters te zien, zoals uitgelegd in Zo haal je een endpoint op in Metricool om API-calls uit te voeren.
Formatteer de gegevens: responses worden meestal aangeleverd in JSON. Koppel de velden daarom aan de structuur die je doelplatform verwacht.
Exporteer de gegevens naar het doelplatform.

Elk doelplatform heeft zijn eigen integratiemethode, maar de algemene workflow volgt dit schema.

Documentatie

Hier vind je links naar de documentatie voor API's van de meest gebruikte platforms voor gegevensbeheer:

Gebruik monitoren en je token vernieuwen

Accountinstellingen > API toont je huidige API-gebruik en de geschiedenis van gebruikte endpoints. Je kunt ook gebruiksstatistieken via de API ophalen met GET /v2/settings/users/{userId}/api-usage-stats. Hiervoor zijn de parameters from, to en aggregation nodig. Het endpoint retourneert de uitgevoerde calls per endpoint.

Als je je token moet vervangen, kun je dit vernieuwen via Accountinstellingen > API. Bij het vernieuwen wordt het vorige token direct ongeldig en werkt elke integratie die het gebruikt niet meer totdat je het token bijwerkt. Bekijk Je API-verbindingstoken vernieuwen.

Aanvullende bronnen

📹 Metricool API Tutorial: How to Get Started — EN · ES

Gerelateerde artikelen

Was dit nuttig?