instagram/
reels-search

Recherchez des Reels Instagram publics à partir d’une requête textuelle, avec légendes, créateurs, médias, horodatages, engagement visible et contexte de la requête dans des enregistrements normalisés.

Instagram Reels Search API

Découverte par requête textuelle
Enregistrements de Reels
Fenêtre de publication
0,5 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

Instagram Reels Search

Les Reels Instagram sont des vidéos courtes publiques avec légendes, identité du créateur, médias, dates de publication, types de produit source et engagement visible. Ces signaux de contenu et de performance servent à suivre des sujets, à mener des recherches propres à une requête, à cartographier des créateurs et à comparer des contenus.

Fonctionnalités de la Instagram Reels Search API

  • Découverte de Reels par requête textuelleTrouvez des Reels publics pour une expression de recherche pertinente, sans partir d’un profil, d’un hashtag, d’un ID audio ou d’une URL de contenu connus.
  • Contrôle de la fenêtre de publicationLimitez la découverte à la dernière heure, au dernier jour, à la dernière semaine, au dernier mois ou à la dernière année lorsque la tâche exige une plage de récence définie.
  • Contenu et créateursRecevez dans une seule structure l’identité du Reel, les URL canoniques, les légendes, les informations sur l’auteur, les références de médias, les dates de publication et l’engagement visible.
  • Collecte bornée et dédoublonnéeRéglez chaque tâche de 20 à 2 000 enregistrements : des identifiants de Reel stables éliminent les doublons et chaque élément sauvegardé conserve la requête dont il provient.

Paramètres de la Instagram Reels Search API

ParamètresObligatoireDescription
queryObligatoireTexte obligatoire et non vide servant à rechercher parmi les Reels Instagram publics actuels.
results_limitFacultatifNombre maximal d’enregistrements demandés pour la requête ; 100 par défaut, entiers de 20 à 2 000 acceptés.
published_withinFacultatifFenêtre de publication facultative : hour, day, week, month ou year.

Comment utiliser la Instagram Reels Search API

Envoyez une recherche de Reels sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les enregistrements normalisés avec la pagination par curseur.

  1. Préparez une requête textuelle non vide et choisissez au besoin une fenêtre de publication ; réglez results_limit de 20 à 2 000.
  2. Envoyez query, avec les champs facultatifs results_limit et published_within, en POST à /v1/instagram/reels-search.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez data.results.items depuis /v1/tasks/{task_id}?limit=50 et suivez results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/instagram/reels-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$INSTAGRAM_REELS_QUERY\",\"results_limit\":20,\"published_within\":\"week\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

Cas d’usage de la Instagram Reels Search API

  • Jeux de Reels propres à une requête : Combinez ID de Reel, URL, légendes, médias, auteurs et extra.search_query en une collection traçable consacrée à un sujet.
  • Suivi de sujets récents : Utilisez une fenêtre de publication avec created_at et l’engagement visible pour passer en revue les Reels récemment remontés pour une requête récurrente.
  • Découverte de créateurs au sein d’un sujet : Servez-vous des ID d’auteurs, noms d’utilisateur, noms et avatars normalisés pour cartographier les créateurs présents dans l’ensemble de Reels correspondant.
  • Comparaison de formats de contenu : Comparez légendes, métadonnées de médias, types de produit source et indicateurs visibles entre les Reels renvoyés pour une même requête.

Conseils d’expert pour la Instagram Reels Search API

  • Utilisez une expression de requête ciblée et non vide de caractères blancs, afin que la tâche démarre avec un terme de recherche pertinent une fois l’entrée nettoyée de ses espaces.
  • Gardez query, published_within et results_limit constants pour comparer des exécutions récurrentes, car la surface de recherche publique actuelle peut évoluer.
  • Conservez extra.search_query et les ID de Reel stables lorsque vous joignez des pages de résultats ou plusieurs tâches, afin que la provenance de la requête et la déduplication restent explicites.
  • Traitez légendes, champs du créateur, médias, horodatages, types de produit et compteurs visibles comme nullables dans votre code en aval.

En complément de la Instagram Reels Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Instagram.

  • Instagram Search API — Recherchez des profils publics par mot-clé ou handle avec identité et signaux de compte visibles.
  • Instagram Comments API — Collectez les commentaires publics, auteurs, horodatages, mentions J’aime et réponses à partir d’URL de publications.
  • Instagram Hashtag Posts API — Découvrez des publications publiques par hashtag avec contexte du hashtag source, médias, créateurs, horodatages et engagement visible.
  • Instagram Transcript API — Extrayez le texte de transcription, la langue, le format, les URL sources et les shortcodes à partir d’URL de publications ou de Reels publics.
  • Instagram Post Info API — Consultez des URL connues de publications, de Reels ou d’anciens IGTV publics avec légendes, identité de l’auteur, médias, horodatages, engagement visible et contexte de la saisie.
  • Instagram Location Info API — Consultez un lieu à partir de son ID ou de l’URL de sa page, avec nom, catégorie, téléphone, coordonnées et nombre de publications identifiées.

Explorer d’autres plateformes

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

Instagram Reels Search API — FAQ

Instagram Reels Search API est une interface programmatique qui trouve des Reels Instagram publics à partir d’une requête textuelle envoyée. Elle renvoie l’identité normalisée du Reel, les légendes, les créateurs, les médias, les horodatages, l’engagement visible et le contexte de la requête.

query est obligatoire et doit contenir du texte autre que des espaces. results_limit accepte de 20 à 2 000 et vaut 100 par défaut ; published_within accepte hour, day, week, month ou year.

Un résultat peut contenir l’ID et l’URL du Reel, la légende, l’identité de l’auteur, les nombres de mentions J’aime, de commentaires, de vues et de lectures, les références de médias, created_at, collected_at, extra.search_query et le type de produit source.

results_limit est un maximum et non une garantie. L’ensemble de recherche public disponible peut changer d’une exécution à l’autre, et les Reels en double ayant le même identifiant stable sont supprimés au sein d’une tâche.

Chaque résultat normalisé sauvegardé coûte 0,5 crédit, sans frais de base par tâche. L’estimation initiale retient results_limit ou sa valeur par défaut de 100, tandis que l’utilisation finale suit les enregistrements réellement sauvegardés ; une tâche sans enregistrement sauvegardé n’entraîne aucun frais de résultat.