Pinterest Search
Les résultats de Pinterest Search sont des Pins publics correspondant à une requête textuelle, avec titres, descriptions, informations sur le créateur, références de médias, catégories, hashtags, horodatages et engagement visible. Ces enregistrements servent à découvrir des sujets, à étudier des thèmes visuels, à analyser le contexte des créateurs et à comparer des contenus selon la requête.
Fonctionnalités de la Pinterest Search API
- Découverte de Pins par requêteAcceptez une requête textuelle non vide et un results_limit de 1 à 2 000 pour demander une collecte bornée d’enregistrements de Pins publics.
- Enregistrements normalisés de Pins, créateurs et médiasRenvoie les ID et URL des Pins, les titres, les textes, les champs publics du créateur et les références d’images ou de vidéos dans une structure de résultat cohérente.
- Taxonomie et contexte des signaux visiblesConserve, lorsqu’ils sont disponibles, les catégories, hashtags, type de Pin, métadonnées de source, nombres visibles de likes, de commentaires et d’abonnés du créateur, date de publication, date de collecte et contexte de la requête envoyée.
Paramètres de la Pinterest Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Requête textuelle obligatoire et non vide servant à découvrir des Pins Pinterest publics ; les espaces au début et à la fin sont supprimés avant l’envoi. |
results_limit | Facultatif | Nombre maximal de Pins demandés pour la requête ; 100 par défaut, entiers acceptés de 1 à 2 000. |
Comment utiliser la Pinterest Search API
Envoyez une requête textuelle Pinterest avec une limite de résultats, suivez la tâche asynchrone, puis lisez les Pins normalisés avec la pagination par curseur.
- Préparez une requête textuelle non vide et choisissez un results_limit de 1 à 2 000.
- Envoyez query et results_limit en POST à /v1/pinterest/search, puis enregistrez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- 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/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"home office ideas","results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Pinterest Search API
- Jeux de données de Pins par sujet : Associez une requête définie aux ID de Pins, URL sources, titres, textes, références de médias et discovery_input pour constituer une collection thématique traçable.
- Recherche visuelle et taxonomique : Comparez images ou vidéos, post_type, catégories, hashtags, titres et descriptions pour examiner les formats et thèmes d’une requête.
- Comparaison des créateurs et des signaux visibles : Combinez les champs publics du créateur avec les nombres de likes, de commentaires et d’abonnés, plus collected_at, pour comparer le contexte observé d’une collecte à l’autre.
Conseils d’expert pour la Pinterest Search API
- Envoyez une requête non vide, sans espaces superflus autour, et gardez results_limit entre 1 et 2 000 pour satisfaire la validation des entrées.
- Suivez next_cursor jusqu’à ce que has_more soit false lorsque les résultats stockés dépassent la première page de réponse de 50 éléments.
- Conservez extra.discovery_input et collected_at afin que chaque Pin reste rattaché au mot-clé envoyé et à l’heure d’observation.
- Traitez title, text, les détails de l’auteur, media, created_at, categories, hashtags, source et chaque indicateur comme des champs facultatifs, et non comme des échecs de requête lorsqu’une valeur manque.
API associées
En complément de la Pinterest Search 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 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.