pinterest/
board

Collectez les Pins de tableaux Pinterest à partir de leurs URL, dans l’ordre du tableau, avec le texte du Pin, le compte qui l’a enregistré, l’image en taille réelle et la miniature avec leurs dimensions, et le lien du Pin.

Pinterest Board Pins API

URL de tableau en entrée
Pins dans l’ordre du tableau
URL d’images en taille réelle
Jusqu’à 1 000 Pins par tableau
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Pinterest Board Pins

Les Pins d’un tableau Pinterest sont les images qu’une personne a réunies autour d’une idée, chacune avec un titre ou une courte description, le compte qui l’a enregistrée et l’image d’origine dans toute sa largeur et sa hauteur. Pris ensemble dans l’ordre où le tableau les présente, ils forment un ensemble de références visuelles prêt à l’emploi pour des planches d’inspiration, des recherches de design, des jeux de données d’images et le suivi de l’évolution d’une collection.

Fonctionnalités de la Pinterest Board Pins API

  • Les Pins dans l’ordre du tableauLes lignes suivent la séquence affichée par le tableau lui-même, si bien que la collection se lit telle que son auteur l’a organisée.
  • Image d’origine et miniaturemedia.url pointe vers l’image en taille réelle et media.thumbnail_url vers un petit aperçu, avec la largeur et la hauteur en pixels de chaque fichier.
  • Qui l’a enregistré et ce qu’il ditauthor désigne le compte qui a enregistré chaque Pin, avec son nom d’utilisateur, son nom affiché, son lien de profil et son avatar, et text porte le titre ou la description du Pin.
  • Un lien vers chaque Pinurl est la page propre du Pin, reconstruite à partir de son id : chaque image de l’ensemble peut être retrouvée à son emplacement sur Pinterest.
  • Jusqu’à 1 000 Pins par tableauresults_limit s’applique à chaque tableau, vaut 50 par défaut et accepte jusqu’à 1 000, et plusieurs tableaux peuvent être envoyés ensemble dans urls.

Paramètres de la Pinterest Board Pins API

ParamètresObligatoireDescription
urlsObligatoireLiens de tableaux Pinterest au format /{username}/{board}/, comme https://www.pinterest.com/lizmrodgers/moms-night/.
results_limitFacultatifNombre maximal de Pins renvoyés pour chaque tableau, entier de 1 à 1 000. 50 par défaut.

Comment utiliser la Pinterest Board Pins API

Envoyez des liens de tableaux, attendez la fin de la tâche, puis lisez les Pins page par page.

  1. Envoyez en POST à /v1/pinterest/board les liens de tableaux dans urls, avec results_limit si vous avez besoin de plus de 50 Pins par tableau.
  2. Interrogez GET /v1/tasks/{task_id} avec le task_id reçu jusqu’à ce que la tâche ait réussi.
  3. Prenez les Pins dans results.items et continuez avec results.next_cursor tant que has_more vaut true.
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}'

# 0.5 credits per pin; boards that do not exist return no pins.

Cas d’usage de la Pinterest Board Pins API

  • Télécharger les images d’un tableau : Enregistrez chaque media.url d’un tableau pour constituer une bibliothèque locale de fichiers d’origine, en vous servant de width et height pour trier portraits et paysages.
  • Constituer un jeu de données d’images légendées : Associez chaque image au text du Pin et au tableau dont elle provient pour réunir des exemples étiquetés destinés à la recherche en design ou à l’entraînement de modèles.
  • Surveiller le tableau saisonnier d’un concurrent : Collectez le même tableau chaque semaine et comparez les id des Pins avec l’exécution précédente pour voir précisément ce qui a été ajouté.
  • Créditer les sources d’une planche d’inspiration : Gardez author.username et l’url du Pin à côté de chaque image afin que chaque visuel d’une présentation puisse être crédité et rouvert.

Conseils d’expert pour la Pinterest Board Pins API

  • Utilisez le lien en deux parties du tableau lui-même ; les onglets de profil comme /{username}/_saved/ ou /{username}/pins/, les chemins de sections plus profonds et les liens courts pin.it sont refusés : ouvrez le tableau et copiez son adresse.
  • Vérifiez d’abord le metrics.pins_count du tableau avec Pinterest User Boards API, puis réglez results_limit en conséquence, pour qu’un grand tableau ne soit pas coupé aux 50 Pins par défaut.
  • Chargez thumbnail_url pour les grilles et les aperçus et ne récupérez media.url que pour les images que vous conservez, ce qui économise de la bande passante sur les tableaux de plusieurs centaines de Pins.

En complément de la Pinterest Board Pins API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Pinterest.

  • Pinterest Pins API — Transformez des URL de Pins publics en contenu, créateur, médias, taxonomie, horodatages et indicateurs visibles normalisés.
  • Pinterest User Pins API — Repérez les Pins publics à partir d’URL de profils, avec limite par profil, contenu, créateur, médias, horodatages et indicateurs visibles normalisés.
  • Pinterest Profiles API — Collectez l’identité publique d’un profil, sa bio, son image, son site web, ses nombres visibles et le contexte de collecte à partir d’URL de profils.
  • Pinterest Search API — Recherchez des Pins publics par requête textuelle avec limite de résultats, et obtenez contenu, créateur, médias, taxonomie, horodatages et indicateurs visibles normalisés.
  • Pinterest User Boards API — Listez les tableaux de profils Pinterest à partir de leurs URL, avec noms, descriptions, couvertures, dates de création et nombres de Pins, d’abonnés, de sections et de collaborateurs.
  • Pinterest Topic API — Lisez des URL de pages d’idées Pinterest pour obtenir le nombre mensuel de recherches de chaque sujet, sa date d’actualisation et les sous-sujets suggérés.

Explorer d’autres plateformes

Combinez les données Pinterest avec les données publiques d’autres plateformes sociales prises en charge.

Pinterest Board Pins API — FAQ

Pinterest Board Pins API est une interface programmatique qui collecte les Pins enregistrés dans un tableau Pinterest à partir de l’URL du tableau. Elle renvoie, dans l’ordre du tableau, le texte de chaque Pin, le compte qui l’a enregistré, son image en taille réelle et sa miniature avec leurs dimensions, ainsi que le lien du Pin.

Chaque Pin inclut media.url, l’adresse de son image en taille réelle, que vous pouvez télécharger avec n’importe quel client HTTP. Réglez results_limit sur le nombre de Pins du tableau, dans la limite de 1 000, pour couvrir tout le tableau.

author est le compte qui a enregistré le Pin dans le tableau, fourni avec son nom d’utilisateur, son nom affiché, l’url de son profil et son avatar.

Chaque Pin coûte 0,5 crédit : un tableau collecté avec les 50 Pins par défaut coûte 25 crédits et un tableau de 400 Pins en coûte 200.