Facebook Photos API
Fetch recent photos posted by any public Facebook page or profile (image URLs, captions, and dimensions) as normalized JSON.
$1.20/1k req, pay per request, no subscription.
{"id": "6019283746501928","photoId": "6019283746501928","caption": "Final buzzer at the AT&T Center, the crowd on its feet","url": "https://www.facebook.com/photo/?fbid=6019283746501928","thumbnail": "https://scontent.xx.fbcdn.net/v/t39.30808-6/spurs_photo_a_thumb.jpg","imageUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-6/spurs_photo_a.jpg","imageWidth": 2048,"imageHeight": 1365}
Pricing and providers
Facebook Photos API pricing: one API, 2 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get Facebook photos in one request
This sample shows 13 of 14 fields. See every field
{
"found": true,
"data": {
"nextCursor": "AbYq2_photos_cursor_02",
"nextPageId": "108374920184756",
"photos": [
{
"id": "6019283746501928",
"photoId": "6019283746501928",
"caption": "Final buzzer at the AT&T Center, the crowd on its feet",
"url": "https://www.facebook.com/photo/?fbid=6019283746501928",
"thumbnail": "https://scontent.xx.fbcdn.net/v/t39.30808-6/spurs_photo_a_thumb.jpg",
"imageUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-6/spurs_photo_a.jpg",
"imageWidth": 2048,
"imageHeight": 1365
},
{
"id": "6019283746501929",
"photoId": "6019283746501929",
"caption": "Warmups before tip-off, players in silver and black",
"url": "https://www.facebook.com/photo/?fbid=6019283746501929",
"thumbnail": "https://scontent.xx.fbcdn.net/v/t39.30808-6/spurs_photo_b_thumb.jpg",
"imageUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-6/spurs_photo_b.jpg",
"imageWidth": 2048,
"imageHeight": 1365
}
]
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- urlstring
https://www.facebook.com/Spurs
URL of the public Facebook page or profile to fetch photos from (e.g. https://www.facebook.com/Spurs).
- cursorstring
Pagination cursor from a previous response to fetch the next page.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `imageWidth`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a photo that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Response
JSON, one example value per field.
- nextCursorstring
AbYq2_photos_cursor_02
Opaque cursor for the next page of photos, or null when this lane has no more. Pass it back as cursor to continue.
- nextPageIdstringcan require
108374920184756
Facebook's own id for the next page of photos. Null when the serving source does not report it; pass nextCursor back as cursor to continue either way.
Populated whenever the provider has data for the entity.
- captionstring
Final buzzer at the AT&T Center, the crowd on its feet
Populated whenever the provider has data for the entity.
- idstring
6019283746501928
Populated whenever the provider has data for the entity.
- imageHeightintegercan require
1365
Height of imageUrl in pixels. Null when the serving source does not report it.
- imageUrlstring
https://scontent.xx.fbcdn.net/v/t39.30808-6/spurs_photo_a.jpg
Populated whenever the provider has data for the entity.
- imageWidthintegercan require
2048
Width of imageUrl in pixels. Null when the serving source does not report it.
- photoIdstring
6019283746501928
Populated whenever the provider has data for the entity.
- thumbnailstring
https://scontent.xx.fbcdn.net/v/t39.30808-6/spurs_photo_a_thumb.jpg
Populated whenever the provider has data for the entity.
- urlstring
https://www.facebook.com/photo/?fbid=6019283746501928
Populated whenever the provider has data for the entity.
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Facebook Photos API
The AnyAPI Facebook Photos API returns Facebook photos data as normalized JSON from one POST call to /v1/run/facebook.photos. Fetch recent photos posted by any public Facebook page or profile (image URLs, captions, and dimensions) as normalized JSON. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 99.7% of Facebook photos calls through AnyAPI succeeded, with a median response time of 1.3 seconds across 316 measured calls.
