pinterest/
search

Recherchez des Pins Pinterest publics par requête textuelle avec une limite de résultats, et obtenez contenu, contexte du créateur, médias, taxonomie et engagement visible, normalisés.

Pinterest Search API

Requête textuelle en entrée
1–2 000 résultats demandés
Pins publics normalisés
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 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ètresObligatoireDescription
queryObligatoireRequê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_limitFacultatifNombre 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.

  1. Préparez une requête textuelle non vide et choisissez un results_limit de 1 à 2 000.
  2. Envoyez query et results_limit en POST à /v1/pinterest/search, puis enregistrez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données Pinterest avec les données publiques d’autres plateformes sociales prises en charge.

Pinterest Search API — FAQ

Pinterest Search API découvre des Pins publics à partir d’une requête textuelle non vide et d’une limite de résultats facultative. Elle renvoie l’identité des Pins, le contenu, les créateurs, les médias, la taxonomie, les horodatages et l’engagement visible, normalisés.

L’endpoint accepte uniquement query et results_limit. Il n’expose aucun paramètre de tri, de date, de langue, de tableau ni de type de résultat.

Chaque résultat normalisé est un Pin public dont resource vaut search et type vaut pin. Les profils, tableaux, produits et suggestions ne sont pas des types de résultats distincts dans cette réponse.

Les enregistrements peuvent contenir l’ID et l’URL du Pin, le titre, le texte, les détails publics de l’auteur, des références d’images ou de vidéos, les nombres visibles de likes, de commentaires et d’abonnés, created_at, collected_at, ainsi que les champs extra de taxonomie, de source et de découverte. Les valeurs de source facultatives peuvent être null ou vides.

results_limit vaut 100 par défaut et accepte des entiers de 1 à 2 000 comme maximum demandé pour la requête. Les réponses de tâche réussies renvoient les résultats stockés par pages de 50 par défaut ; suivez next_cursor tant que has_more vaut true, et utilisez une limite de page de 1 à 500 si vous appelez directement l’endpoint de tâche.

Chaque enregistrement de Pin renvoyé coûte 0,6 crédit SocQ. L’estimation avant requête utilise results_limit, ou 100 s’il est omis, et un jeu de résultats vide n’entraîne aucun frais de résultat.