Instagram Following List
Los registros de Instagram Following List representan los perfiles públicos que sigue un nombre de usuario de origen, con identidad normalizada, URL de perfil, señales de visibilidad y contexto de la relación. Las recopilaciones repetidas permiten crear instantáneas de relaciones, mientras que collected_at, source_username y position conservan cuándo y dónde se observó cada registro.
Funcionalidades de la Instagram Following List API
- Nombres de usuario de origen por lotesEnvíe uno o más nombres de usuario públicos de Instagram en una sola tarea, sin el carácter @ inicial.
- Procedencia de la relaciónConserva source_username, relationship y position en extra para poder rastrear cada perfil hasta su cuenta de origen.
- Identidad de perfil normalizadaRecibe el ID de perfil, nombre de usuario, nombre visible, URL canónica del perfil, avatar y las señales públicas de verificación o privacidad cuando están disponibles.
- Métricas visibles de la cuentaUse los conteos de seguidores, seguidos y publicaciones devueltos cuando esos valores públicos estén presentes en el registro recopilado.
- Paginación asíncrona de resultadosEnvíe el trabajo de recopilación fuera del hilo de la solicitud, consulte el estado de la tarea y recorra los resultados normalizados con next_cursor.
Parámetros de la Instagram Following List API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Uno o más nombres de usuario públicos de Instagram sin @, separados por comas o saltos de línea. |
results_limit | Opcional | Cantidad máxima de perfiles seguidos solicitados por nombre de usuario de origen; un entero de 1 a 2,000, con 100 como valor predeterminado. |
Cómo usar la Instagram Following List API
Envíe nombres de usuario públicos como una tarea asíncrona, consulte el ID de tarea devuelto y luego lea los perfiles seguidos normalizados 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/following-list.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea /v1/tasks/{task_id}?limit=50 y continúe con results.next_cursor cuando has_more sea true.
curl -X POST "https://api.socq.ai/v1/instagram/following-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram"],"results_limit":100}'
# 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 Following List API
- Mapeo de redes de creadores: Construya mapas revisables de qué creadores de contenido, medios y organizaciones públicos siguen las cuentas seleccionadas.
- Investigación de cuentas de marca: Compare las relaciones de seguidos visibles entre cuentas de marca, de campaña, regionales o de competidores.
- Descubrimiento de alianzas: Identifique los perfiles públicos que aparecen en las listas de seguidos de cuentas relevantes para un programa de alianzas.
- Enriquecimiento de directorios de perfiles: Agregue URL canónicas, nombres visibles, avatares, señales de cuenta y procedencia de la relación a los directorios internos.
- Seguimiento de cambios en las relaciones: Almacene instantáneas con marca de tiempo y compare los IDs de perfil estables entre ejecuciones para revisar altas y bajas.
Consejos de expertos para la Instagram Following List API
- Elimine la @ inicial de cada nombre de usuario antes de enviarlo; la entrada del proveedor se normaliza a nombres de usuario simples.
- Comience con un results_limit acotado y auméntelo solo cuando el flujo de trabajo necesite un conjunto de relaciones visibles más grande.
- Guarde el ID de perfil junto con extra.source_username, porque el mismo perfil seguido puede aparecer para varias cuentas de origen.
- Considere normal la variabilidad de los resultados públicos cuando falten avatares, métricas de la cuenta, señales de verificación o posiciones.
- Prevea resultados vacíos o parciales, porque las relaciones privadas, restringidas, eliminadas o que requieren iniciar sesión quedan fuera del límite admitido.
APIs relacionadas
Además de la Instagram Following List API, use estas APIs cuando necesite otro tipo de datos públicos de Instagram.
- Instagram Followers Count API — Obtiene la identidad del perfil público y los conteos visibles de seguidores, seguidos y publicaciones.
- Instagram Posts API — Recolecta publicaciones públicas, contenido multimedia, hashtags, menciones, marcas de tiempo e interacción por nombre de usuario.
- 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 Followers List API — Recolecta registros de perfiles públicos de seguidores, con contexto de la cuenta de origen y de la relación.
- Instagram Similar Accounts API — Lista las cuentas que Instagram sugiere como similares a un nombre de usuario, con nombres de usuario, nombres, avatares y estado de verificación.
- Instagram Post Likers API — Lista las cuentas de la lista visible de quienes dieron Me gusta a una publicación a partir de su URL, con nombres de usuario, nombres, avatares y estado de verificación.
- Instagram Reels API
- Instagram Search API
- Instagram Comments API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Comment Replies API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API