Instagram Profiles
Los perfiles de Instagram son páginas de cuenta públicas con nombres de usuario, nombres visibles, biografías, imágenes de perfil, enlaces externos, categorías de cuenta, señales de verificación y privacidad, y los conteos visibles de seguidores, seguidos y publicaciones. Estas señales de identidad, clasificación y audiencia sirven para enriquecer perfiles, comparar cuentas, mantener directorios y monitorear el estado de una cuenta en un momento dado.
Funcionalidades de la Instagram Profiles API
- Búsqueda por nombre de usuario conocidoResuelve uno o más nombres de usuario públicos proporcionados y emite como máximo un registro de perfil normalizado por cada cuenta encontrada.
- Identidad y enlaces del perfilDevuelve el ID de la cuenta, el nombre de usuario, el nombre visible, la URL canónica del perfil, la imagen de perfil, la biografía, la URL externa y los enlaces públicos de la biografía.
- Clasificación y estado de la cuentaConserva el estado visible de verificación y privacidad junto con las señales públicas de categoría, cuenta comercial y cuenta profesional.
- Conteos visibles del perfilAgrupa los conteos de seguidores, seguidos y publicaciones en metrics y marca el registro normalizado con la fecha y hora de collected_at.
Parámetros de la Instagram Profiles API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Lista obligatoria y no vacía de nombres de usuario públicos de Instagram. Se acepta una @ inicial y se elimina antes de la búsqueda. |
Cómo usar la Instagram Profiles API
Envíe nombres de usuario conocidos como una tarea asíncrona, consulte su ID de tarea y lea los registros de perfil públicos resueltos con paginación por cursor.
- Prepare una lista usernames no vacía con las cuentas públicas que ya conoce.
- Envíe la lista usernames por POST a /v1/instagram/profiles y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que status sea succeeded o failed.
- Tras el éxito, lea data.results.items y pase results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/instagram/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram","@natgeo"]}'
# Poll GET /v1/tasks/{task_id}?limit=50
# Read data.results.items and continue with results.next_cursor while results.has_more is trueCasos de uso de la Instagram Profiles API
- Enriquecimiento de cuentas conocidas: Agregue IDs estables, nombres visibles, biografías, imágenes de perfil, URL canónicas y enlaces públicos a registros que ya contienen nombres de usuario de Instagram.
- Comparación de cuentas seleccionadas: Compare la verificación visible, la categoría, las señales de tipo de cuenta y los conteos de seguidores, seguidos y publicaciones en un grupo definido de nombres de usuario.
- Monitoreo de instantáneas de perfil: Almacene collected_at junto con los conteos visibles de la cuenta de recopilaciones repetidas para comparar registros de perfil en momentos concretos.
Consejos de expertos para la Instagram Profiles API
- Envíe nombres de usuario y no URL de perfil ni frases de búsqueda, porque este endpoint solo acepta la lista usernames.
- Elimine las @ iniciales y deduplique los nombres resultantes antes del envío para que name y @name no generen búsquedas separadas.
- Concilie los nombres de usuario devueltos con la lista de entrada, porque una cuenta no disponible, renombrada o inaccesible puede no producir ningún registro de perfil.
- Conserve los conteos y los indicadores de cuenta ausentes como valores desconocidos en lugar de convertirlos en cero o false.
- Guarde collected_at junto a metrics al comparar instantáneas repetidas de un perfil.
APIs relacionadas
Además de la Instagram Profiles 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 Reels API — Recolecta Reels públicos, contenido multimedia, audio, hashtags, menciones e interacción por nombre de usuario.
- 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 Following List API — Recolecta los perfiles públicos seguidos por cuentas de Instagram, con identidad, contexto de la relación y conteos visibles de la cuenta.
- Instagram Account Age Checker API — Consulta cuándo se unió una cuenta a Instagram, el país donde está ubicada, cuándo se verificó y cuántas veces cambió su nombre de usuario.
- 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 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