pinterest/
user-pins

Découvrez les Pins Pinterest publics d’une ou plusieurs URL de profil, avec identité du Pin, texte, détails de l’auteur, médias, engagement visible et contexte de source, sous forme d’enregistrements normalisés.

Pinterest User Pins API

URL de profil en entrée
Limite de résultats par profil
Pins publics normalisés
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 Pins

Les Pins Pinterest d’un utilisateur sont des publications visuelles publiques associées à un profil, décrites par des titres, des descriptions, des informations sur le créateur, des références de médias, des catégories, des hashtags, des horodatages et un engagement visible. Ces champs de contenu et d’observation servent à archiver la collection d’un profil, à étudier des sujets visuels, à attribuer les sources et à comparer des états à l’instant de la collecte.

Fonctionnalités de la Pinterest User Pins API

  • Découverte de Pins par profilAcceptez une ou plusieurs URL de profils Pinterest publics et obtenez les Pins associés à chaque profil envoyé, et non les métadonnées du profil.
  • Profondeur de collecte par profilAppliquez results_limit séparément à chaque URL de profil, avec 100 par défaut et une plage acceptée de 1 à 2 000.
  • Enregistrements normalisés de Pins, auteurs et médiasRenvoie les identifiants et URL des Pins, titres, textes, champs publics de l’auteur et références d’images ou de vidéos dans une structure de résultat cohérente.
  • Engagement et contexte de sourceConserve les nombres visibles de likes, de commentaires et d’abonnés du créateur, avec la date de publication, collected_at, les champs de classification et discovery_input lorsqu’ils existent.

Paramètres de la Pinterest User Pins API

ParamètresObligatoireDescription
urlsObligatoireListe obligatoire d’URL de profils Pinterest publics en HTTP ou HTTPS avec exactement un segment de chemin non réservé ; les URL de Pins, de recherche, d’idées et pin.it sont rejetées.
results_limitFacultatifNombre maximal de Pins demandés pour chaque URL de profil ; 100 par défaut, entiers acceptés de 1 à 2 000.

Comment utiliser la Pinterest User Pins API

Envoyez des URL de profils Pinterest publics avec une limite de résultats par profil, suivez la tâche asynchrone, puis lisez les Pins normalisés avec la pagination par curseur.

  1. Préparez une ou plusieurs URL de profils Pinterest publics comportant un seul segment de chemin de profil.
  2. Envoyez urls et, si besoin, results_limit en POST à /v1/pinterest/user-pins, puis enregistrez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items et demandez le next_cursor renvoyé tant que has_more reste true.
curl -X POST "https://api.socq.ai/v1/pinterest/user-pins" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/example/"],"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 de la Pinterest User Pins API

  • Archivage des Pins d’un profil public : Conservez les ID de Pins, URL sources, titres, textes, champs d’auteur, références de médias, horodatages et discovery_input pour des URL de profils définies.
  • Analyse des formats et des thèmes : Exploitez le type de média, post_type, les catégories, les hashtags, les titres et les textes pour repérer les formats et thèmes récurrents dans des profils publics choisis.
  • Comparaison de signaux entre profils : Comparez les nombres visibles de likes et de commentaires avec le contexte d’abonnés du créateur d’une collection de profils à l’autre, en ancrant chaque observation avec collected_at.

Conseils d’expert pour la Pinterest User Pins API

  • Envoyez une URL de profil Pinterest public avec exactement un segment de chemin ; les liens de Pins, les liens courts pin.it, les pages de recherche et les chemins plus profonds échouent à la validation du profil.
  • Calculez la profondeur demandée et l’estimation de crédits avant requête comme le nombre d’urls multiplié par results_limit, puisque la limite s’applique à chaque profil séparément.
  • Stockez discovery_input et collected_at avec chaque Pin pour que les jeux de données en aval gardent le profil envoyé et l’heure d’observation.
  • Considérez media, created_at, categories, hashtags, source, les détails de l’auteur et chaque indicateur comme facultatifs, et ne déduisez pas si un Pin a été créé ou enregistré lorsqu’aucune classification n’est renvoyée.

En complément de la Pinterest User 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 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 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 Pins API — FAQ

Pinterest User Pins API découvre des Pins publics à partir d’URL de profils Pinterest envoyées. Elle renvoie l’identité des Pins, le texte, les auteurs, les médias, l’engagement visible, les horodatages et le contexte de source, et non des enregistrements de profil.

Envoyez une URL HTTP ou HTTPS d’un domaine Pinterest pris en charge, dont le chemin contient exactement un segment de profil non réservé, comme /example/. Les chemins de Pins, pages de recherche, pages d’idées, chemins plus profonds et liens pin.it sont rejetés.

Les enregistrements peuvent contenir l’ID et l’URL du Pin, le titre, le texte, les détails publics de l’auteur, des références d’images ou de vidéos, les nombres visibles de likes, de commentaires et d’abonnés, created_at, collected_at, ainsi que des champs extra de classification et de découverte. Les valeurs de source facultatives peuvent être null ou vides.

results_limit vaut 100 par défaut et accepte des entiers de 1 à 2 000. Il s’applique à chaque URL de profil : deux URL avec results_limit 50 demandent donc jusqu’à 100 Pins.

Non. La réponse normalisée n’expose aucune classification stable entre créés et enregistrés. Considérez les résultats comme des Pins publics découverts depuis l’URL de profil envoyée, sans en déduire le type d’appartenance.

Non. Cet endpoint n’accepte que des URL de profils et results_limit ; il n’expose ni URL de tableau, ni identifiant de tableau, ni paramètre de filtre par tableau.

Chaque enregistrement de Pin renvoyé coûte 0,5 crédit SocQ. L’estimation multiplie urls par results_limit, et un jeu de résultats vide n’entraîne aucun frais de résultat.