facebook/
profile-photos

Recopile las fotos públicas de perfiles y páginas de Facebook a partir de una o más URL, con descripciones, contexto del autor, interacción, metadatos de imagen y enlaces de origen en registros normalizados.

Facebook Profile Photos API

Fotos de perfil
Metadatos de imagen
Datos públicos
0.5 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 Profile Photos

Las fotos de perfil de Facebook son imágenes públicas asociadas con el feed de un perfil o una página, con descripciones, contexto del autor, interacción visible, dimensiones y enlaces de origen. Estos registros sirven para inventariar medios, investigar contenido visual y monitorear perfiles concretos.

Funcionalidades de la Facebook Profile Photos API

  • Feeds de fotos de varios perfilesRecopile registros de fotos públicas de una o más URL de perfiles o páginas de Facebook, con el límite solicitado aplicado por separado a cada entrada.
  • Metadatos de imagen normalizadosDevuelve las URL de las imágenes, las miniaturas y los metadatos de ancho, alto y duración, junto con los ID de las fotos y los enlaces canónicos.
  • Contexto de la foto y del origenConserva las descripciones, los datos públicos del autor, la interacción visible, las marcas de tiempo y extra.input_url para el análisis y la atribución de la fuente.
  • Recorrido del feed por cursorSigue los cursores del feed público de fotos y elimina los registros duplicados por ID estable, URL o identidad de la imagen antes de llegar al límite por entrada.

Parámetros de la Facebook Profile Photos API

ParámetrosObligatorioDescripción
urlsObligatorioURL de perfiles o páginas públicos de Facebook, separadas por comas o saltos de línea.
results_limitOpcionalNúmero máximo de fotos por recopilar para cada URL de entrada, de 20 a 2,000; el valor predeterminado es 100.

Cómo usar la Facebook Profile Photos API

Envíe URL de perfiles o páginas públicos como una tarea asíncrona, consulte su ID de tarea y lea los registros de fotos normalizados mediante paginación por cursor de resultados.

  1. Prepare una o más URL de perfiles o páginas públicos de Facebook.
  2. Envíe urls, con un results_limit opcional, por POST a /v1/facebook/profile-photos.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
  4. Lea /v1/tasks/{task_id}?limit=50 y pase results.next_cursor cuando existan más fotos guardadas.
curl -X POST "https://api.socq.ai/v1/facebook/profile-photos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'

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

Casos de uso de la Facebook Profile Photos API

  • Inventario de medios públicos: Organice los ID de las fotos, los enlaces canónicos, las URL de las imágenes, las dimensiones, las descripciones y las entradas de origen en un índice de recursos de un perfil concreto.
  • Investigación de contenido visual: Compare las descripciones, los metadatos de imagen, las marcas de tiempo y la interacción visible para estudiar los patrones de publicación de fotos públicas.
  • Monitoreo de fotos de perfil: Repita las recopilaciones de URL de perfiles o páginas seleccionados y use la identidad de la foto junto con extra.input_url para detectar registros recién expuestos.

Consejos de expertos para la Facebook Profile Photos API

  • Use URL de perfiles y páginas de facebook.com, www.facebook.com o m.facebook.com que expongan un feed público de fotos; la validación del host por sí sola no garantiza que el recurso de destino sea el adecuado.
  • Defina results_limit teniendo en cuenta el número de URL de entrada, porque el límite de 20 a 2,000 se aplica de forma independiente a cada URL.
  • Al combinar ejecuciones, deduplique por id de la foto, URL o identidad de la imagen junto con extra.input_url para conservar el perfil de origen correcto.
  • Trate las descripciones, los campos del autor, las métricas, las marcas de tiempo y las dimensiones de los medios como opcionales, y verifique que media contenga una URL de imagen antes de mostrarla o descargarla.

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

  • Facebook Posts API — Recolecta publicaciones públicas, contenido multimedia, reacciones, comentarios y veces compartido desde URLs de Facebook compatibles.
  • Facebook Video Transcript API — Extrae el texto de transcripción disponible y su formato desde URLs conocidas de videos o Reels públicos.
  • Facebook Group Posts API — Recolecta publicaciones públicas desde URLs de grupos de Facebook con orden seleccionable, límites por grupo, contexto del autor, videos e interacción visible.
  • Facebook Ad Transcript API — Extrae el texto hablado disponible, el idioma, el formato y el contexto de origen desde URLs de la Facebook Ad Library.
  • Facebook Profiles API — Consulta perfiles o páginas públicos a partir de URLs conocidas de Facebook con identidad, biografía, avatar, contadores visibles y contexto de la entrada.
  • 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 Profile Photos API — FAQ

Facebook Profile Photos API es una interfaz programática que organiza el feed público de fotos de un perfil o una página de Facebook específicos en registros de medios uniformes, lo que simplifica el inventario masivo y el seguimiento continuo. Esos registros sirven para investigar contenido visual y monitorear perfiles, con una cobertura limitada al contenido accesible a través del feed público de fotos del destino.

Use perfiles o páginas públicos en facebook.com, www.facebook.com o m.facebook.com. La validación comprueba el host, por lo que un recurso de Facebook distinto aún puede no devolver ningún feed de fotos.

Un registro puede incluir el ID de la foto, la URL canónica, el texto de la descripción, el contexto público del autor sin procesar, las métricas visibles, las URL y dimensiones de los medios, created_at, collected_at y extra.input_url.

Defina results_limit de 20 a 2,000; el valor predeterminado es 100. El límite se aplica por separado a cada URL enviada, y un feed puede terminar antes de alcanzarlo.

No se devuelven las fotos privadas, restringidas, eliminadas, que requieren iniciar sesión o que no estén disponibles de otro modo. No se garantizan la estructura de álbumes, los comentarios, las personas etiquetadas, el desglose completo de reacciones ni la descarga de los archivos originales.

Cada registro de foto guardado cuesta 0.5 créditos, sin cargo base por tarea. Las estimaciones multiplican el límite de resultados por URL por el número de URL enviadas.