instagram/
tagged-posts

Recopile las publicaciones públicas de Instagram que etiquetan perfiles seleccionados a partir de uno o más nombres de usuario, con descripciones, autores, medios, menciones e interacción visible.

Instagram Tagged Posts API

Etiquetas de perfil
Contexto de la publicación
Contenido público
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 Tagged Posts

Las publicaciones etiquetadas de Instagram son contenidos públicos que identifican a otro perfil mediante etiquetas a nivel de publicación y pueden incluir nombres de usuario mencionados, con descripciones, autores, medios, hashtags, marcas de tiempo e interacción visible. Estas señales de contenido y de relación sirven para monitorear etiquetas, revisar atribuciones, investigar creadores de contenido y mantener archivos de contenido estructurados.

Funcionalidades de la Instagram Tagged Posts API

  • Descubrimiento de etiquetas de perfilUse nombres de usuario públicos de Instagram como objetivos y obtenga las publicaciones que etiquetan esos perfiles, y no las publicaciones creadas por la cuenta objetivo.
  • Identidad de la publicación y del autorRecibe IDs de publicación, shortcodes, URL de las publicaciones, descripciones y campos normalizados del perfil del autor para obtener registros de contenido rastreables.
  • Contexto de usuarios etiquetados y mencionesConserva el contexto estructurado de tagged_users junto con los hashtags y las menciones devueltas, de modo que las distintas relaciones de la publicación sigan siendo distinguibles.
  • Medios e interacción visibleDevuelve referencias normalizadas de imagen o video con los conteos visibles de Me gusta, comentarios, vistas y reproducciones que se proporcionan para cada publicación pública.
  • Contexto de publicaciónIncluye la hora de publicación normalizada, la hora de recopilación y el contexto de product_type para la revisión cronológica y la clasificación del formato de la publicación.

Parámetros de la Instagram Tagged Posts API

ParámetrosObligatorioDescripción
usernamesObligatorioUno o más nombres de usuario de perfiles públicos de Instagram sin @, separados por comas o saltos de línea.
results_limitOpcionalCantidad máxima de registros de publicaciones etiquetadas que solicita la tarea; un entero de 1 a 2,000, con 100 como valor predeterminado.

Cómo usar la Instagram Tagged Posts API

Envíe nombres de usuario de los perfiles objetivo como una tarea asíncrona, consulte el ID de tarea devuelto y luego lea las publicaciones etiquetadas normalizadas con paginación por cursor.

  1. Prepare uno o más nombres de usuario públicos de Instagram sin el carácter @ inicial.
  2. Envíe usernames y un results_limit opcional de 1 a 2,000 por POST a /v1/instagram/tagged-posts.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. Lea /v1/tasks/{task_id}?limit=50 y pase results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/instagram/tagged-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

Casos de uso de la Instagram Tagged Posts API

  • Monitoreo de etiquetas de perfil: Use tagged_users, las URL de las publicaciones, las descripciones, los autores y las marcas de tiempo para revisar las publicaciones públicas que etiquetan perfiles seleccionados.
  • Revisión de la asociación con campañas: Compare descripciones, medios, contexto de usuarios etiquetados e interacción visible entre las publicaciones vinculadas a la etiqueta de perfil de una campaña.
  • Investigación de aportes de creadores: Use la identidad normalizada del autor y las relaciones de etiquetas de perfil para identificar a los creadores de contenido públicos que publican en torno a cuentas seleccionadas.
  • Archivo de contenido etiquetado: Almacene los IDs de publicación, los shortcodes, las URL devueltas, las referencias de medios, las horas de publicación y las horas de recopilación en registros de contenido revisables.

Consejos de expertos para la Instagram Tagged Posts API

  • Elimine la @ inicial de cada nombre de usuario objetivo antes de enviarlo, para que la solicitud use un identificador de perfil limpio.
  • Lea extra.tagged_users para las etiquetas de perfil a nivel de publicación y mentions para las cadenas de mención devueltas, en lugar de tratar ambos campos como intercambiables.
  • Elimine los duplicados de las recopilaciones repetidas con el ID de la publicación o el shortcode, y conserve la URL de la publicación devuelta para la revisión y la trazabilidad.
  • Admita que falten medios, contadores de interacción, indicadores del autor y marcas de tiempo, porque los registros públicos normalizados conservan los campos de origen que pueden ser nulos.
  • Continúe con results.next_cursor siempre que results.has_more sea true para que los conjuntos de resultados más grandes de publicaciones etiquetadas no se trunquen después de la primera página.

Además de la Instagram Tagged Posts 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 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 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.

Explorar otras plataformas

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

Instagram Tagged Posts API — FAQ

Instagram Tagged Posts API es una interfaz programática para recuperar las publicaciones públicas que etiquetan los perfiles identificados por uno o más nombres de usuario enviados. Devuelve identidad normalizada de la publicación y del autor, descripciones, medios, contexto de usuarios etiquetados, menciones, marcas de tiempo e interacción visible.

No. Este endpoint descubre las publicaciones que etiquetan al perfil objetivo; las menciones son campos que se devuelven con las publicaciones coincidentes cuando el resultado público los proporciona, y no una búsqueda independiente de publicaciones con menciones.

Envíe una lista usernames no vacía con nombres de usuario de perfiles públicos; el mapeo de entrada elimina una @ inicial. results_limit es opcional y acepta un entero de 1 a 2,000, con 100 como valor predeterminado.

extra.tagged_users conserva el contexto estructurado de las etiquetas de perfil devuelto para la publicación. mentions es una lista aparte de nombres de usuario devueltos como menciones en el registro de contenido normalizado.

Tagged Posts encuentra las publicaciones públicas que etiquetan perfiles seleccionados. Instagram Posts, en cambio, recopila las publicaciones creadas por los nombres de usuario enviados.

Los registros pueden incluir ID, shortcode, URL, descripción, identidad del autor, medios, hashtags, menciones, usuarios etiquetados, tipo de producto, horas de publicación y de recopilación, y los conteos visibles de Me gusta, comentarios, vistas o reproducciones.

Solo se pueden devolver las publicaciones coincidentes de acceso público. Los registros y campos eliminados, restringidos, privados, que requieren iniciar sesión o que el origen omite pueden producir resultados parciales o vacíos.

Lea hasta 500 resultados de la tarea por página y continúe con next_cursor mientras has_more sea true.

Los resultados normalizados exitosos cuestan 0.5 créditos por registro, sin cargo base. Un resultado vacío cuesta cero créditos según la política de solo cargo base.