Instagram Reels Search
Los Reels de Instagram son videos cortos públicos con descripciones, identidad del creador, medios, horas de publicación, tipos de producto de origen e interacción visible. Estas señales de contenido y rendimiento sirven para monitorear temas, investigar consultas específicas, mapear creadores de contenido y hacer revisiones comparativas.
Funcionalidades de la Instagram Reels Search API
- Descubrimiento de Reels por consulta de textoEncuentre Reels públicos a partir de una frase de búsqueda significativa, sin partir de un perfil, un hashtag, un ID de audio o una URL de contenido conocidos.
- Control de la ventana de publicaciónRestringe el descubrimiento a la última hora, día, semana, mes o año cuando la tarea necesita un rango de actualidad definido.
- Registros de contenido y creadoresRecibe la identidad del Reel, URL canónicas, descripciones, datos del autor, referencias de medios, horas de publicación e interacción visible en una sola estructura.
- Recopilación acotada y sin duplicadosConfigure cada tarea de 20 a 2,000 registros; los identificadores estables de Reel eliminan duplicados y cada elemento guardado conserva la consulta de la que proviene.
Parámetros de la Instagram Reels Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Texto obligatorio y no vacío que se usa para buscar en los Reels públicos de Instagram actuales. |
results_limit | Opcional | Máximo de registros solicitados para la consulta; el valor predeterminado es 100 y acepta enteros de 20 a 2,000. |
published_within | Opcional | Ventana de publicación opcional: hour, day, week, month o year. |
Cómo usar la Instagram Reels Search API
Envíe una búsqueda de Reels como una tarea asíncrona, consulte su ID de tarea y luego lea los registros normalizados con paginación por cursor.
- Prepare una consulta de texto no vacía y elija una ventana de publicación opcional; establezca results_limit de 20 a 2,000.
- Envíe query, con los campos opcionales results_limit y published_within, por POST a /v1/instagram/reels-search.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea data.results.items desde /v1/tasks/{task_id}?limit=50 y siga results.next_cursor mientras results.has_more sea 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.Casos de uso de la Instagram Reels Search API
- Conjuntos de datos de Reels por consulta: Combine IDs de Reel, URL, descripciones, medios, autores y extra.search_query en una colección rastreable para un tema.
- Monitoreo de temas recientes: Use una ventana de publicación junto con created_at y la interacción visible para revisar los Reels aparecidos recientemente para una consulta recurrente.
- Descubrimiento de creadores dentro de un tema: Use los IDs de autor, nombres de usuario, nombres y avatares normalizados para mapear a los creadores de contenido representados en el conjunto de Reels coincidentes.
- Comparación de formatos de contenido: Compare descripciones, metadatos de medios, tipos de producto de origen y métricas visibles entre los Reels devueltos para la misma consulta.
Consejos de expertos para la Instagram Reels Search API
- Use una frase de consulta concreta y que no esté en blanco, de modo que la tarea parta de un término de búsqueda significativo tras recortar la entrada.
- Mantenga query, published_within y results_limit constantes al comparar ejecuciones recurrentes, porque la superficie de búsqueda pública actual puede cambiar.
- Conserve extra.search_query y los IDs de Reel estables al unir páginas de resultados o varias tareas, para que la procedencia de la consulta y la eliminación de duplicados sigan siendo explícitas.
- Trate las descripciones, los campos del creador, los medios, las marcas de tiempo, los tipos de producto y los contadores visibles como valores que pueden ser nulos en el código posterior.
APIs relacionadas
Además de la Instagram Reels Search API, use estas APIs cuando necesite otro tipo de datos públicos de Instagram.
- Instagram Search API — Busca perfiles públicos por palabra clave o identificador, con identidad y señales visibles de la cuenta.
- Instagram Comments API — Recolecta comentarios públicos, autores, marcas de tiempo, Me gusta y respuestas desde URLs de publicaciones.
- 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 Transcript API — Extrae el texto de la transcripción, el idioma, el formato, las URLs de origen y los shortcodes desde URLs de publicaciones o Reels públicos.
- Instagram Post Info API — Consulta URLs conocidas de publicaciones, Reels o IGTV antiguos públicos, con descripciones, identidad del autor, contenido multimedia, marcas de tiempo, interacción visible y contexto de la entrada.
- 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 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