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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL de perfiles o páginas públicos de Facebook, separadas por comas o saltos de línea. |
results_limit | Opcional | Nú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.
- Prepare una o más URL de perfiles o páginas públicos de Facebook.
- Envíe urls, con un results_limit opcional, por POST a /v1/facebook/profile-photos.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
- 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.
APIs relacionadas
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.