Pinterest
BulkPublish
Pinterest API
Publiceer, plan en beheer Pinterest vanuit je eigen code. Eén REST API en één sleutel dekken Pinterest en elk ander netwerk dat je koppelt, dus je schrijft de integratie maar één keer.
Wat de Pinterest API kan
Alles hieronder maakt deel uit van de gepubliceerde API en werkt vandaag met Pinterest.
| Mogelijkheid | Endpoint |
|---|---|
| Posts aanmaken, inplannen, bijwerken en publiceren | POST /api/posts |
| Afbeeldingen en video uploaden | POST /api/media |
| De eerstvolgende vrije plek in je wachtrij vinden | GET /api/posts/queue-slot |
| Terugkerende planningen aanmaken | POST /api/schedules |
| Nieuwe items uit een RSS-feed publiceren | POST /api/rss-feeds |
| Pinterest boards van een kanaal opvragen | GET /api/channels/{id}/options |
| Statistieken per post uitlezen | GET /api/posts/{id}/metrics |
| Controleren of de koppeling gezond is | GET /api/channels/{id}/health |
| Het verbruik van je abonnement controleren | GET /api/quotas/usage |
Posttypen die je op Pinterest kunt publiceren
Kies het type met postTypeOverrides. Een type dat Pinterest niet biedt, wordt geweigerd voordat er iets in de wachtrij komt.
| Berichttype | Media |
|---|---|
pin Pin | Verplicht: 1 afbeelding |
video_pin Video Pin | Verplicht: 1 video |
carousel Carousel | Verplicht: 2 tot 5 afbeeldingen |
Een Pinterest-post inplannen met curl
Drie verzoeken: zoek je kanaal, upload het bestand als de post er een heeft en maak dan de post aan. Vervang de sleutel door een sleutel uit Instellingen, dan API-sleutels, en 12 door je eigen kanaal-id.
1. Lijst je kanalen op en noteer de id van je Pinterest-account.
curl https://app.bulkpublish.com/api/channels \
-H "Authorization: Bearer bp_your_key_here" 2. Upload het bestand. Het antwoord geeft de media-id die hieronder als mediaFiles wordt gebruikt.
curl -X POST https://app.bulkpublish.com/api/media \
-H "Authorization: Bearer bp_your_key_here" \
-F "file=@photo.jpg" 3. Maak de post aan.
curl -X POST https://app.bulkpublish.com/api/posts \
-H "Authorization: Bearer bp_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"content": "A 20 minute pasta for busy evenings",
"channels": [{ "channelId": 12 }],
"status": "scheduled",
"scheduledAt": "2026-12-01T09:00:00Z",
"mediaFiles": [101],
"platformSpecific": {
"pinterest": {
"12": {
"boardId": "BOARD_ID"
},
"title": "Weeknight pasta",
"link": "https://example.com/pasta"
}
}
}' Het antwoord is de aangemaakte post, met id en status. Haal hem later op met GET /api/posts/{id} om te zien hoe het ging.
Pinterest-opties
Stuur deze mee in platformSpecific, onder de sleutel voor Pinterest.
Bij Pinterest staan de opties onder je kanaal-id, bijvoorbeeld "12", of je stuurt ze los mee om ze toe te passen op elk Pinterest-kanaal van de post.
| Optie | Wat het doet | Accepteert |
|---|---|---|
title | Titel | tekst |
description | Beschrijving | tekst |
link | Bestemmingslink | tekst |
dominantColor | Achtergrondkleur van de pin | tekst |
coverImageUrl | Omslagafbeelding voor videopins | tekst |
boardId | Board om op te pinnen | tekst |
Om de geldige boards van een kanaal te vinden, roep je GET /api/channels/{id}/options aan.
Pinterest-analytics via de API
Deze statistieken komen terug voor elke Pinterest-post op GET /api/posts/{id}/metrics, met momentopnames in de tijd.
- Weergaven
- Kliks
- Opgeslagen
- Videoweergaven
- Likes
- Reacties
- Interactiepercentage
Reacties en berichten
BulkPublish leest geen reacties of berichten op Pinterest, dus er is hier niets om op te lijsten of te beantwoorden.
API-toegang in elk abonnement
Elk abonnement bevat API-sleutels, ook het Free-abonnement. Dit is wat elk abonnement toestaat.
| Abonnement | API-sleutels | Verzoeken per dag |
|---|---|---|
| Free | 1 | 30 |
| Pro | 5 | 5.000 |
| Business | 10 | 50.000 |
Bouw direct op Pinterest, of gebruik BulkPublish
Direct bouwen is een redelijke keuze, zeker als je iets nodig hebt wat BulkPublish niet biedt. Dit vraagt Pinterest API v5 van je, gecontroleerd aan de hand van de documentatie van oktober 2026.
- Je registreert een developer-app bij Pinterest voordat je kunt publiceren.
- Toegangstokens gelden ongeveer 30 dagen, dus je hebt een eigen manier nodig om ze te vernieuwen of opnieuw te koppelen voordat ze verlopen.
BulkPublish houdt de koppeling voor je in stand: het vernieuwt tokens, controleert elke post op de regels van Pinterest voordat hij in de wachtrij komt en meldt een mislukte bestemming bij de post, zodat je code één verzoek doet.
Lees de officiële documentatie
Liever een assistent vragen?
Claude, ChatGPT en Cursor kunnen hetzelfde doen via de Pinterest MCP-server, met opdrachten in plaats van code.
Bekijk de Pinterest MCP-server
Liever een kalender dan code?
Hetzelfde Pinterest-account kun je ook vanuit de app inplannen, met een contentkalender en bulkupload.
Veelgestelde vragen
Veelgestelde vragen over de Pinterest API.
Is er een Pinterest API die ik kan gebruiken zonder de integratie zelf te bouwen?
Ja. BulkPublish biedt Pinterest aan via zijn REST API. Koppel je Pinterest-account één keer en publiceer, plan en beheer het daarna met een sleutel. Dezelfde sleutel werkt voor elk ander netwerk dat je koppelt.
Wat kan ik via de API op Pinterest publiceren?
De posttypen zijn Pin, Video Pin en Carousel. Elk type wordt gecontroleerd op de mediaregels van Pinterest voordat er iets in de wachtrij komt, dus een verzoek dat Pinterest zou weigeren, mislukt meteen met een duidelijke fout.
Kan ik Pinterest-posts via de API inplannen?
Ja. Stuur status "scheduled" met een scheduledAt-tijd en een timezone, of vraag eerst om de eerstvolgende vrije plek in je wachtrij. Terugkerende planningen en RSS-feeds zijn ook beschikbaar.
Kan ik Pinterest-analytics via de API uitlezen?
Ja. De statistieken per post omvatten Weergaven, Kliks, Opgeslagen, Videoweergaven, Likes, Reacties en Interactiepercentage, met momentopnames in de tijd.
Kan ik Pinterest-reacties of -berichten via de API lezen en beantwoorden?
Nee. BulkPublish leest geen reacties of berichten op Pinterest.
Kost de Pinterest API extra?
Nee. API-toegang zit in elk abonnement. Free bevat 1 sleutel en 30 verzoeken per dag, Pro 5 sleutels en 5.000 per dag, Business 10 sleutels en 50.000 per dag.
Heb ik een Pinterest-developeraccount of een app-review nodig?
Niet om BulkPublish te gebruiken. Je koppelt je Pinterest-account op de pagina Kanalen en publiceert met een BulkPublish-sleutel. Als je in plaats daarvan op de eigen API van Pinterest bouwt, staat in het gedeelte hierboven wat die van je vraagt.
Kan een AI-assistent dit ook doen?
Ja. De pagina over de Pinterest MCP-server laat zien hoe je Claude, ChatGPT of Cursor koppelt en wat je kunt vragen.
Andere netwerken
Dezelfde sleutel en dezelfde opbouw van verzoeken werken voor 15 netwerken.
Begin met publiceren op Pinterest vanuit code
Maak een gratis account, koppel Pinterest en genereer een sleutel. Geen creditcard nodig.