pinterest/
profiles

Collectez des profils Pinterest publics à partir d’une ou plusieurs URL de profil, avec identité, bio et site web, visuels du profil et nombres visibles du compte, sous forme d’enregistrements normalisés.

Pinterest Profiles API

URL de profil en entrée
Identité et site web
Indicateurs de compte visibles
0,6 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 Profiles

Les profils Pinterest sont des pages de compte publiques réunissant noms d’utilisateur, noms affichés, bios, images de profil, sites web liés et nombres visibles d’abonnés, d’abonnements, de tableaux et d’éléments enregistrés. Ces champs d’identité et signaux de compte servent à enrichir des profils, à comparer des comptes publics et à suivre leur évolution dans le temps.

Fonctionnalités de la Pinterest Profiles API

  • Périmètre des URL de profils publicsTraitez une ou plusieurs URL de profils Pinterest prises en charge, en excluant les liens de Pins, les liens courts, les pages de recherche et les autres chemins qui ne sont pas des profils.
  • Identité et présentation du profilRenvoie l’ID du profil, l’URL canonique, le nom d’utilisateur, le nom affiché, la bio, l’image de profil et le site web lié dans un seul enregistrement normalisé.
  • Nombres visibles du compteConserve les nombres d’abonnés, d’abonnements, de tableaux et d’éléments enregistrés sous forme d’indicateurs distincts, pour comparer des comptes.
  • Contexte de collecte et de sourceAjoute collected_at ainsi que, si disponibles, le code pays, l’URL de la page des Pins créés, la valeur de mise à jour de la source et l’entrée de découverte, sans les mêler aux champs d’identité.

Paramètres de la Pinterest Profiles API

ParamètresObligatoireDescription
urlsObligatoireListe obligatoire d’URL de profils Pinterest publics. Chaque URL doit utiliser HTTP ou HTTPS sur un domaine Pinterest et contenir un segment de chemin de nom d’utilisateur non réservé.

Comment utiliser la Pinterest Profiles API

Envoyez des URL de profils publics connus, suivez la tâche asynchrone, puis lisez les enregistrements de profil normalisés avec la pagination par curseur.

  1. Préparez une ou plusieurs URL de profils Pinterest publics dont le chemin contient un seul segment de nom d’utilisateur.
  2. Envoyez les liens dans urls à /v1/pinterest/profiles et récupérez le task_id.
  3. Interrogez /v1/tasks/{task_id} jusqu’à la réussite du traitement ou jusqu’à son échec.
  4. Lisez data.results.items, puis réclamez la page suivante avec next_cursor aussi longtemps que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/pinterest/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/example/"]}'

# 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 Profiles API

  • Enrichissement de profils publics : Ajoutez nom d’utilisateur, nom affiché, bio, image de profil, site web et contexte pays à des enregistrements liés à des URL de profils connues.
  • Comparaison de l’empreinte des comptes : Comparez les nombres visibles d’abonnés, d’abonnements, de tableaux et d’éléments enregistrés sur un ensemble choisi de profils publics.
  • Suivi de profils publics : Stockez les champs d’identité et les indicateurs visibles avec collected_at pour comparer la présentation du profil et les signaux du compte d’une collecte à l’autre.

Conseils d’expert pour la Pinterest Profiles API

  • Utilisez une URL de profil Pinterest complète en HTTP ou HTTPS avec un seul segment de nom d’utilisateur ; pin.it, /pin/, /search/ et les autres chemins réservés sont rejetés.
  • Normalisez les URL envoyées et dédoublonnez les profils renvoyés par id lorsqu’il est disponible, en prenant url comme clé stable de repli.
  • Considérez bio, image, site web, code pays, valeur de mise à jour de la source, URL de la page des Pins créés et chaque indicateur comme des champs facultatifs.
  • Gardez collected_at à côté des nombres de compte visibles pour que les exécutions ultérieures restent des instantanés publics distincts.
  • Utilisez Pinterest User Pins API pour obtenir les Pins d’un profil ; cet endpoint renvoie les métadonnées et les nombres du profil, pas les tableaux, les Pins ni les listes d’audience.

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

Pinterest Profiles API récupère les métadonnées publiques d’un ou plusieurs profils Pinterest à partir d’URL prises en charge. Elle renvoie l’identité, la bio, l’image de profil, le site web, les nombres visibles du compte et le contexte de collecte, normalisés.

Envoyez une URL HTTP ou HTTPS complète d’un domaine Pinterest dont le chemin contient un segment de nom d’utilisateur non réservé. Les URL de Pins, les liens pin.it, les pages de recherche et les chemins réservés comme /ideas/ ou /today/ sont rejetés.

Les résultats peuvent contenir l’ID du profil, l’URL, le nom d’utilisateur, le nom affiché, la bio, l’avatar, le site web, les nombres d’abonnés et d’abonnements, de tableaux et d’éléments enregistrés, l’heure de collecte, le code pays et l’URL de la page des Pins créés.

Non. Il renvoie les métadonnées du profil et des totaux visibles, pas d’enregistrements de tableaux ni de Pins, ni les membres des listes d’abonnés et d’abonnements ; utilisez Pinterest User Pins API pour les Pins découverts à partir d’une URL de profil.

Un profil public peut ne pas exposer de bio, de site web, d’image, de code pays, d’URL de la page des Pins créés, de valeur de mise à jour de la source ni tous les nombres visibles. Les clients doivent accepter des valeurs facultatives null ou vides.

Chaque enregistrement de profil d’un résultat terminé coûte 0,6 crédit SocQ. Un jeu de résultats vide n’entraîne aucun frais de résultat.