> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a public Facebook page's photos > Fetches a public Facebook page's photos (from its `/photos` tab, logged-out). Returns the batch on the initial page load plus a `paging.cursor` / `paging.hasNextPage` for the next page. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/facebook/profile/photos openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: Google description: Google Search scraping endpoints paths: /v1/facebook/profile/photos: get: tags: - Facebook summary: Get a public Facebook page's photos description: >- Fetches a public Facebook page's photos (from its `/photos` tab, logged-out). Returns the batch on the initial page load plus a `paging.cursor` / `paging.hasNextPage` for the next page. parameters: - name: url in: query required: true description: Public Facebook page URL, e.g. https://www.facebook.com/Cristiano schema: type: string example: https://www.facebook.com/Cristiano - name: cursor in: query required: false description: >- The `paging.cursor` from a previous call, to fetch the next page. (Facebook uses a single pagination token — there is no separate next_page_id.) schema: type: string - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The page photos. content: application/json: schema: type: object properties: data: type: object properties: photos: type: array items: type: object photoCount: type: integer paging: type: object properties: cursor: type: string nullable: true hasNextPage: type: boolean fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: photos: - photoId: '1741207304032469' id: >- YXBwX2l0ZW06MTAwMDQ0Mjk2NDg2MzgyOjIzMDUyNzI3MzI6NTo6MTc0MTIwNzMwNDAzMjQ2OQ== url: >- https://www.facebook.com/photo.php?fbid=1741207304032469&set=pb.100044296486382.-2207520000&type=3 imageUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/808322075_18772642810056421_8186953556932778401_n.jpg?stp=dst-jpg_tt6&cstp=mx2457x3072&ctp=s2457x3072&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=kZJeAc46Ju4Q7kNvwHkk7HA&_nc_oc=Ado4KSTkr7MXa0mD2xkvqml5eaUgLaUe_QfyBReRtqnouq7mIq-upNVVNVyfJYm2x4Q&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=eF4oFo1cYPx3i9RqH5pSow&_nc_ss=7f289&oh=00_AQJXlVCqyHpFEUcoPcpdz8rwMgex2d3BpxATJpMmrguvvw&oe=6AADBA8E thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/808322075_18772642810056421_8186953556932778401_n.jpg?stp=c0.203.2457.2457a_dst-jpg_tt6&cstp=mx2457x2457&ctp=s552x414&_nc_cat=1&ccb=1-7&_nc_sid=714c7a&_nc_ohc=kZJeAc46Ju4Q7kNvwHkk7HA&_nc_oc=Ado4KSTkr7MXa0mD2xkvqml5eaUgLaUe_QfyBReRtqnouq7mIq-upNVVNVyfJYm2x4Q&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=eF4oFo1cYPx3i9RqH5pSow&_nc_ss=7f289&oh=00_AQIqlGdGfvB49EPg8uHAXBfBC1RhqEUW7DmNglj5xLLrNQ&oe=6AADBA8E caption: >- May be an image of ‎football, American football and ‎text that says "‎ALKHAIBARI 17 ANGELO ANGEL 2u TO وده AAL ญ MgiN GUE AGUI‎"‎‎ width: 2457 height: 3072 immersivePhotoEncodings: [] - photoId: '1739600907526442' id: >- YXBwX2l0ZW06MTAwMDQ0Mjk2NDg2MzgyOjIzMDUyNzI3MzI6NTo6MTczOTYwMDkwNzUyNjQ0Mg== url: >- https://www.facebook.com/photo.php?fbid=1739600907526442&set=pb.100044296486382.-2207520000&type=3 imageUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/804648218_1079705651317787_7129949489923928016_n.png?stp=dst-jpg_tt6&cstp=mx3111x3889&ctp=s3111x3889&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=3efddKgUtAsQ7kNvwFkuQQQ&_nc_oc=AdpBhM9TxZn0ZsSds9FlUgA5quf9eTm1H07hsn4Z-3XgCfscrdur7nef7SRMcQHHH5Q&_nc_zt=14&_nc_ht=scontent-los4-1.xx&_nc_gid=eF4oFo1cYPx3i9RqH5pSow&_nc_ss=7f289&oh=00_AQKHqH84VhCIezq-9wB3krur2dXFwnFBt9NmiDuFQMQFGA&oe=6AADAA71 thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/804648218_1079705651317787_7129949489923928016_n.png?stp=c0.257.3111.3111a_dst-jpg_tt6&cstp=mx3111x3111&ctp=s552x414&_nc_cat=1&ccb=1-7&_nc_sid=714c7a&_nc_ohc=3efddKgUtAsQ7kNvwFkuQQQ&_nc_oc=AdpBhM9TxZn0ZsSds9FlUgA5quf9eTm1H07hsn4Z-3XgCfscrdur7nef7SRMcQHHH5Q&_nc_zt=14&_nc_ht=scontent-los4-1.xx&_nc_gid=eF4oFo1cYPx3i9RqH5pSow&_nc_ss=7f289&oh=00_AQIV6-x79eD1P4pYEww7tphXenzdbKzVh7fXDfFy84d6hA&oe=6AADAA71 caption: May be an image of football, eyewear and text width: 3111 height: 3889 immersivePhotoEncodings: [] - photoId: '1738083467678186' id: >- YXBwX2l0ZW06MTAwMDQ0Mjk2NDg2MzgyOjIzMDUyNzI3MzI6NTo6MTczODA4MzQ2NzY3ODE4Ng== url: >- https://www.facebook.com/photo.php?fbid=1738083467678186&set=pb.100044296486382.-2207520000&type=3 imageUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/802307878_18771362611056421_7211335494025570908_n.jpg?stp=dst-jpg_tt6&cstp=mx3200x4000&ctp=s3200x4000&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=Q8raVkIDxa0Q7kNvwFbRanQ&_nc_oc=Ado4gwr_7tlKSzBwCEHLq-_ZExbG5M_P2iO-fFK-C0dnmTkCgfelCUATcuHNcPGkIDU&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=eF4oFo1cYPx3i9RqH5pSow&_nc_ss=7f289&oh=00_AQIr2rxnuxkIt_vvx3E_afvnCGdlo7lK9N-pvUi8KaqEpQ&oe=6AADAAD4 thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/802307878_18771362611056421_7211335494025570908_n.jpg?stp=c0.264.3200.3200a_dst-jpg_tt6&cstp=mx3200x3200&ctp=s552x414&_nc_cat=1&ccb=1-7&_nc_sid=714c7a&_nc_ohc=Q8raVkIDxa0Q7kNvwFbRanQ&_nc_oc=Ado4gwr_7tlKSzBwCEHLq-_ZExbG5M_P2iO-fFK-C0dnmTkCgfelCUATcuHNcPGkIDU&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=eF4oFo1cYPx3i9RqH5pSow&_nc_ss=7f289&oh=00_AQLTiVwYg2KwLiirLs6bthjJYOBC8PyOme7sBUXQ8lvi_g&oe=6AADAAD4 caption: May be an image of American football, football and text width: 3200 height: 4000 immersivePhotoEncodings: [] photoCount: 8 paging: cursor: >- AQHTRuloCPk8YvaD8BXzSXeixP5dpn7AxKgmHemmiF_CF0BHfj3Nu_1PP7RsOeiFZtFX740aS2BZwYee5wrVmFt2dA hasNextPage: true fetchedAt: '2026-09-14T12:13:31.061Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: Page not found / no public photos. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: Required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '502': description: Upstream block. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source was temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ````