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, plannen 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 Advanced- en Custom-abonnementen. De Free- en Starter-abonnementen bieden geen API-toegang.

Ga naar Accountinstellingen > API.
Kopieer je API-toegangstoken.
Open de officiële API-documentatie via het ℹ️-informatiepictogram 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 vereist met drie waarden: 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 in de app opent:

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

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

Een post maken en inplannen

Stuur een POST-request naar het scheduler-endpoint met de publicatiedatum, de posttekst en minstens éé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: minstens éé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 andere 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 voor parameters staat in de .yaml- en .json-Swagger-bestanden 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 op ID ophalen	`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 beoordeling versturen	`PUT /v2/scheduler/posts`
Een ingeplande post goedkeuren of afwijzen	`PUT /v2/scheduler/posts/{id}/approvals`
De merkconfiguratie ophalen voor het ter beoordeling versturen 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-ID in de request wordt de post zonder media ingepland. Bekijk het volledige uitgewerkte voorbeeld in Veelgestelde vragen en fouten bij het gebruik van de API.

Beperkingen bij publiceren

Elk sociaal netwerk beperkt wat tools van derden via de eigen API kunnen publiceren. Daarom zijn niet alle plannerfuncties beschikbaar via de Metricool API. Raadpleeg 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 voordat je de request opbouwt de .yaml- en .json-Swagger-bestanden in de API-documentatie voor de velden die voor elk netwerk beschikbaar zijn.

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, rapporten). Voor alle calls zijn userId en blogId vereist. Gebruik de browser-inspecteur om de calls en parameters te bekijken die Metricool gebruikt, zoals wordt getoond in Een endpoint in Metricool ophalen om API-calls te doen.
Formatteer de gegevens: responses zijn meestal JSON, dus koppel de velden 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 de API's van de meest gebruikte platforms voor gegevensbeheer:

Gebruik controleren en je token vernieuwen

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

Als je je token moet vervangen, kun je het opnieuw genereren via Accountinstellingen > API. Als je het token opnieuw genereert, wordt het vorige token onmiddellijk ongeldig en werkt elke integratie die het gebruikt niet meer totdat je het token bijwerkt. Bekijk Je API-verbindingstoken opnieuw genereren.

Gerelateerde artikelen

Was dit nuttig?