instagram/
search

Recherchez des profils Instagram publics par mot-clé ou identifiant, avec identité, biographies, images de profil, vérification, confidentialité et nombres de compte visibles, le tout normalisé.

Instagram Search API

Recherche de profils
Découverte
Données publiques
0,54 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 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ètresObligatoireDescription
queryObligatoireMot-clé, identifiant ou expression de recherche de profil.
results_limitFacultatifNombre 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.

  1. Préparez un mot-clé, un identifiant ou une expression de recherche de profil non vide.
  2. Envoyez query et, au besoin, results_limit en POST à /v1/instagram/search.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. 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.

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.

Explorer d’autres plateformes

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

Instagram Search API — FAQ

Instagram Search API trouve des profils Instagram publiquement visibles à partir d’un mot-clé ou d’un identifiant. Elle renvoie l’identité normalisée, les biographies, les images de profil, les signaux de vérification et de confidentialité ainsi que les nombres de compte visibles.

Le champ query recherche des profils publics par mot-clé, identifiant, nom ou expression propre au compte. Indiquez un identifiant précis si vous voulez un jeu de résultats plus étroit.

L’endpoint actuel ne recherche que des résultats d’utilisateurs et de profils publics. Il ne renvoie ni publications, ni Reels, ni stories, ni hashtags.

Les champs courants sont l’ID du profil, le nom d’utilisateur, le nom affiché, l’URL canonique, l’avatar, la biographie, la vérification, la confidentialité, les nombres visibles d’abonnés, d’abonnements et de publications, ainsi que la date de collecte.

results_limit fixe le nombre maximal d’enregistrements de profil demandés. C’est un plafond et non une garantie, car le classement de la recherche et la disponibilité publique peuvent produire moins de résultats.

Le classement de la recherche, les identifiants renommés, les profils privés ou supprimés et la disponibilité temporaire des résultats publics peuvent réduire ou modifier l’ensemble renvoyé. Essayez une requête plus précise et traitez les champs de profil facultatifs comme pouvant être nuls.

Utilisez le nom d’utilisateur renvoyé avec Instagram Posts, Reels ou Followers Count API lorsque vous avez besoin d’enregistrements de contenu publics ou d’indicateurs de nombres actualisés.