Pinterest Topic
Un sujet Pinterest est une page d’idées qui regroupe des Pins autour d’un thème comme la décoration intérieure, accompagnée du nombre de recherches mensuelles que Pinterest lui attribue, de la date d’actualisation de ce chiffre et d’une série de sous-sujets plus précis, par exemple des variantes de Noël ou de seconde main. Ces chiffres mesurent la demande qu’un thème suscite sur Pinterest, tandis que les sous-sujets désignent les styles, occasions et matières que les internautes y associent, ce qui pose les bases d’une recherche de mots-clés et d’un planning éditorial.
Fonctionnalités de la Pinterest Topic API
- Nombre de recherches mensuelles par sujetsearch_count est le nombre de recherches mensuelles que Pinterest indique pour le sujet, une mesure directe de la fréquence à laquelle on le cherche.
- Des sous-sujets avec leurs propres liensrelated_topics liste les sous-sujets suggérés par Pinterest, chacun avec un nom complet, un libellé court comme DIY et l’url de sa page d’idées.
- La date d’actualisation du chiffreupdated_at enregistre la dernière actualisation du sujet par Pinterest, pour savoir à quel point le nombre de recherches est récent.
- Plusieurs sujets par requêteurls accepte plusieurs pages d’idées à la fois et chacune renvoie exactement une ligne, identifiée par l’id du sujet présent dans l’adresse de la page.
Paramètres de la Pinterest Topic API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liens de pages d’idées Pinterest au format /ideas/{topic}/{id}/, id numérique compris, comme https://www.pinterest.com/ideas/home-decor/935249274030/. |
Comment utiliser la Pinterest Topic API
Envoyez des liens de pages d’idées et recevez une ligne par sujet.
- Copiez les liens des pages d’idées sur Pinterest et envoyez-les dans urls en POST à /v1/pinterest/topic.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status indique succeeded.
- Lisez un sujet par élément dans results.items ; si has_more vaut true, récupérez la suite avec results.next_cursor.
curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/ideas/home-decor/935249274030/"]}'
# One row and 0.5 credits per topic.Cas d’usage de la Pinterest Topic API
- Classer des idées de contenu selon la demande : Collectez search_count pour une liste de sujets candidats et traitez en priorité les plus recherchés avant de planifier vos Pins ou vos tableaux.
- Trouver des angles de longue traîne dans un thème large : Lisez les libellés de related_topics, comme Christmas, Thrifted ou Earthy Cottage sous home decor, pour choisir un angle plus étroit avec un public bien défini.
- Tenir votre propre historique de la demande sur Pinterest : Collectez les mêmes sujets chaque mois et stockez search_count avec updated_at pour tracer l’évolution de l’intérêt pour chaque thème.
Conseils d’expert pour la Pinterest Topic API
- Gardez l’id numérique dans chaque lien : /ideas/home-decor/935249274030/ est accepté, alors qu’une adresse qui s’arrête au nom du sujet échoue à la validation.
- Explorez une niche niveau par niveau en envoyant related_topics[].url comme lot suivant, et écartez les id de sujets déjà collectés, car les branches ramènent souvent aux mêmes pages d’idées.
- Ne comparez les search_count de plusieurs sujets qu’en tenant compte de updated_at, car chaque chiffre date de la dernière actualisation propre à son sujet.
API associées
En complément de la Pinterest Topic 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 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.