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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave, nombre de usuario o frase de perfil que se busca. |
results_limit | Opcional | Cantidad 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.
- Prepare una palabra clave, un nombre de usuario o una frase de búsqueda de perfil no vacíos.
- Envíe query y un results_limit opcional por POST a /v1/instagram/search.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- 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.
APIs relacionadas
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.
- 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