pinterest/
user-boards

Listez les tableaux de profils Pinterest à partir de leurs URL, avec le nom du tableau, sa description, sa couverture, son propriétaire, sa date de création et ses nombres de Pins, d’abonnés, de sections et de collaborateurs.

Pinterest User Boards API

URL de profil en entrée
Jusqu’à 500 tableaux par profil
Nombres de Pins et d’abonnés
Indicateur de tableau collaboratif
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 User Boards

Un tableau Pinterest est une collection nommée de Pins enregistrés, avec une description, une image de couverture et une date de création, ainsi que les nombres de Pins, d’abonnés, de sections et de collaborateurs et un indicateur précisant si d’autres comptes peuvent y contribuer. Lus sur l’ensemble d’un profil, ces tableaux révèlent les thèmes que le compte alimente le plus, les collections qui attirent leurs propres abonnés et les endroits où il ouvre la porte aux contributions partagées.

Fonctionnalités de la Pinterest User Boards API

  • Tous les tableaux d’un profilEnvoyez un ou plusieurs liens de profils Pinterest dans urls : chaque tableau de ces profils revient sous forme d’une ligne distincte, avec son id et son url.
  • Taille et audience de chaque tableaumetrics.pins_count montre le volume enregistré dans un tableau et metrics.followers_count le nombre de personnes qui le suivent, ce qui distingue une archive bien remplie d’une collection qui a un vrai public.
  • Tableaux de groupe et sectionsis_collaborative signale les tableaux auxquels d’autres comptes peuvent ajouter des Pins, metrics.collaborators_count indique combien de comptes le peuvent et metrics.sections_count montre le degré de subdivision d’un tableau.
  • Nom, description, couverture et date de créationname, text et cover_url disent d’un coup d’œil de quoi parle un tableau, tandis que published_at enregistre sa date de création, donc le moment où ce thème est entré dans le compte.
  • Jusqu’à 500 tableaux par profilresults_limit s’applique à chaque profil séparément, vaut 25 par défaut et accepte jusqu’à 500, de sorte que les comptes qui entretiennent des centaines de tableaux peuvent être listés en entier.

Paramètres de la Pinterest User Boards API

ParamètresObligatoireDescription
urlsObligatoireLiens de profils Pinterest avec un seul nom d’utilisateur dans le chemin, comme https://www.pinterest.com/marthastewart/ ; les domaines nationaux tels que pinterest.co.uk ou de.pinterest.com fonctionnent aussi.
results_limitFacultatifNombre maximal de tableaux renvoyés pour chaque profil, entier de 1 à 500. 25 par défaut.

Comment utiliser la Pinterest User Boards API

Envoyez des liens de profils, attendez la fin de la tâche, puis parcourez une ligne par tableau.

  1. Envoyez les liens de profils et un results_limit facultatif en POST à /v1/pinterest/user-boards, puis conservez le task_id de la réponse.
  2. Appelez GET /v1/tasks/{task_id} toutes les quelques secondes jusqu’à ce que status passe à succeeded.
  3. Lisez les tableaux dans results.items ; tant que has_more vaut true, demandez la page suivante avec results.next_cursor.
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}'

# Each board returned costs 0.5 credits.

Cas d’usage de la Pinterest User Boards API

  • Auditer les thèmes Pinterest d’un concurrent : Mettez en regard le name et le text des tableaux avec pins_count pour voir les sujets qu’une marque continue d’alimenter, et avec followers_count pour savoir lesquelles de ces collections sont suivies.
  • Présélectionner des créateurs par niche : Collectez les tableaux des créateurs candidats et rapprochez noms et descriptions de votre sujet, en gardant les comptes qui le traitent dans plusieurs tableaux.
  • Trouver des tableaux de groupe à rejoindre : Gardez les lignes où is_collaborative vaut true et comparez collaborators_count à followers_count pour choisir des tableaux partagés qui ont un public.
  • Suivre les collections qui grandissent : Recollectez régulièrement les mêmes profils et comparez pins_count et followers_count par id de tableau pour voir lesquels gagnent des Pins ou des abonnés.

Conseils d’expert pour la Pinterest User Boards API

  • Ramenez les liens de tableaux et de Pins à la racine du profil avant l’envoi, puisque urls attend https://www.pinterest.com/{username}/ ; les liens de tableaux relèvent de Pinterest Board Pins API.
  • Augmentez results_limit au-delà des 25 par défaut lorsqu’un profil compte davantage de tableaux ; la limite s’applique par profil et seuls les tableaux effectivement renvoyés sont facturés.
  • Regroupez les lignes par author.username quand une tâche couvre plusieurs profils, car chaque tableau porte les informations du compte qui le possède.
  • Transmettez l’url de chaque tableau à Pinterest Board Pins API pour en récupérer les Pins, en vous fondant sur metrics.pins_count pour fixer le results_limit de cet endpoint.

En complément de la Pinterest User Boards 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 Board Pins API — Collectez les Pins d’un tableau Pinterest à partir de son URL, dans l’ordre du tableau, avec le texte, le compte qui a enregistré chaque Pin, les images en taille réelle et les liens des Pins.
  • 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 User Boards API — FAQ

Pinterest User Boards API est une interface programmatique qui liste les tableaux de profils Pinterest publics à partir de l’URL de chaque profil. Elle renvoie pour chaque tableau le nom, la description, l’image de couverture, le propriétaire, la date de création, l’indicateur de collaboration et les nombres de Pins, d’abonnés, de sections et de collaborateurs.

Placez le lien du profil dans urls et réglez results_limit au moins sur son nombre de tableaux, dans la limite de 500. Chaque tableau revient sous forme d’une ligne distincte avec son nom, son url et ses compteurs.

Chaque ligne décrit le tableau lui-même, avec le nombre de Pins qu’il contient dans metrics.pins_count. Pour lire les Pins, envoyez l’url du tableau à Pinterest Board Pins API.

Un tableau collaboratif, souvent appelé tableau de groupe, permet à d’autres comptes que son propriétaire d’y ajouter des Pins. is_collaborative vaut true pour ces tableaux, et metrics.collaborators_count donne le nombre de collaborateurs.

Chaque tableau coûte 0,5 crédit : trois profils à la limite par défaut de 25 coûtent donc au plus 37,5 crédits. Un profil qui a moins de tableaux que la limite n’est facturé que pour ceux qui sont renvoyés.