L’API Pinterest v5 crée des épingles pour vous, y compris des épingles vidéo, mais seulement après que votre application a passé une validation. En attendant, votre application reste en accès d’essai, où chaque épingle et chaque tableau qu’elle crée est une entité bac à sable visible uniquement par son créateur. Ce seul fait détermine si l’API vous est utile, il mérite donc d’ouvrir ce guide plutôt que d’être enterré dans une section sur les scopes.
Que peut réellement publier l’API Pinterest ?
Elle crée des épingles sur des tableaux appartenant au compte authentifié : épingles image et épingles vidéo, avec un titre, une description et un lien de destination. C’est une API de publication, pas de navigation, et elle est limitée aux comptes ayant autorisé votre application.
Les limites qui comptent pour votre évaluation :
| Contrainte | Ce que cela signifie pour vous |
|---|---|
| L’accès d’essai est le palier par défaut | Les épingles et tableaux créés par votre application sont des entités bac à sable, visibles uniquement par leur créateur |
| L’accès standard exige une validation | Vous soumettez un enregistrement vidéo de votre application utilisant l’API, avec le flux OAuth visible |
| Les épingles vidéo demandent une étape d’upload séparée | Les octets vidéo passent par un enregistrement et un upload de média avant l’appel de création d’épingle |
| Les limites de débit diffèrent par palier | L’essai est mesuré par jour et par application, le standard par minute et par utilisateur et par application |
Donc un outil interne que vous utilisez sur votre propre compte peut rester indéfiniment en accès d’essai. Un produit qui publie pour le compte de clients ne le peut pas, car les épingles d’essai ne deviennent jamais visibles.
Remarque : les chiffres ici ont été vérifiés auprès de developers.pinterest.com en septembre 2026. Les plateformes changent ces paramètres sans préavis.
Que demande la validation d’application Pinterest, et combien de temps prend-elle ?
Vous enregistrez une application, obtenez l’approbation pour l’accès d’essai, puis demandez la mise à niveau vers l’accès standard. La documentation de Pinterest indique que la mise à niveau exige que votre application ait déjà l’approbation d’essai, respecte les Developer Guidelines, et que vous fournissiez un enregistrement vidéo de votre application effectuant une action via l’API Pinterest, avec le flux d’authentification utilisateur visible dans l’enregistrement. Les captures d’écran d’appels en ligne de commande ou de Postman sont des formats acceptés.
Le motif de refus le plus courant que Pinterest cite est une démo qui ne montre pas le flux OAuth, ou qui ne montre pas une intégration Pinterest réelle dans l’application.
Sur la durée : Pinterest indique que les demandes de mise à niveau standard sont « examinées régulièrement » et que vous êtes notifié par e-mail lorsqu’une décision est prise. Elle suggère de prévoir quelques jours. Aucun délai précis n’est publié, donc considérez tout chiffre exact lu ailleurs comme une supposition. Planifiez votre date de lancement autour d’une inconnue, pas autour d’un SLA promis.
Le modèle d’authentification lui-même est un OAuth 2.0 classique : rediriger l’utilisateur vers Pinterest, échanger le code contre un jeton d’accès et un jeton de rafraîchissement, stocker les deux par compte, rafraîchir avant expiration. Rien d’exotique. La partie exotique, c’est le portail de validation qui se trouve devant.
Quelle est la séquence réelle pour créer une épingle ?
Pour une épingle image issue d’une URL publique, c’est un seul appel. Pour une épingle vidéo, ce sont quatre étapes, car les octets doivent être enregistrés, mis en ligne et traités avant qu’une épingle puisse les référencer.
- Enregistrer l’upload du média.
POST /v5/mediaavec le type de média. La réponse contient un identifiant de média, une URL d’upload et un jeu de paramètres de formulaire. - Mettre en ligne les octets. Envoyez un formulaire multipart en
POSTvers cette URL d’upload, en plaçant les paramètres retournés comme champs de formulaire d’abord, puis le fichier en dernier. C’est un envoi de formulaire pré-signé de type S3, pas un point de terminaison Pinterest, donc ses réponses d’erreur sont en XML plutôt qu’en JSON. - Sonder le statut du média. Relisez l’enregistrement du média jusqu’à ce que le traitement ait réussi. Un 2xx à l’upload ne signifie pas que la vidéo est utilisable.
- Créer l’épingle.
POST /v5/pinsen référençant le média traité, plus le tableau, le titre, la description et le lien.
# 1. register
curl -X POST https://api.pinterest.com/v5/media \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"media_type":"video"}'
# 2. upload the bytes to the returned upload_url,
# sending every returned upload parameter as a form field first
curl -X POST "$UPLOAD_URL" \
-F key="$KEY" -F policy="$POLICY" -F "x-amz-signature=$SIG" \
-F file=@clip.mp4
# 3. poll until the media reports a succeeded status
# 4. create the pin referencing that media idRemarque : nous n’avons pas pu vérifier les noms exacts des champs de requête et de réponse pour
POST /v5/mediaouPOST /v5/pinssur la référence officielle de l’API Pinterest : ces pages rendent leur contenu côté client et n’ont pas renvoyé de texte de documentation lors de la récupération. Lisez la référence API en direct sur developers.pinterest.com avant d’écrire du code dessus, et considérez les noms de champs ci-dessus comme la forme du flux plutôt que comme un schéma à copier.
L’étape que les gens sautent est la troisième. Une épingle vidéo nécessite aussi une image de couverture, un second élément à produire et valider. Nous n’avons pas pu confirmer l’exigence exacte de couverture sur une page de référence v5 accessible, donc vérifiez-la auprès de la documentation actuelle avant de construire autour. Si vous dimensionnez des images pour l’un ou l’autre type d’épingle, notre guide tailles des épingles Pinterest donne les dimensions actuelles.
Quelles sont les limites de débit de l’API Pinterest ?
Les limites publiées diffèrent nettement selon le palier, une raison de plus pour laquelle l’accès d’essai n’est pas un aperçu du comportement en production.
| Palier | Limite documentée |
|---|---|
| Essai | 1 000 requêtes par jour pour toutes les requêtes API, appliquées par application |
| Standard | 100 requêtes par seconde par utilisateur et par application, pour toutes les requêtes API |
Chaque catégorie de point de terminaison a ses propres limites plus étroites en plus de la limite universelle : lecture, écriture, analytics et conversions ont chacune leur propre budget, et la documentation de Pinterest elle-même précise que toutes les limites de débit sont sujettes à changement sans préavis. Vérifiez la catégorie attribuée à chaque point de terminaison que vous appelez plutôt que de supposer que le chiffre universel s’applique.
Remarque : les chiffres ici ont été vérifiés auprès de developers.pinterest.com en septembre 2026. Les plateformes changent ces paramètres sans préavis.
Ce qui vous coûtera vraiment trois semaines
Pas l’appel de création d’épingle. Ça, c’est l’affaire d’un après-midi. Les trois semaines se trouvent ici :
- La validation. Vous ne pouvez pas livrer aux clients en accès d’essai, et aucun délai n’est publié. Soumettez tôt, et soumettez un enregistrement qui montre clairement le flux OAuth, car c’est le motif d’échec cité.
- Le rafraîchissement des jetons. Les jetons de rafraîchissement expirent et les révocations se produisent silencieusement. Il vous faut un jeton de rafraîchissement stocké par compte connecté, une tâche qui renouvelle avant expiration, et un état « reconnecter ce compte » dans votre interface. Construire cela après la mort du premier jeton d’un client, c’est l’ordre le plus coûteux.
- Le transcodage média. Les épingles vidéo signifient accepter n’importe quel fichier mis en ligne par un utilisateur, normaliser le codec et le conteneur, générer une image de couverture, et stocker le résultat quelque part où l’étape d’upload peut le diffuser. C’est un pipeline média, pas une intégration API.
- La gestion des échecs asynchrones. Un 2xx de l’upload pré-signé signifie que les octets sont arrivés. Cela ne signifie pas que la vidéo a été traitée, ni qu’une épingle existe. Il vous faut un système de sondage de statut, une politique de nouvelle tentative qui distingue les échecs transitoires des échecs permanents, et un état de publication qui peut être
processingplutôt que seulement publié ou échoué. Nous avons écrit sur ce modèle d’état dans le guide de l’API de planification pour les réseaux sociaux.
Multipliez ces quatre points par chaque plateforme que vous ajoutez. C’est la vraie forme du chantier. Le comparatif construire ou acheter y met des chiffres.
En bref
- L’accès d’essai est le défaut et produit des épingles bac à sable visibles uniquement par leur créateur. L’accès standard exige une validation avec démo vidéo du flux OAuth. Aucun délai n’est publié.
- Les épingles image depuis une URL publique tiennent en un appel. Les épingles vidéo demandent enregistrement, upload, sondage, création, plus une image de couverture.
- L’essai est limité à 1 000 requêtes par jour et par application. Le standard, à 100 requêtes par seconde par utilisateur et par application, avec des limites par catégorie plus étroites en dessous.
- Le coût d’ingénierie tient dans la validation, le rafraîchissement des jetons, le transcodage et la gestion des échecs asynchrones, pas dans l’appel de publication.
Le faire une fois plutôt qu’une fois par plateforme
Si Pinterest est l’un des nombreux réseaux dont vous avez besoin, le travail par plateforme ci-dessus se répète sous des formes différentes à chaque fois : portails de validation différents, flux de média différents, modèles de quota différents. C’est ce que notre API existe pour absorber. BulkPublish publie sur 15 plateformes via un seul point de terminaison REST et un seul modèle de publication, avec l’OAuth, le rafraîchissement des jetons, la gestion des médias et le suivi de statut asynchrone de notre côté.
La documentation développeur et la page d’intégration de l’API REST couvrent les points de terminaison et le cycle de vie d’une publication. Si vous préférez programmer des épingles via une interface plutôt qu’écrire du code contre l’une ou l’autre API, comment programmer des épingles Pinterest couvre ce chemin, et le compteur de caractères Pinterest gratuit gardera vos titres et descriptions dans les limites.