Instagram Search
Les résultats de recherche Instagram sont des profils publics associés à un nom, un mot-clé ou un thème, avec leurs noms d’utilisateur, biographies, images de profil et signaux de vérification, de confidentialité et de compte visibles. Ces enregistrements alimentent la découverte de créateurs, l’étude de marques, le tri d’audiences et l’enrichissement de profils.
Fonctionnalités de la Instagram Search API
- Recherche de profils par mot-cléRecherchez des profils Instagram publics à partir d’un mot-clé, d’un identifiant, d’un nom ou d’une expression propre au compte.
- Identité et nombres du profilRenvoie pour chaque profil trouvé le nom d’utilisateur, le nom affiché, la biographie, l’URL du profil, l’avatar, la vérification, la confidentialité et les champs de nombres visibles.
- Schéma de profil cohérentGarde la même structure de profil normalisée, que la recherche porte sur un mot-clé large, un nom ou un identifiant exact.
- Plafond de résultats demandéFixez avec results_limit le nombre maximal d’enregistrements de profil demandés pour une recherche.
- Limite aux données publiquesLes données de profils privés, restreints, supprimés ou réservés aux comptes connectés restent en dehors de la réponse.
Paramètres de la Instagram Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé, identifiant ou expression de recherche de profil. |
results_limit | Facultatif | Nombre maximal d’enregistrements que la tâche de collecte doit demander. Doit être un entier positif. |
Comment utiliser la Instagram Search API
Envoyez une recherche de profils sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les profils normalisés grâce à la pagination par curseur.
- Préparez un mot-clé, un identifiant ou une expression de recherche de profil non vide.
- Envoyez query et, au besoin, results_limit en POST à /v1/instagram/search.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- Lisez /v1/tasks/{task_id}?limit=50 et suivez results.next_cursor tant qu’il reste des profils.
curl -X POST "https://api.socq.ai/v1/instagram/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"sustainable travel","results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Cas d’usage de la Instagram Search API
- Repérage de créateurs : Trouvez les profils publics liés à un mot-clé, un identifiant, une catégorie ou une expression de campagne avant d’aller plus loin dans l’enrichissement.
- Enrichissement de comptes : Récupérez l’identité, la biographie, la vérification, la confidentialité et les nombres visibles des profils retenus parmi les résultats.
- Veille sur les marques : Identifiez les profils publics de marques et d’organisations liés à un nom, à une catégorie de produits ou à une expression de marché.
- Annuaires de recherche : Constituez des listes consultables de profils Instagram publics pour la recherche, la qualification de prospects ou l’analyse interne.
- Sélection de profils : Choisissez les profils pertinents, puis appelez les API de publications, de Reels ou de nombre d’abonnés pour obtenir des enregistrements publics plus détaillés.
Conseils d’expert pour la Instagram Search API
- Considérez les réponses 429 comme des signaux de saturation normaux dans les recherches : appliquez un repli progressif et réduisez la taille des fenêtres de résultats au lieu de réessayer agressivement.
- Conservez les ID de tâche, ID de profil stables, noms d’utilisateur et URL canoniques pour pouvoir rejouer et auditer vos recherches.
- Utilisez la recherche pour découvrir des profils, puis appelez les API de publications, de Reels ou de nombre d’abonnés quand votre workflow exige des enregistrements plus détaillés.
- Excluez de vos hypothèses d’intégration les données privées, réservées aux comptes connectés ou propres au titulaire d’un compte, sauf si la documentation publiée de l’API les prend explicitement en charge.
- Nettoyez les termes de recherche saisis par les utilisateurs avant de les faire passer dans un pipeline de production.
API associées
En complément de la Instagram Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Instagram.
- Instagram Posts API — Collectez les publications publiques, médias, hashtags, mentions, horodatages et l’engagement par nom d’utilisateur.
- Instagram Reels API — Collectez par nom d’utilisateur les Reels publics, médias, audio, hashtags, mentions et l’engagement.
- Instagram Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, liens, indicateurs de compte, catégories et nombres visibles.
- 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 Reels Search API — Recherchez des Reels publics par requête textuelle avec légendes, créateurs, médias, horodatages, engagement visible et contexte de la requête.
- 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 Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info 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