facebook/
profiles

Recopile los datos públicos de perfiles y páginas de Facebook a partir de URL conocidas, con identidad, nombres, biografías, avatares, contadores visibles y como máximo un registro normalizado por entrada.

Facebook Profiles API

Consulta de perfiles
Consulta de páginas
URL conocidas
1.2 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

Facebook Profiles

Los perfiles y las páginas de Facebook son superficies públicas de identidad, con nombres, texto de biografía o de información, avatares, enlaces canónicos y contadores visibles de audiencia o actividad. Estos campos de identidad y señales públicas sirven para enriquecer URL, relacionar entidades, tomar instantáneas de metadatos y hacer investigación comparativa.

Funcionalidades de la Facebook Profiles API

  • Consulta directa de URL conocidasEnvíe varias URL públicas de perfiles o páginas de Facebook y reciba como máximo un registro de perfil normalizado por cada entrada.
  • Campos de identidad normalizadosDevuelve el ID de Facebook, la URL canónica, el nombre visible, el tipo de registro y la URL de entrada original en una estructura uniforme.
  • Presentación pública del perfilCaptura la biografía pública, la introducción, la descripción o el texto de información, junto con el avatar disponible del perfil o la página.
  • Contadores visibles del perfilNormaliza los contadores públicos habituales de seguidores, seguidos, publicaciones, Me gusta, comentarios, vistas, reproducciones y veces compartido que expone el destino.

Parámetros de la Facebook Profiles API

ParámetrosObligatorioDescripción
urlsObligatorioURL obligatorias de perfiles o páginas públicos de Facebook. Los hosts aceptados son facebook.com, www.facebook.com y m.facebook.com; separe varios valores con comas o saltos de línea.

Cómo usar la Facebook Profiles API

Envíe URL de perfiles o páginas como una tarea asíncrona, consulte su ID de tarea y lea los registros de perfil normalizados.

  1. Prepare una o más URL públicas de perfiles o páginas en facebook.com, www.facebook.com o m.facebook.com.
  2. Envíe urls por POST a /v1/facebook/profiles.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
  4. Lea data.results.items desde /v1/tasks/{task_id}?limit=50 y siga results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/facebook/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"]}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.

Casos de uso de la Facebook Profiles API

  • Enriquecimiento de catálogos de perfiles y páginas: Agregue ID normalizados, nombres, enlaces canónicos, texto de biografía, avatares y contadores visibles a un catálogo de URL de Facebook conocidas.
  • Relación de identidades a partir de URL conocidas: Use los ID, las URL canónicas, los nombres y extra.input_url devueltos para conectar los enlaces enviados con los registros de entidades existentes.
  • Instantáneas de metadatos públicos: Almacene collected_at junto con el texto del perfil, el avatar y los contadores disponibles para comparar los metadatos públicos entre recopilaciones.

Consejos de expertos para la Facebook Profiles API

  • Verifique que cada URL apunte al perfil o a la página previstos, porque la validación de la solicitud comprueba el host de Facebook, pero no la ruta del recurso.
  • Conserve extra.input_url al conciliar una tarea con varias URL, ya que las entradas duplicadas o no disponibles pueden producir menos registros que URL enviadas.
  • Trate los nombres, el texto del perfil, los avatares y cada valor de métrica como valores que pueden ser nulos, porque los perfiles personales y las páginas exponen campos públicos distintos.
  • Use el endpoint de contenido de Facebook correspondiente cuando necesite publicaciones, fotos, Reels, eventos o reseñas, y no metadatos a nivel de perfil.

Además de la Facebook Profiles API, use estas APIs cuando necesite otro tipo de datos públicos de Facebook.

  • Facebook Pages API — Obtiene perfiles públicos de páginas de Facebook, datos de contacto, imágenes y calificaciones visibles de la audiencia.
  • Facebook Posts API — Recolecta publicaciones públicas, contenido multimedia, reacciones, comentarios y veces compartido desde URLs de Facebook compatibles.
  • Facebook Comments API — Recolecta comentarios públicos, autores, interacción, contenido multimedia y enlaces de origen desde URLs de publicaciones.
  • Facebook Profile Events API — Recolecta eventos públicos asociados a URLs de perfiles o páginas, con nombres, horarios, ubicaciones, contenido multimedia, métricas visibles y contexto de origen.
  • Facebook Profile Photos API — Recolecta fotos públicas desde URLs de perfiles o páginas con descripciones, contexto del autor, interacción, metadatos de imagen y referencias de origen.
  • Facebook Reels API — Recolecta Reels públicos desde URLs de perfiles o páginas con descripciones, contexto del autor, metadatos de video, interacción visible y referencias de origen.

Explorar otras plataformas

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

Facebook Profiles API — FAQ

Facebook Profiles API es una interfaz programática que recupera datos públicos de identidad de URL conocidas de perfiles o páginas de Facebook, lo que facilita enriquecer y relacionar registros. Sirve para enriquecer URL, relacionar entidades y tomar instantáneas de perfiles; cada entrada produce como máximo un registro público, y el endpoint no realiza búsquedas de perfiles por palabra clave.

Envíe URL no vacías de facebook.com, www.facebook.com o m.facebook.com. El validador comprueba el host, pero no si la ruta identifica un perfil o una página, por lo que este endpoint hace una consulta directa y no una búsqueda de perfiles.

Un registro normalizado contiene id, platform, resource, type, url, name, text, avatar_url, metrics, created_at, collected_at y extra.input_url. Por ahora, created_at se devuelve como null.

Sí, la consulta está pensada para URL públicas de perfiles o páginas. Sus campos visibles difieren, por lo que los clientes no deben suponer que todos los registros tienen la misma biografía, avatar o contadores.

Cada URL puede producir como máximo un registro, mientras que los destinos duplicados, privados, con acceso restringido por inicio de sesión, eliminados, mal escritos o no disponibles pueden no producir ninguno. Use extra.input_url para asociar los registros devueltos con la solicitud original.

El uso cuesta 1.2 créditos por cada registro de perfil guardado, sin cargo base por tarea. Un resultado vacío no genera cargo por resultado.