> ## 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 reels > Fetches a public Facebook page's reels (from its `/reels` tab, logged-out). Each reel includes its video id, permalink, caption, publish time, dimensions, thumbnail, a direct MP4 url, author, audio/soundtrack, and engagement stats (exact reactions & comments; Facebook-abbreviated share & view labels). 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/reels 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/reels: get: tags: - Facebook summary: Get a public Facebook page's reels description: >- Fetches a public Facebook page's reels (from its `/reels` tab, logged-out). Each reel includes its video id, permalink, caption, publish time, dimensions, thumbnail, a direct MP4 url, author, audio/soundtrack, and engagement stats (exact reactions & comments; Facebook-abbreviated share & view labels). 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 reels. content: application/json: schema: type: object properties: data: type: object properties: reels: type: array items: type: object reelCount: 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: reels: - videoId: '1549207066583030' postId: '1693264105493456' storyId: UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzoxNTQ5MjA3MDY2NTgzMDMw url: https://www.facebook.com/reel/1549207066583030 caption: >- Greatness takes many forms 💪 Esports World Cup is live in Paris with over 2000 players putting in the work to be the champion. @ewc_en createdAt: '2026-07-21T13:55:43.000Z' createdTimestamp: 1784642143 durationSeconds: 84.28 width: 1918 height: 1080 thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-10/753225069_18753687136056421_3177299699481750751_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=s960x960&_nc_cat=110&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=Tkqde3NUX-cQ7kNvwEIzkiK&_nc_oc=AdqJe5mxn7sp_RxwuLhuChoZKWdMoLoprP_B-xS6ZxViDfRvJlXsnrbeNY7ao3Yt5SI&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=0oH0YLIO25RNmyefUV-dLw&_nc_ss=7f289&oh=00_AQIi1WbiPQrwmyqlzMF8NM5cx32x65AhQtS69OnT0BNBGQ&oe=6AADB5D9 videoUrl: >- https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQPJ1HokO3L-cfH7Rp1IpdhkhNnahtRm6Du01t1ApV1NvPPeTH4FsrhGBONIoOPu1qzYrz3TolBASuIgrH9Izpy8vVxzCV42vrmsEI1CIw.mp4?_nc_cat=104&_nc_sid=8bf8fe&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=5Ft1OGSrgSwQ7kNvwFaXhHX&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI3Ni5wcm9ncmVzc2l2ZV9oMjY0LWJhc2ljLWdlbjJfNzIwcCIsInhwdl9hc3NldF9pZCI6MTUwMjgwMzIzMTYxNzA5OCwiYXNzZXRfYWdlX2RheXMiOjU0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6ODQsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=0oH0YLIO25RNmyefUV-dLw&_nc_ss=7f289&_nc_zt=28&oh=00_AQLGe9HwKwAGLzGthNxjtjDGojcjH84QtQb7p0s8L3H2NQ&oe=6AADBB0A&bitrate=1407402&tag=progressive_h264-basic-gen2_720p author: id: '100044296486382' name: Cristiano Ronaldo url: https://www.facebook.com/Cristiano isVerified: true avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/724056214_1657518462401354_1550185043079196898_n.jpg?stp=c0.54.1366.1366a_cp0_dst-jpg_tt6&cstp=mx1366x1366&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=a09PUl88X00Q7kNvwEHaN8A&_nc_oc=AdqCwiKuyFwo8qCPHlkHJuT-1etkgxJrgdYUmIioZ6KwOW1zQDDrIB8GfoV3i5ngppQ&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=0oH0YLIO25RNmyefUV-dLw&_nc_ss=7f289&oh=00_AQJf904kh9cfhoJIRVOWFeAeo_HAWFIHdBoX2CbMrQ_dGA&oe=6AADC560 audio: trackTitle: Cristiano Ronaldo · Original audio isOriginalAudio: true soundtrackId: '27127875796913092' stats: reactions: 909058 comments: 25168 sharesLabel: 5.4K viewsLabel: 11M feedbackId: ZmVlZGJhY2s6MTY5MzI2NDEwNTQ5MzQ1Ng== - videoId: '3536781926495651' postId: '1676592763827257' storyId: UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzozNTM2NzgxOTI2NDk1NjUx url: https://www.facebook.com/reel/3536781926495651 caption: Toronto ❤️ createdAt: '2026-07-03T10:19:07.000Z' createdTimestamp: 1783073947 durationSeconds: 46.333 width: 1080 height: 1920 thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-10/731058572_18747860116056421_8724303327878739257_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=s960x960&_nc_cat=108&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=nxkGkQz5ctQQ7kNvwG23nwU&_nc_oc=AdrNKEsu7jRiqSLqHOYRwH_Gwnpalt_FMFeiidxa5TLS4siC9phYDdAGXO_MxmCBC8Y&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=0oH0YLIO25RNmyefUV-dLw&_nc_ss=7f289&oh=00_AQLsvXOrTDf6KmedbO0LTUXqpy-QJV_6Bz6VcvjhzAzDxA&oe=6AAD9DE9 videoUrl: >- https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQO-uwD8zTWdMh66XhAY1vZwrnpixVp9CHN3rXY5ASkoZqf0CambWltI8D3ou-GhuupBQZ2CMiyls7USbK1qYoACClRRmYs6lrwH4DlnjA.mp4?_nc_cat=103&_nc_sid=8bf8fe&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=CV7j9Okxwh8Q7kNvwEVACt5&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxMjIwMTAzNzEzNTExMjI0LCJhc3NldF9hZ2VfZGF5cyI6NzMsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjo0NiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=0oH0YLIO25RNmyefUV-dLw&_nc_ss=7f289&_nc_zt=28&oh=00_AQJHzs5n8s-BwkRgNdEELOJ-qFXzppre3zAbbIhe_awc4A&oe=6AADC55B&bitrate=1222558&tag=progressive_h264-basic-gen2_720p author: id: '100044296486382' name: Cristiano Ronaldo url: https://www.facebook.com/Cristiano isVerified: true avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/724056214_1657518462401354_1550185043079196898_n.jpg?stp=c0.54.1366.1366a_cp0_dst-jpg_tt6&cstp=mx1366x1366&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=a09PUl88X00Q7kNvwEHaN8A&_nc_oc=AdqCwiKuyFwo8qCPHlkHJuT-1etkgxJrgdYUmIioZ6KwOW1zQDDrIB8GfoV3i5ngppQ&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=0oH0YLIO25RNmyefUV-dLw&_nc_ss=7f289&oh=00_AQJf904kh9cfhoJIRVOWFeAeo_HAWFIHdBoX2CbMrQ_dGA&oe=6AADC560 audio: trackTitle: Cristiano Ronaldo · Original audio isOriginalAudio: true soundtrackId: '27667503352938519' stats: reactions: 4734676 comments: 87040 sharesLabel: 44K viewsLabel: 54M feedbackId: ZmVlZGJhY2s6MTY3NjU5Mjc2MzgyNzI1Nw== - videoId: '3316958438485267' postId: '1648599723293228' storyId: UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzozMzE2OTU4NDM4NDg1MjY3 url: https://www.facebook.com/reel/3316958438485267 caption: null createdAt: '2026-06-05T19:26:50.000Z' createdTimestamp: 1780687610 durationSeconds: 80 width: 1080 height: 1920 thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t51.71878-10/714444336_941839992222041_4405133798222772830_n.jpg?stp=dst-jpg_tt6&cstp=mx640x1136&ctp=s960x960&_nc_cat=111&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=u0LDsHo3SmQQ7kNvwFd1iuk&_nc_oc=AdoR0qzd_iSz-TfMJxYYDqNR6MTkHpSIRr5ROwsobaoFFgee1L7hjnw80JL6pOCT-KE&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=0oH0YLIO25RNmyefUV-dLw&_nc_ss=7f289&oh=00_AQLACBcfsNI0moIvTEE0iR4jpqOnSA1SZPzyayJmqsvPuw&oe=6AADBEB1 videoUrl: >- https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQOvgS2n18KyBhAdpKJzzmf5lObwXTcGZwX_8l5xh8L5hkGJUi-TwRM-5KuJ9NCs-vhJGkRrcD8-AyJ6aRCHs-9XUhw-tuTNLIIqnj0.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=jW1L8__uobIQ7kNvwG5z-yo&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc4MDc1Njc5OTk2NTY3NiwiYXNzZXRfYWdlX2RheXMiOjEwMCwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjgwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=52e7e42631134bdd&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNjRBQUM0QTYwOEVEQUE0M0M5NTRBQzE1MEQ1MkNCQ192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzRBNEQ5NjEwMUYyRUIzNjI4Q0I1MDFEN0FBMjMyMTg1X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbYp_KH2OWpBhUCKAJDMywXQFQAAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdQJl5p0BAA&_nc_gid=0oH0YLIO25RNmyefUV-dLw&_nc_ss=7f289&_nc_zt=28&oh=00_AQLK0zMn_yG8HVrzjvbgdGt2k5t9Sjjn20HbR9eeJHLQQA&oe=6AA9BD2A&bitrate=982304&tag=dash_baseline_1_v1 author: id: '100044296486382' name: Cristiano Ronaldo url: https://www.facebook.com/Cristiano isVerified: true avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/724056214_1657518462401354_1550185043079196898_n.jpg?stp=c0.54.1366.1366a_cp0_dst-jpg_tt6&cstp=mx1366x1366&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=a09PUl88X00Q7kNvwEHaN8A&_nc_oc=AdqCwiKuyFwo8qCPHlkHJuT-1etkgxJrgdYUmIioZ6KwOW1zQDDrIB8GfoV3i5ngppQ&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=0oH0YLIO25RNmyefUV-dLw&_nc_ss=7f289&oh=00_AQJf904kh9cfhoJIRVOWFeAeo_HAWFIHdBoX2CbMrQ_dGA&oe=6AADC560 audio: trackTitle: Cristiano Ronaldo · Original audio isOriginalAudio: true soundtrackId: '27281705694793039' stats: reactions: 1482602 comments: 18309 sharesLabel: 7.3K viewsLabel: 17M feedbackId: ZmVlZGJhY2s6MTY0ODU5OTcyMzI5MzIyOA== reelCount: 10 paging: cursor: >- AQHTUQrM2BH2vlehstnBx-XqoaTQKhZSCy7sqyZjNz8Ckax3xYFNy5Z584sdkVPT2j7nk2TremsLkJRqxR8vtYHr2g hasNextPage: true fetchedAt: '2026-09-14T12:13:41.159Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '400': description: Invalid or expired cursor. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: BAD_REQUEST message: The request was invalid. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '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 reels. 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. ````