instagram/
reels-search

Busque Reels públicos de Instagram con una consulta de texto, con descripciones, creadores, medios, marcas de tiempo, interacción visible y contexto de la consulta en registros normalizados.

Instagram Reels Search API

Descubrimiento por consulta de texto
Registros de Reels
Ventana de publicación
0.5 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 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ámetrosObligatorioDescripción
queryObligatorioTexto obligatorio y no vacío que se usa para buscar en los Reels públicos de Instagram actuales.
results_limitOpcionalMáximo de registros solicitados para la consulta; el valor predeterminado es 100 y acepta enteros de 20 a 2,000.
published_withinOpcionalVentana 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.

  1. Prepare una consulta de texto no vacía y elija una ventana de publicación opcional; establezca results_limit de 20 a 2,000.
  2. Envíe query, con los campos opcionales results_limit y published_within, por POST a /v1/instagram/reels-search.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. 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.

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.

Explorar otras plataformas

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

Instagram Reels Search API — FAQ

Instagram Reels Search API es una interfaz programática para encontrar Reels públicos de Instagram a partir de una consulta de texto enviada. Devuelve identidad normalizada del Reel, descripciones, creadores, medios, marcas de tiempo, interacción visible y contexto de la consulta.

query es obligatorio y debe contener texto que no sea solo espacios en blanco. results_limit acepta de 20 a 2,000 y su valor predeterminado es 100; published_within acepta hour, day, week, month o year.

Un resultado puede contener el ID y la URL del Reel, la descripción, la identidad del autor, los conteos de Me gusta, comentarios, vistas y reproducciones, referencias de medios, created_at, collected_at, extra.search_query y el tipo de producto de origen.

results_limit es un máximo y no una garantía. El conjunto de búsqueda público disponible puede cambiar entre ejecuciones, y los Reels duplicados con el mismo identificador estable se eliminan dentro de una tarea.

Cada resultado normalizado guardado cuesta 0.5 créditos, sin cargo base por tarea. La estimación inicial usa results_limit o su valor predeterminado de 100, mientras que el uso final corresponde a los registros realmente guardados; una tarea sin registros guardados no tiene cargo por resultado.