Instagram Posts
Las publicaciones de Instagram son contenidos del feed con descripciones, contexto del autor, imágenes o videos, marcas de tiempo, hashtags, menciones e interacción visible. Estas señales de contenido sirven para investigar creadores de contenido, revisar campañas, analizar medios y elaborar informes históricos.
Funcionalidades de la Instagram Posts API
- Recopilación de publicaciones por nombre de usuarioRecopile las publicaciones públicas de Instagram de uno o más nombres de usuario con una única estructura de respuesta normalizada.
- Referencias y dimensiones de los mediosDevuelve las referencias públicas de medios y miniaturas, las dimensiones y la duración del video en campos de medios normalizados.
- Registros de fotos y videosNormaliza las publicaciones públicas de fotos y videos en la misma estructura de respuesta.
- Campos de contenido e interacciónIncluye el texto de la descripción, la identidad del autor, la hora de publicación, las métricas visibles, los hashtags y las menciones en cada registro de publicación.
- Límite de datos públicosMantiene fuera de la respuesta el contenido privado, eliminado, restringido o que requiere iniciar sesión.
Parámetros de la Instagram Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Nombres de usuario públicos de Instagram sin @, separados por comas o saltos de línea. |
results_limit | Opcional | Cantidad máxima de registros que debe solicitar la tarea de recopilación. Debe ser un entero positivo. |
Cómo usar la Instagram Posts API
Envíe nombres de usuario públicos como una tarea asíncrona, consulte su ID de tarea y luego lea los registros de publicaciones normalizados con paginación por cursor.
- Prepare uno o más nombres de usuario públicos de Instagram sin @.
- Envíe usernames y un results_limit opcional por POST a /v1/instagram/posts.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea /v1/tasks/{task_id}?limit=50 y siga results.next_cursor cuando haya más registros.
curl -X POST "https://api.socq.ai/v1/instagram/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["natgeo"],"results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Casos de uso de la Instagram Posts API
- Recopilación de publicaciones de perfiles: Recopile las publicaciones públicas de nombres de usuario de Instagram seleccionados en registros normalizados, con referencias de medios e identificadores estables.
- Investigación de contenido: Recopile descripciones, marcas de tiempo, hashtags y contadores de interacción visibles de publicaciones públicas para los equipos de investigación o analítica.
- Flujos de archivo: Almacene los metadatos de publicaciones públicas, las referencias de medios, el contexto del autor, las URL de origen y las horas de recopilación para colas de revisión, sistemas de informes o registros internos.
- Control de calidad de campañas: Revise las publicaciones públicas devueltas para nombres de usuario de creadores o marcas antes de unir los registros seleccionados con los datos de la campaña.
- Enriquecimiento del contenido de perfiles: Una los IDs de publicación, los datos del autor, las descripciones, las referencias de medios y las métricas visibles con registros existentes de perfiles o campañas.
Consejos de expertos para la Instagram Posts API
- Envíe los nombres de usuario sin el prefijo @ y mantenga los lotes pequeños mientras valida un flujo de trabajo nuevo.
- Prevea que algunos registros públicos omitan referencias de medios, contadores o marcas de tiempo, según la disponibilidad en el origen.
- Aplique reintentos conservadores con retroceso ante respuestas 429, de desafío o de bloqueo temporal, en lugar de reintentar de forma agresiva.
- Use Reels API para recopilar los Reels de un perfil, Search API para el descubrimiento y Comments API cuando importen los hilos de comentarios públicos.
- Evite diseñar flujos de trabajo en torno a cuentas privadas, historias, historias destacadas o campos que requieren iniciar sesión.
APIs relacionadas
Además de la Instagram Posts API, use estas APIs cuando necesite otro tipo de datos públicos de Instagram.
- 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 Tagged Posts API — Recolecta publicaciones públicas que etiquetan a los perfiles seleccionados, con autores, contenido multimedia, menciones, contexto de los usuarios etiquetados e interacción.
- 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