instagram/
hashtag-posts

Recopile las publicaciones públicas de Instagram de uno o más hashtags, con datos del autor, descripciones, medios, hashtags de origen, marcas de tiempo y métricas de interacción visibles.

Instagram Hashtag Posts API

Descubrimiento por hashtag
Registros de publicaciones
Filtros de tiempo y medios
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 Hashtag Posts

Las publicaciones por hashtag de Instagram son fotos o Reels públicos asociados a un hashtag buscado, con descripciones, identidad del creador, medios, marcas de tiempo e interacción visible. Estas señales de contenido y procedencia sirven para descubrir temas, comparar entre hashtags, investigar creadores de contenido y monitorear periodos acotados.

Funcionalidades de la Instagram Hashtag Posts API

  • Recopilación de varios hashtagsEnvíe uno o más hashtags con o sin #, y results_limit se aplica por separado a cada hashtag enviado.
  • Filtros de tiempo y mediosLimite el descubrimiento a la última hora, día, semana, mes o año, y elija todas las publicaciones o solo Reels.
  • Registros de publicaciones normalizadosRecibe IDs de publicación, shortcodes, URL canónicas, descripciones, datos del autor, referencias de medios, hashtags, menciones y marcas de tiempo en una sola estructura.
  • Contexto de origen e interacciónConserva el hashtag enviado que produjo cada registro junto con los conteos disponibles de Me gusta, comentarios, vistas y reproducciones.

Parámetros de la Instagram Hashtag Posts API

ParámetrosObligatorioDescripción
hashtagsObligatorioUno o más hashtags no vacíos, con o sin #, separados por comas o saltos de línea.
results_limitOpcionalMáximo de registros solicitados por hashtag; el valor predeterminado es 100 y acepta enteros de 10 a 2,000.
published_withinOpcionalVentana de publicación opcional: hour, day, week, month o year.
media_typeOpcionalFiltro de contenido; all incluye los tipos de publicación admitidos y reels limita los resultados a Reels.

Cómo usar la Instagram Hashtag Posts API

Envíe hashtags como una tarea asíncrona, consulte su ID de tarea y luego lea los registros de publicaciones normalizados con paginación por cursor.

  1. Prepare uno o más hashtags únicos, con o sin # inicial.
  2. Envíe hashtags y los campos opcionales results_limit, published_within y media_type por POST a /v1/instagram/hashtag-posts.
  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 mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/instagram/hashtag-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["travel","photography"],"results_limit":20,"published_within":"week","media_type":"all"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Instagram Hashtag Posts API

  • Descubrimiento de contenido por tema: Cree conjuntos de datos revisables de publicaciones públicas asociadas a hashtags de campañas, eventos, comunidades o sectores.
  • Comparación entre hashtags: Compare la interacción visible y los patrones de contenido conservando el hashtag enviado que produjo cada registro.
  • Monitoreo de Reels recientes: Combine una ventana de publicación con el filtro de solo Reels para revisar contenido corto y actual en torno a hashtags seleccionados.
  • Enriquecimiento de creadores y contenido: Una la identidad de la publicación, el contexto del autor, las descripciones, los medios y las métricas visibles con registros de investigación, campañas o moderación.

Consejos de expertos para la Instagram Hashtag Posts API

  • Elimine los hashtags duplicados de la entrada y use una sola grafía por tema; el recopilador procesa cada valor enviado de forma independiente.
  • Planifique el volumen por hashtag, porque results_limit se aplica a cada hashtag y no a la solicitud en conjunto.
  • Use published_within y media_type juntos cuando un monitoreo recurrente necesite un rango de tiempo y un tipo de contenido consistentes.
  • Elimine los resultados superpuestos con IDs de publicación estables, shortcodes o URL canónicas, y conserve extra.hashtag para la procedencia.
  • Trate los medios, contadores, marcas de tiempo y demás campos públicos como opcionales, porque la disponibilidad en el origen puede variar según la publicación.

Además de la Instagram Hashtag Posts 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 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 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 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 Hashtag Search API — Encuentra hashtags que coinciden con una palabra clave, con nombres de hashtag, IDs, URLs de las páginas de cada hashtag y cantidad de publicaciones públicas.

Explorar otras plataformas

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

Instagram Hashtag Posts API — FAQ

Instagram Hashtag Posts API es una interfaz programática para recuperar las publicaciones públicas de Instagram asociadas a uno o más hashtags enviados. Devuelve identidad normalizada de la publicación, descripciones, autores, medios, marcas de tiempo, contexto del hashtag de origen y métricas de interacción visibles.

Envíe una lista hashtags no vacía; los valores pueden incluir u omitir el # inicial. results_limit acepta de 10 a 2,000, su valor predeterminado es 100 y se aplica por separado a cada hashtag.

published_within acepta hour, day, week, month o year. media_type acepta all o reels, y se usa all cuando se omite el campo.

Un resultado normalizado puede incluir ID, shortcode, URL, descripción, autor, medios, hashtags, menciones, created_at, collected_at, los conteos visibles de Me gusta, comentarios, vistas y reproducciones, además de extra.hashtag para la entrada coincidente.

Se cobran 0.5 créditos por cada registro normalizado devuelto, sin cargo base. Las estimaciones multiplican el results_limit por hashtag por la cantidad de hashtags enviados; el uso final corresponde a los registros realmente devueltos.