Facebook Profile Photos
Facebook Profile Photos are public images attached to a profile or Page feed, with captions, author context, visible engagement, dimensions, and source links. These records support media inventories, visual-content research, and profile-specific monitoring.
Features
- Multi-profile photo feedsCollect public photo records from one or more Facebook profile or Page URLs, with the requested limit applied separately to each input.
- Normalized image metadataReturn image URLs, thumbnails, width, height, and duration metadata together with photo IDs and canonical links.
- Photo and source contextPreserve captions, public author data, visible engagement, timestamps, and extra.input_url for analysis and source attribution.
- Cursor-based feed traversalFollow public photo-feed cursors and remove duplicate records by stable ID, URL, or image identity before reaching the per-input limit.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Public Facebook profile or Page URLs, separated by commas or new lines. |
results_limit | Optional | Maximum photos to collect per input URL, from 20 to 2,000; the default is 100. |
How to Use
Submit public profile or Page URLs as an asynchronous task, poll its task ID, then read normalized photo records through result cursor pagination.
- Prepare one or more public Facebook profile or Page URLs.
- POST urls with an optional results_limit to /v1/facebook/profile-photos.
- Poll /v1/tasks/{task_id} until the status is succeeded.
- Read /v1/tasks/{task_id}?limit=50 and pass results.next_cursor when more saved photos exist.
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.Best Use Cases
- Public media inventory: Organize photo IDs, canonical links, image URLs, dimensions, captions, and source inputs into a profile-specific asset index.
- Visual-content research: Compare captions, image metadata, timestamps, and visible engagement to study public photo publishing patterns.
- Profile photo monitoring: Repeat collections for selected profile or Page URLs and use photo identity plus extra.input_url to detect newly exposed records.
Pro Tips
- Use facebook.com, www.facebook.com, or m.facebook.com profile and Page URLs that expose a public photo feed; host validation alone does not guarantee the target resource is appropriate.
- Set results_limit with the number of input URLs in mind because the 20 to 2,000 limit is applied independently to every URL.
- When combining runs, deduplicate by photo id, URL, or image identity together with extra.input_url to preserve the correct source profile.
- Treat captions, author fields, metrics, timestamps, and media dimensions as optional, and verify that media contains an image URL before rendering or downloading it.
Related APIs
Use these APIs when you need a different type of public Facebook data.
- Facebook Pages API — Retrieve public Page profiles, contact details, images, and visible audience ratings.
- Facebook Posts API — Collect public posts, media, reactions, comments, and shares from supported Facebook URLs.
- Facebook Comments API — Collect public comments, authors, engagement, media, and source links from post URLs.
- Facebook Video Transcript API — Extract available transcript text and format from known public video post or Reel URLs.
- Facebook Group Posts API — Collect public posts from Facebook group URLs with selectable ordering, per-group limits, author context, video media, and visible engagement.
- Facebook Events Search API — Search public events by keyword with schedule, place, attendance, cover media, and event-state fields.
- Facebook Ad Transcript API — Extract available spoken-word text, language, format, and source context from Facebook Ad Library URLs.
- Facebook Comment Replies API — Retrieve public replies for a known comment using its feedback ID and expansion token, with text, author identity, engagement, and parent context.
- Facebook Company Reviews API — Collect public Page reviews with review text, reviewer links, ratings, likes, timestamps, and company context.
- Facebook Event Details API — Collect normalized metadata, schedules, locations, media, and visible engagement from known public event URLs.
- Facebook Profile Events API — Collect public events associated with profile or Page URLs, including names, schedules, locations, media, visible metrics, and source context.
- Facebook Profiles API — Look up public profiles or Pages from known Facebook URLs with identity, bio, avatar, visible counters, and input context.
- Facebook Reels API — Collect public Reels from profile or Page URLs with captions, author context, video metadata, visible engagement, and source references.
Combine Facebook data with public data from other supported social platforms.