Retour aux API
Données publiques Pinterest

Pinterest Public Data API

Récupérez les données de profils Pinterest publics, résolvez des Pins connus, collectez les Pins de profils sélectionnés ou lancez une recherche par mot-clé pour étudier les créateurs, les contenus et les tendances visuelles.

API Pinterest disponibles

Profiles pour les données de compte, Pins pour un Pin connu, User Pins pour le contenu de profils sélectionnés, ou Search pour trouver des Pins par mot-clé.

Quelles données Pinterest pouvez-vous récupérer ?

SocQ renvoie des enregistrements publics normalisés de comptes et de Pins, avec le contexte d’identité, de contenu, de médias, de classification, de découverte, d’engagement et de date de collecte.

Détails des profils publics

Récupérez les ID de profil, noms d’utilisateur, noms affichés, bios, images, sites web liés, contexte de pays et nombres visibles du compte.

Contenu et médias des Pins

Récupérez l’identité du Pin, son titre, son texte, les informations sur le créateur, les références médias, la date de publication et les indicateurs visibles lorsqu’ils sont disponibles.

Collections de Pins par créateur

Parcourez un ensemble borné de Pins publics issus d’URL de profils sélectionnés, chaque résultat restant rattaché au profil envoyé.

Sujets et classification

Recherchez des Pins par mot-clé et conservez, lorsqu’ils sont disponibles, le type de publication, les catégories, les hashtags, les informations de source et la requête à l’origine de la découverte.

SocQ vs Pinterest API

SocQ se concentre sur la collecte prise en charge de données publiques Pinterest. L’API officielle de Pinterest est conçue pour des intégrations authentifiées de contenu, de publicité, d’analyse et de catalogue.

FonctionnalitéSocQPinterest API
Usage principalCollecter des profils publics, des Pins, des Pins d’utilisateur et des résultats de rechercheGérer des contenus, des publicités, des statistiques et des catalogues autorisés
OAuth côté clientClé API SocQ ; pas d’OAuth Pinterest côté clientApplication Pinterest, jeton d’accès et scopes requis
Entrée de départURL de profil ou de Pin publique, ou requête textuelleContexte de compte autorisé et ID de ressources Pinterest
Créer ou gérer des PinsNon pris en chargePris en charge au nom d’un utilisateur authentifié disposant de scopes d’écriture
Format de réponseEnregistrements SocQ normalisésObjets natifs de l’API Pinterest

Fonctionnement de l’API Pinterest

Les quatre API Pinterest suivent le même flux : tâche asynchrone, puis résultats paginés.

  1. 1. Envoyer votre entrée

    Envoyez des URL de profils, des URL de Pins ou une requête de recherche à l’API correspondante et conservez le task_id renvoyé.

  2. 2. Suivre la tâche

    Interrogez /v1/tasks/{task_id} jusqu’à la fin du traitement.

  3. 3. Récupérer les résultats

    Lisez data.results.items et utilisez next_cursor tant que has_more vaut true.

Rechercher des Pins publics par mot-clé

Authentifiez-vous avec votre clé API SocQ et envoyez une requête textuelle. Profiles, Pins et User Pins suivent le même flux de tâche.

curl -X POST "https://api.socq.ai/v1/pinterest/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home office ideas","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage courants de l’API Pinterest

Recherche sur les créateurs et les profils

Enrichissez des URL de profils déjà connues avec l’identité publique, la bio, le site web, le contexte de pays, les nombres visibles et la date de collecte.

Analyse de Pins connus

Transformez des URL de Pins sélectionnées en contenu, créateur, médias, taxonomie, horodatages, indicateurs visibles et liens de source.

Suivi des contenus d’un créateur

Collectez des lots bornés de Pins depuis des profils sélectionnés et comparez les contenus et les instantanés de compte au moment de la collecte.

Veille sur les sujets et tendances visuels

Recherchez des mots-clés précis pour constituer des jeux de données de Pins structurés, avec le contexte de créateur, de médias, de classification et de découverte.

Limites et politique sur les données publiques

Les résultats Pinterest sont des enregistrements publics à un instant donné. Ces API n’accèdent pas aux contenus privés et ne créent, ne modifient, n’enregistrent ni ne gèrent de profils ou de Pins.

  • Profiles exige une URL de profil comportant un seul segment de chemin pour le nom d’utilisateur. Il renvoie les détails du compte, mais ni tableaux, ni Pins, ni listes de membres de l’audience.
  • Pins exige une URL publique /pin/{id} connue ou un lien pin.it et ne transforme pas un profil en collection de Pins.
  • User Pins exige des URL de profils publics. results_limit vaut 100 par défaut, accepte de 1 à 2 000 et s’applique séparément à chaque profil.
  • Search exige une requête textuelle. results_limit vaut 100 par défaut et accepte de 1 à 2 000 ; le tri et les filtres supplémentaires ne sont pas proposés.
  • Les champs facultatifs d’identité, de contenu, de médias, de classification, de source, d’horodatage et d’indicateurs peuvent être null ou vides lorsque la source publique ne les expose pas.
  • Ces API sont en lecture seule et ne créent, ne modifient, n’enregistrent ni ne gèrent de profils, de tableaux ou de Pins Pinterest.

Questions fréquentes sur l’API Pinterest

Qu’est-ce que l’API Pinterest ?

L’API Pinterest est un ensemble d’endpoints SocQ pour récupérer des données de profils publics, résoudre des Pins connus, collecter les Pins de profils sélectionnés et rechercher des Pins publics par mot-clé.

Quelle API Pinterest choisir ?

Utilisez Profiles pour les détails d’un compte, Pins pour des liens /pin/{id} ou pin.it connus, User Pins pour une collection bornée à partir d’URL de profils, et Search pour la découverte par mot-clé.

Profiles et User Pins renvoient-ils les mêmes données ?

Non. Profiles renvoie les métadonnées du compte et des compteurs agrégés, tandis que User Pins renvoie des enregistrements de Pins normalisés, trouvés à partir des URL de profils envoyées.

Comment fonctionne la limite de résultats de User Pins ?

results_limit vaut 100 par défaut, accepte les entiers de 1 à 2 000 et s’applique séparément à chaque URL de profil.

Pourquoi certains champs sont-ils null ou vides ?

Un profil ou un Pin public peut ne pas exposer, au moment de la collecte, toutes les valeurs d’identité, de contenu, de médias, de taxonomie, de source, d’horodatage ou d’indicateurs.

Comment la collecte Pinterest est-elle facturée ?

Chaque profil renvoyé et chaque Pin renvoyé par Search coûtent 0,6 crédit, tandis que chaque Pin renvoyé par Pins ou User Pins coûte 0,5 crédit. Un jeu de résultats vide n’entraîne aucun frais de résultat.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.