Pinterest Pins
Les Pins Pinterest sont des publications visuelles publiques dotées de titres, de descriptions, d’informations sur le créateur, de références d’images ou de vidéos, de catégories, de hashtags et d’un engagement visible. Ces enregistrements servent à archiver des contenus choisis, à étudier la création visuelle et les sujets, à citer les sources et à comparer des états pris à des moments de collecte différents.
Fonctionnalités de la Pinterest Pins API
- URL directes et courtes de PinsTraitez une ou plusieurs URL Pinterest publiques /pin/{id} ou des liens courts pin.it, en limitant la collecte aux Pins envoyés.
- Contenu et créateur liésRenvoie le titre et le texte du Pin avec l’URL source, l’identité publique du créateur, l’URL de son profil et des références d’images ou de vidéos normalisées.
- Indicateurs visibles et date d’observationConserve les nombres de likes et de commentaires disponibles, ainsi que le nombre d’abonnés du créateur, avec collected_at, afin que ces valeurs publiques modifiables aient une date d’instantané claire.
- Contexte de classification des PinsPréserve post_type, les catégories et les hashtags disponibles dans extra pour analyser formats et sujets, sans les fondre dans le texte du Pin.
Paramètres de la Pinterest Pins API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire d’URL Pinterest publiques /pin/{id} ou de liens courts pin.it. Les autres chemins Pinterest et les hôtes qui ne sont pas Pinterest sont rejetés. |
Comment utiliser la Pinterest Pins API
Envoyez précisément les Pins publics voulus, suivez la tâche asynchrone, puis lisez les enregistrements de Pins normalisés grâce à la pagination par curseur.
- Rassemblez une ou plusieurs URL Pinterest publiques /pin/{id} ou liens courts pin.it.
- Envoyez les liens dans urls à /v1/pinterest/pins et notez le task_id.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que le traitement réussisse ou renvoie un échec.
- Lisez data.results.items, puis demandez la page suivante avec next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/pinterest/pins" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/pin/123456789/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Pinterest Pins API
- Archivage de Pins sélectionnés : Conservez les ID de Pins, URL sources, titres, textes, champs du créateur, références de médias et dates de publication pour une liste d’URL définie.
- Revue créative et thématique : Exploitez le type de média, post_type, les catégories, les hashtags, les titres et les textes pour comparer formats et thèmes sur des Pins choisis.
- Comparaison des signaux à la collecte : Comparez les nombres visibles de likes et de commentaires avec le contexte d’abonnés du créateur, en ancrant chaque observation avec collected_at.
Conseils d’expert pour la Pinterest Pins API
- Utilisez une URL publique /pin/{id} ou un lien pin.it pour chaque élément ; les profils, recherches, idées et autres chemins Pinterest ne respectent pas la règle d’entrée de cet endpoint.
- Dédoublonnez les valeurs id renvoyées, car un lien direct et un lien raccourci peuvent désigner le même Pin.
- Traitez media, created_at, categories, hashtags, post_type et chaque indicateur comme des champs facultatifs, car un Pin public n’expose pas forcément chaque valeur.
- Stockez collected_at à côté des indicateurs visibles pour que les exécutions suivantes restent interprétables comme des instantanés distincts.
API associées
En complément de la Pinterest Pins API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Pinterest.
- 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 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.