instagram/
search

Busque perfiles públicos de Instagram por palabra clave o nombre de usuario, con identidad normalizada, biografías, imágenes de perfil, verificación, privacidad y los conteos visibles de la cuenta.

Instagram Search API

Búsqueda de perfiles
Descubrimiento
Datos públicos
0.54 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Instagram Search

Los resultados de Instagram Search son perfiles públicos que coinciden con un nombre, una palabra clave o un tema, con nombres de usuario, biografías, imágenes de perfil, verificación, privacidad y señales visibles de la cuenta. Estos registros sirven para descubrir creadores de contenido, investigar marcas, filtrar audiencias y enriquecer perfiles.

Funcionalidades de la Instagram Search API

  • Búsqueda de perfiles por palabra claveBusque perfiles públicos de Instagram por palabra clave, nombre de usuario, nombre o frase de la cuenta.
  • Identidad y conteos del perfilDevuelve el nombre de usuario, nombre visible, biografía, URL del perfil, avatar, verificación, privacidad y campos de conteo visibles de cada perfil resultante.
  • Esquema de perfil uniformeDevuelve la misma estructura de perfil normalizada para palabras clave amplias, nombres y búsquedas de nombre de usuario exacto.
  • Tope de resultados solicitadosUse results_limit para fijar el máximo de registros de perfil solicitados en una búsqueda.
  • Límite de datos públicosMantiene fuera de la respuesta los datos de perfiles privados, restringidos, eliminados o que requieren iniciar sesión.

Parámetros de la Instagram Search API

ParámetrosObligatorioDescripción
queryObligatorioPalabra clave, nombre de usuario o frase de perfil que se busca.
results_limitOpcionalCantidad máxima de registros que debe solicitar la tarea de recopilación. Debe ser un entero positivo.

Cómo usar la Instagram Search API

Envíe una consulta de búsqueda de perfiles como una tarea asíncrona, consulte su ID de tarea y luego lea los resultados de perfil normalizados con paginación por cursor.

  1. Prepare una palabra clave, un nombre de usuario o una frase de búsqueda de perfil no vacíos.
  2. Envíe query y un results_limit opcional por POST a /v1/instagram/search.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. Lea /v1/tasks/{task_id}?limit=50 y siga results.next_cursor cuando haya más perfiles.
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.

Casos de uso de la Instagram Search API

  • Descubrimiento de creadores: Encuentre perfiles públicos relacionados con una palabra clave, un nombre de usuario, una categoría o una frase de campaña antes de un enriquecimiento más profundo.
  • Enriquecimiento de cuentas: Resuelva la identidad, la biografía, la verificación, la privacidad y los campos de conteo visibles de perfiles públicos de los resultados de búsqueda seleccionados.
  • Descubrimiento de marcas: Encuentre perfiles públicos de marcas y organizaciones relacionados con un nombre, una categoría de producto o una frase de mercado.
  • Directorios de investigación: Cree listas revisables de perfiles públicos de Instagram para investigación, calificación de contactos o análisis interno.
  • Flujos de selección de perfiles: Elija los perfiles relevantes y luego llame a Posts API, Reels API o Followers Count API para obtener registros públicos más detallados.

Consejos de expertos para la Instagram Search API

  • Trate las respuestas 429 como señales normales de presión en los flujos de búsqueda; use retroceso y ventanas de resultados más pequeñas en lugar de reintentar de forma agresiva.
  • Guarde los IDs de tarea, los IDs de perfil estables, los nombres de usuario y las URL canónicas para poder repetir y auditar las búsquedas.
  • Use los resultados de búsqueda para descubrir perfiles y luego llame a Posts API, Reels API o Followers Count API cuando su flujo de trabajo necesite registros más detallados.
  • No incluya en los supuestos de la integración datos privados, que requieren iniciar sesión o que pertenecen a la cuenta, salvo que la documentación publicada de la API los admita de forma explícita.
  • Sanee los términos de búsqueda proporcionados por los usuarios antes de enviarlos a cualquier pipeline de producción.

Además de la Instagram Search API, use estas APIs cuando necesite otro tipo de datos públicos de Instagram.

  • Instagram Posts API — Recolecta publicaciones públicas, contenido multimedia, hashtags, menciones, marcas de tiempo e interacción por nombre de usuario.
  • Instagram Reels API — Recolecta Reels públicos, contenido multimedia, audio, hashtags, menciones e interacción por nombre de usuario.
  • Instagram Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, enlaces, indicadores de cuenta, categorías y conteos visibles.
  • Instagram Hashtag Posts API — Descubre publicaciones públicas por hashtag, con contexto del hashtag de origen, contenido multimedia, creadores, marcas de tiempo e interacción visible.
  • Instagram Reels Search API — Busca Reels públicos por consulta de texto, con descripciones, creadores, contenido multimedia, marcas de tiempo, interacción visible y contexto de la consulta.
  • Instagram Location Info API — Consulta una ubicación por ID o por la URL de su página, con nombre, categoría, teléfono, coordenadas y cantidad de publicaciones etiquetadas.

Explorar otras plataformas

Combine los datos de Instagram con datos públicos de otras plataformas sociales compatibles.

Instagram Search API — FAQ

Instagram Search API encuentra perfiles de Instagram visibles públicamente a partir de una palabra clave o un nombre de usuario. Devuelve identidad normalizada, biografías, imágenes de perfil, señales de verificación y privacidad, y los conteos visibles de la cuenta.

query busca resultados de perfiles públicos por palabra clave, nombre de usuario, nombre o frase de la cuenta. Use un nombre de usuario específico cuando quiera un conjunto de resultados más acotado.

El endpoint actual busca solo resultados de usuarios y perfiles públicos. No devuelve registros de publicaciones, Reels, historias ni hashtags.

Los campos habituales incluyen el ID de perfil, el nombre de usuario, el nombre visible, la URL canónica, el avatar, la biografía, la verificación, la privacidad, los conteos visibles de seguidores, seguidos y publicaciones, y la hora de recopilación.

results_limit fija el máximo de registros de perfil solicitados. Es un tope y no una garantía, porque la clasificación de la búsqueda y la disponibilidad pública pueden producir menos resultados.

La clasificación de la búsqueda, los nombres de usuario modificados, los perfiles privados o eliminados y la disponibilidad temporal de los resultados públicos pueden reducir o cambiar el conjunto devuelto. Pruebe con una consulta más específica y trate los campos opcionales del perfil como valores que pueden ser nulos.

Use el nombre de usuario devuelto con Instagram Posts API, Reels API o Followers Count API cuando necesite registros de contenido público o métricas de conteo actualizadas.