PinterestTableaux PinterestSujets PinterestGuide API

API Pinterest Boards : lister les tableaux, collecter leurs épingles et mesurer les sujets

Trois nouveaux endpoints SocQ Pinterest : les tableaux d’un profil avec leurs compteurs, les épingles enregistrées sur un tableau, et les recherches mensuelles d’un sujet avec ses sujets plus précis. Requêtes, champs et prix par résultat.

SocQMis à jour le 19 novembre 20267 min de lecture

Les premiers endpoints Pinterest de SocQ lisent les profils, les épingles individuelles, les épingles d’un utilisateur et les résultats de recherche. Le 2026-11-17, trois autres ont été mis en ligne, et ils travaillent à un autre niveau : les tableaux et les sujets. Les tableaux montrent comment une marque ou un créateur organise ses idées ; les sujets montrent combien de personnes recherchent une idée et quelles idées plus précises s’y rattachent.

Ce guide explique ce que renvoie chaque nouvel endpoint, la requête, le prix et la façon dont les trois s’articulent. Si vous comparez plus largement les fournisseurs de données Pinterest, consultez les 7 meilleures API de scraping Pinterest.

Réponse rapide : envoyez des URL de profils, de tableaux ou de pages d’idées Pinterest dans urls à POST /v1/pinterest/user-boards, /board ou /topic avec Authorization: Bearer $SOCQ_API_KEY. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez data.results.items. Les trois coûtent 0,5 crédit par résultat ($0,0025 à $0,005 le crédit), sans frais de base.

Les trois nouveaux endpoints Pinterest

EndpointCe qu’il renvoieEntréePrix
User BoardsLes tableaux publics d’un profil avec nom, description, couverture, propriétaire, date de création et nombre d’épingles, d’abonnés, de sections et de collaborateursURL de profils0,5 crédit ($0,0025) par tableau
Board PinsLes épingles d’un tableau, dans l’ordre du tableau, avec description, compte qui l’a enregistrée, image en taille réelle et lien de l’épingleURL de tableaux0,5 crédit ($0,0025) par épingle
TopicLe nombre de recherches mensuelles d’un sujet et les sujets plus précis que suggère PinterestURL de pages d’idées0,5 crédit ($0,0025) par sujet

Pinterest User Boards : auditer un profil

La Pinterest User Boards API liste tous les tableaux publics d’un profil Pinterest. Chaque tableau est fourni avec son nom, sa description, son image de couverture, son propriétaire, sa date de création et les compteurs d’épingles, d’abonnés, de sections et de collaborateurs, ainsi qu’un indicateur is_collaborative pour les tableaux auxquels d’autres comptes peuvent ajouter des épingles. C’est le premier appel à faire lorsque vous auditez le Pinterest d’un concurrent ou présélectionnez des créateurs par thème : les compteurs montrent sur quels thèmes un compte investit et quelles collections les gens suivent réellement.

curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.pinterest.com/marthastewart/"],
    "results_limit": 25
  }'

Utilisez des URL de profils comme https://www.pinterest.com/username/. results_limit s’applique à chaque profil, vaut 25 par défaut et accepte de 1 à 500. Les compteurs du tableau se trouvent sous metrics : pins_count, followers_count, sections_count et collaborators_count. Consultez la documentation User Boards.

Pinterest Board Pins : collecter le contenu d’un tableau

La Pinterest Board Pins API renvoie les épingles d’un tableau, dans l’ordre où le tableau les affiche. Chaque épingle comprend son titre ou sa description, le compte qui l’a enregistrée, l’image en taille réelle (avec une vignette et ses dimensions sous media) et l’URL de l’épingle. Pointez-la vers un tableau soigneusement constitué dans votre niche pour collecter des images de référence, suivre ce qu’un concurrent ajoute à un tableau saisonnier ou constituer en une seule passe un jeu de données de moodboard.

curl -X POST "https://api.socq.ai/v1/pinterest/board" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.pinterest.com/lizmrodgers/moms-night/"],
    "results_limit": 50
  }'

Utilisez des URL de tableaux sous la forme /{username}/{board}/. results_limit s’applique à chaque tableau, vaut 50 par défaut et accepte de 1 à  . Consultez la documentation Board Pins.

Pinterest Topic : la recherche de mots-clés pour Pinterest

La Pinterest Topic API évalue un sujet avant que vous ne produisiez du contenu dessus. Pour chaque page d’idées, vous obtenez le nombre de recherches mensuelles indiqué par Pinterest (search_count) et les sujets plus précis qu’il suggère en dessous (related_topics, chacun avec un nom, un libellé court et sa propre URL de page d’idées), comme les styles, occasions et matériaux que les gens associent à l’idée principale.

curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.pinterest.com/ideas/home-decor/935249274030/"]
  }'

Utilisez des URL de pages d’idées sous la forme /ideas/{topic}/{id}/. Chaque sujet renvoie une ligne. Comme chaque sujet plus précis est fourni avec sa propre URL, vous pouvez renvoyer ces URL au même endpoint pour comparer la demande entre angles de longue traîne. Consultez la documentation Topic.

Comment les trois endpoints s’articulent

Une étude typique d’un concurrent ou d’une niche les enchaîne :

  1. User Boards sur le profil d’un concurrent pour voir quels tableaux comptent le plus d’abonnés et d’épingles.
  2. Board Pins sur les tableaux qui comptent pour collecter les images et descriptions qu’ils contiennent.
  3. Topic sur les pages d’idées de ces thèmes pour vérifier la demande de recherche mensuelle et trouver des angles plus précis.

Pour des épingles individuelles, les épingles propres à un utilisateur ou des résultats de recherche par mot-clé, utilisez les endpoints existants Pins, User Pins et Search. Tous les endpoints Pinterest sont listés sur la page de la plateforme Pinterest.

Authentification et flux de tâches asynchrones

Chaque requête transmet votre clé API et un type de contenu JSON :

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Chaque appel d’envoi lance une tâche en arrière-plan :

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La réponse à l’envoi renvoie data.task_id et data.status. Interrogez la tâche avec la même clé :

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Tant que la tâche est queued, running ou failed, la réponse ne contient que les métadonnées de la tâche ; en cas de failed, lisez error_message. Lorsqu’elle est succeeded, la même réponse contient la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500. Si has_more est vrai, passez results.next_cursor comme cursor pour lire la page suivante. fields accepte jusqu’à 50 champs ou chemins pointés séparés par des virgules lorsque vous n’avez besoin que de quelques colonnes, par exemple name,metrics.followers_count pour les tableaux.

Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même task_id plutôt que de renvoyer la requête et de payer un doublon. Pour éviter l’interrogation, ajoutez callback_url au corps de l’envoi ; SocQ envoie un POST contenant un résumé de la tâche lorsqu’elle se termine, et vous lisez les enregistrements depuis l’endpoint de tâche.

Combien coûte une tâche typique

  • Lister 25 tableaux d’un profil : 25 × 0,5 = 12,5 crédits, $0,0625.
  • Collecter   épingles d’un tableau : 500 crédits, $2,50.
  • Vérifier 20 sujets : 10 crédits, $0,05.

Comme results_limit s’applique par profil ou par tableau, une requête contenant plusieurs URL peut renvoyer jusqu’à ce nombre de lignes pour chacune. Fixez la limite en tenant compte du nombre d’URL.

FAQ

User Boards renvoie-t-il les tableaux privés ou secrets ?

Non. Il liste les tableaux publics d’un profil.

Que signifie le nombre de recherches de Topic ?

search_count est le nombre de recherches mensuelles que Pinterest indique pour la page d’idées. updated_at est le moment où Pinterest a actualisé le sujet pour la dernière fois.

Puis-je obtenir les épingles de plusieurs tableaux en une seule requête ?

Oui. Placez plusieurs URL de tableaux dans urls. results_limit s’applique séparément à chaque tableau, et chaque épingle renvoyée coûte 0,5 crédit.

Est-ce que je paie si un tableau est vide ?

Il n’y a pas de frais de base : vous ne payez que pour les tableaux, épingles ou sujets renvoyés.

Où sont indiqués les prix Pinterest ?

Chaque page d’atterrissage affiche son tarif, et la page des tarifs liste le tarif actuel en crédits de chaque API SocQ.

PINTEREST API

Tester le workflow avec une URL publique Pinterest

Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.

Découvrir les API Pinterest