Pinterest BulkPublish

API Pinterest

Publiez, programmez et gérez Pinterest depuis votre propre code. Une seule API REST et une seule clé couvrent Pinterest et tous les autres réseaux que vous connectez : vous écrivez l’intégration une seule fois.

Obtenir une clé d’API gratuite Lire la référence de l’API

Ce que couvre l’API Pinterest

Tout ce qui suit fait partie de l’API publiée et fonctionne dès aujourd’hui avec Pinterest.

Fonction	Endpoint
Créer, programmer, modifier et publier des publications	`POST /api/posts`
Importer des images et des vidéos	`POST /api/media`
Trouver le prochain créneau libre de votre file	`GET /api/posts/queue-slot`
Créer des programmations récurrentes	`POST /api/schedules`
Publier les nouveaux éléments d’un flux RSS	`POST /api/rss-feeds`
Consulter les tableaux Pinterest d’un canal	`GET /api/channels/{id}/options`
Lire les statistiques de chaque publication	`GET /api/posts/{id}/metrics`
Vérifier que la connexion fonctionne bien	`GET /api/channels/{id}/health`
Consulter l’utilisation de votre offre	`GET /api/quotas/usage`

Types de publication pour Pinterest

Choisissez le type avec postTypeOverrides. Un type que Pinterest ne propose pas est refusé avant toute mise en file.

Type de publication	Médias
`pin` Pin	Obligatoire : 1 image
`video_pin` Video Pin	Obligatoire : 1 vidéo
`carousel` Carousel	Obligatoire : de 2 à 5 images

Programmer une publication Pinterest avec curl

Trois requêtes : trouver votre canal, importer le fichier si la publication en a un, puis créer la publication. Remplacez la clé par une clé de Paramètres, puis Clés d’API, et 12 par l’identifiant de votre propre canal.

1. Listez vos canaux et notez l’identifiant de votre compte Pinterest.

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. Importez le fichier. La réponse donne l’identifiant du média, utilisé comme mediaFiles ci-dessous.

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@photo.jpg"

3. Créez la publication.

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"
    }
  }
}'

La réponse est la publication créée, avec son identifiant et son statut. Récupérez-la plus tard avec GET /api/posts/{id} pour voir comment cela s’est passé.

Options Pinterest

Envoyez-les dans platformSpecific, sous la clé de Pinterest.

Pour Pinterest, les options sont indexées par l’identifiant de votre canal, par exemple « 12 », ou envoyées à plat pour s’appliquer à tous les canaux Pinterest de la publication.

Option	Ce qu’elle fait	Accepte
`title`	Titre	du texte
`description`	Description	du texte
`link`	Lien de destination	du texte
`dominantColor`	Couleur d’arrière-plan de l’épingle	du texte
`coverImageUrl`	Image de couverture des épingles vidéo	du texte
`boardId`	Tableau où épingler	du texte

Pour trouver les tableaux valides d’un canal, appelez GET /api/channels/{id}/options.

Statistiques Pinterest via l’API

Ces métriques sont renvoyées pour chaque publication Pinterest sur GET /api/posts/{id}/metrics, avec des instantanés au fil du temps.

Impressions
Clics
Enregistrements
Vues vidéo
J’aime
Commentaires
Taux d’engagement

Commentaires et messages

BulkPublish ne lit ni les commentaires ni les messages sur Pinterest : il n’y a donc rien à lister ni à traiter ici.

Accès API sur toutes les offres

Chaque offre inclut des clés d’API, l’offre Free comprise. Voici ce que permet chacune.

Offre	Clés d’API	Requêtes par jour
Free	1	30
Pro	5	5 000
Business	10	50 000

Construire directement sur Pinterest, ou passer par BulkPublish

Passer en direct est un choix raisonnable, surtout si vous avez besoin de quelque chose que BulkPublish n’expose pas. Voici ce que Pinterest API v5 exige de vous, vérifié dans sa documentation en octobre 2026.

Vous devez enregistrer une application développeur auprès de Pinterest avant de pouvoir publier.
Les jetons d’accès durent environ 30 jours : il vous faut votre propre moyen de les renouveler ou de reconnecter le compte avant leur expiration.

BulkPublish garde la connexion pour vous : il renouvelle les jetons, vérifie chaque publication selon les règles de Pinterest avant la mise en file et signale sur la publication une destination en échec, si bien que votre code n’envoie qu’une requête.

Lire la documentation officielle

Vous préférez demander à un assistant ?

Claude, ChatGPT et Cursor peuvent faire la même chose via le serveur MCP Pinterest, avec des demandes au lieu de code.

Voir le serveur MCP Pinterest

Vous préférez un calendrier au code ?

Le même compte Pinterest peut être programmé depuis l’app, avec un calendrier de contenu et l’import en masse.

Voir le planificateur Pinterest

Questions fréquentes

Questions courantes sur l’API Pinterest.

Existe-t-il une API Pinterest utilisable sans construire l’intégration moi-même ?

Oui. BulkPublish expose Pinterest via son API REST. Connectez votre compte Pinterest une fois, puis publiez, programmez et gérez-le avec une clé. La même clé fonctionne pour tous les autres réseaux que vous connectez.

Que puis-je publier sur Pinterest via l’API ?

Les types de publication sont Pin, Video Pin et Carousel. Chacun est vérifié selon les règles média de Pinterest avant toute mise en file : une requête que Pinterest refuserait échoue donc immédiatement, avec une erreur claire.

Puis-je programmer des publications Pinterest via l’API ?

Oui. Envoyez le statut "scheduled" avec une heure scheduledAt et un timezone, ou demandez d’abord le prochain créneau libre de votre file. Les programmations récurrentes et les flux RSS sont aussi disponibles.

Puis-je lire les statistiques Pinterest via l’API ?

Oui. Les métriques par publication incluent Impressions, Clics, Enregistrements, Vues vidéo, J’aime, Commentaires et Taux d’engagement, avec des instantanés au fil du temps.

Puis-je lire les commentaires ou messages Pinterest et y répondre via l’API ?

Non. BulkPublish ne lit ni les commentaires ni les messages sur Pinterest.

L’API Pinterest coûte-t-elle un supplément ?

Non. L’accès API est inclus dans toutes les offres. Free comprend 1 clé et 30 requêtes par jour, Pro 5 clés et 5 000 par jour, Business 10 clés et 50 000 par jour.

Me faut-il un compte développeur Pinterest ou une validation d’application ?

Pas pour utiliser BulkPublish. Vous connectez votre compte Pinterest sur la page Canaux et publiez avec une clé BulkPublish. Si vous construisez plutôt sur l’API propre de Pinterest, la section ci-dessus liste ce qu’elle exige de vous.

Un assistant IA peut-il le faire aussi ?

Oui. La page du serveur MCP Pinterest explique comment connecter Claude, ChatGPT ou Cursor et quoi demander.

La même clé et la même forme de requête fonctionnent pour 15 réseaux.