instagram/
profiles

Obtenga los perfiles públicos de Instagram de uno o más nombres de usuario, con identidad, biografías, enlaces, indicadores de cuenta y los conteos visibles de seguidores, seguidos y publicaciones, todo normalizado.

Instagram Profiles API

Búsqueda por nombre de usuario conocido
Metadatos de perfil
Instantáneas de cuenta
0.6 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 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ámetrosObligatorioDescripción
usernamesObligatorioLista 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.

  1. Prepare una lista usernames no vacía con las cuentas públicas que ya conoce.
  2. Envíe la lista usernames por POST a /v1/instagram/profiles y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que status sea succeeded o failed.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

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

Instagram Profiles API — FAQ

Instagram Profiles API es una interfaz programática que recupera un perfil público normalizado por cada nombre de usuario resoluble de la lista usernames obligatoria. Devuelve identidad, biografía y enlaces, indicadores de verificación y privacidad, categorías de cuenta y los conteos visibles de seguidores, seguidos y publicaciones.

Envíe una o más cadenas no vacías en usernames; los valores pueden incluir una @ inicial. No se aceptan URL de perfil, consultas por palabra clave, results_limit ni filtros de publicaciones.

Un registro puede incluir ID de cuenta, nombre de usuario, nombre visible, URL e imagen del perfil, biografía, enlaces externos y de la biografía, indicadores de verificación y privacidad, categoría, señales de cuenta comercial y profesional, conteos visibles y collected_at.

Una cuenta inexistente, renombrada, no disponible o inaccesible puede no producir registro, y la disponibilidad de la fuente pública puede dejar campos individuales vacíos. Otros nombres de usuario válidos de la misma tarea pueden devolver sus registros de perfil.

No. Busca registros de perfil de nombres de usuario que ya conoce; use Instagram Search para descubrir cuentas y los endpoints Followers o Following para los miembros de las relaciones.

Cada resultado de perfil normalizado devuelto cuesta 0.6 créditos; un nombre de usuario sin resolver que no produce resultado se rige por la política configurada para resultados vacíos.