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ámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Uno o más nombres de usuario de perfiles públicos de Instagram sin @, separados por comas o saltos de línea. |
results_limit | Opcional | Cantidad 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.
- Prepare uno o más nombres de usuario públicos de Instagram sin el carácter @ inicial.
- Envíe usernames y un results_limit opcional de 1 a 2,000 por POST a /v1/instagram/tagged-posts.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- 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_cursorCasos 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.
APIs relacionadas
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.
- Instagram Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search 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 Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API