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é.

pinterest/profiles
Profils0,6 crédit par résultat

pinterest/pins
Publications0,5 crédit par résultat

pinterest/user-pins
Publications0,5 crédit par résultat

pinterest/search
Recherche0,6 crédit par résultat

pinterest/user-boards
Profils0,5 crédit par résultat

pinterest/board
Publications0,5 crédit par résultat

pinterest/topic
Recherche0,5 crédit par résultat
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é | SocQ | Pinterest API |
|---|---|---|
| Usage principal | Collecter des profils publics, des Pins, des Pins d’utilisateur et des résultats de recherche | Gérer des contenus, des publicités, des statistiques et des catalogues autorisés |
| OAuth côté client | Clé API SocQ ; pas d’OAuth Pinterest côté client | Application Pinterest, jeton d’accès et scopes requis |
| Entrée de départ | URL de profil ou de Pin publique, ou requête textuelle | Contexte de compte autorisé et ID de ressources Pinterest |
| Créer ou gérer des Pins | Non pris en charge | Pris en charge au nom d’un utilisateur authentifié disposant de scopes d’écriture |
| Format de réponse | Enregistrements SocQ normalisés | Objets 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. 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. Suivre la tâche
Interrogez /v1/tasks/{task_id} jusqu’à la fin du traitement.
3. Récupérer les résultats
Lisez data.results.items et utilisez next_cursor tant que has_more vaut true.
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 trueCas 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.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
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.
Threads API
Récupérez des profils Threads publics, résolvez des publications connues ou collectez les publications de profils sélectionnés, avec des champs normalisés d’identité, de contenu, de médias, d’engagement et d’horodatage.
Bluesky API
Récupérez des profils Bluesky publics, résolvez des URL de publications connues ou collectez une page de publications d’un compte, avec identité, contenu, médias, horodatages et champs d’engagement visibles normalisés.
Snapchat API
Récupérez un Spotlight Snapchat public connu sous forme d’enregistrement normalisé, avec les champs disponibles de créateur, de légende, de média, d’audio, de date, de durée et d’engagement.
Twitch API
Transformez un nom d’utilisateur Twitch public connu en profil normalisé, collectez son inventaire de vidéos publiques ou récupérez un clip avec sa vidéo téléchargeable pour l’étude des créateurs, l’enrichissement de catalogues, la comparaison et le suivi par instantanés.
Rednote API
Récupérez des profils et des notes publics, recherchez des notes ou des utilisateurs, collectez les commentaires et leurs réponses imbriquées, et capturez une page de recommandations de la page d’accueil.
Kwai API
Récupérez des profils Kwai publics, une page de publications d’un compte ou une publication connue, avec identité, contenu, médias, horodatages et engagement visible normalisés.