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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL 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.
- Prepare una o más URL públicas de perfiles o páginas en facebook.com, www.facebook.com o m.facebook.com.
- Envíe urls por POST a /v1/facebook/profiles.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
- 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.
APIs relacionadas
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.