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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste 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.
- Préparez une ou plusieurs URL de profils Pinterest publics dont le chemin contient un seul segment de nom d’utilisateur.
- Envoyez les liens dans urls à /v1/pinterest/profiles et récupérez le task_id.
- Interrogez /v1/tasks/{task_id} jusqu’à la réussite du traitement ou jusqu’à son échec.
- 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 trueCas 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.
API associées
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.