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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Texte obligatoire et non vide servant à rechercher parmi les Reels Instagram publics actuels. |
results_limit | Facultatif | Nombre maximal d’enregistrements demandés pour la requête ; 100 par défaut, entiers de 20 à 2 000 acceptés. |
published_within | Facultatif | Fenê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.
- 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.
- Envoyez query, avec les champs facultatifs results_limit et published_within, en POST à /v1/instagram/reels-search.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- 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.
API associées
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.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API