> ## 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 post or reel by URL > Fetches a public Facebook post or reel (logged-out) and returns its text, author, media (video/thumbnail), engagement stats, and timestamp. Accepts share, reel, permalink, /posts/, and /videos/ URLs. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/facebook/post 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/post: get: tags: - Facebook summary: Get a public Facebook post or reel by URL description: >- Fetches a public Facebook post or reel (logged-out) and returns its text, author, media (video/thumbnail), engagement stats, and timestamp. Accepts share, reel, permalink, /posts/, and /videos/ URLs. parameters: - name: url in: query required: true description: Public Facebook post or reel URL. schema: type: string example: https://www.facebook.com/reel/1058174846575046 - 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 post/reel. content: application/json: schema: type: object properties: data: type: object properties: post: type: object nullable: true fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: post: id: '1058174846575046' postId: '1037614172517424' url: >- https://www.facebook.com/100088065513660/videos/bltv-she-is-coming/1058174846575046/ kind: reel text: '#bltv she is coming' author: name: Beautiful loveth TV id: '100088065513660' url: >- https://www.facebook.com/people/Beautiful-loveth-TV/100088065513660/ avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/424585004_352374554374726_2380182907750720076_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx960x960&ctp=s80x80&_nc_cat=103&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=YWRlOjDzvSkQ7kNvwFpObTv&_nc_oc=AdoRxamiPllMyq93NsGWOcSOvo1mflZMegeMDfEUBbFHLZc80sLkfGw9P_sszasF0gU&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=XktuNMRr5DC8q3UjiV2k2Q&_nc_ss=7f289&oh=00_AQLOfbAJ-sDmooR1GAEGLAkAi_KCS4AIwGU_DEzZ_wHTkA&oe=6AADD0F3 verified: false media: type: video videoId: '1058174846575046' videoUrl: >- https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQMhueuWuQYfhe2SsSOoJ0yQdP45hgqpTczGF1EZ7RKFvW0UQaJKu0UP1ONFwDsw5mPh2y2ZCaeT0haDcnY4wrlDBeANnb739_JrfAXD1w5PbA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=1zEG5DGu_NcQ7kNvwEed-9j&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjIxNjg4MTYxOTcxMDA3NzEsImFzc2V0X2FnZV9kYXlzIjo0NSwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=5cbf6c144f3b0ddc&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC80NDQ3MzdBODUxMDhEMkVEODAzMzg5NzZGMDZGMDlCRl9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0RBNDlEN0QzRTIyNTY5NjVDOTU0MTc5QkNDMkE1MEE0X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbGk5fw26HaBxUCKAJDMywXQEXd0vGp--cYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=XktuNMRr5DC8q3UjiV2k2Q&_nc_ss=7f289&_nc_zt=28&oh=00_AQLJRzcuMPWzDvZzi4NtUvbAoNSFailc_X9McU1QQ830VQ&oe=6AAD9EA2&bitrate=1195798&tag=dash_h264-basic-gen2_720p videoHdUrl: >- https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQMhueuWuQYfhe2SsSOoJ0yQdP45hgqpTczGF1EZ7RKFvW0UQaJKu0UP1ONFwDsw5mPh2y2ZCaeT0haDcnY4wrlDBeANnb739_JrfAXD1w5PbA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=1zEG5DGu_NcQ7kNvwEed-9j&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjIxNjg4MTYxOTcxMDA3NzEsImFzc2V0X2FnZV9kYXlzIjo0NSwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=5cbf6c144f3b0ddc&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC80NDQ3MzdBODUxMDhEMkVEODAzMzg5NzZGMDZGMDlCRl9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0RBNDlEN0QzRTIyNTY5NjVDOTU0MTc5QkNDMkE1MEE0X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbGk5fw26HaBxUCKAJDMywXQEXd0vGp--cYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=XktuNMRr5DC8q3UjiV2k2Q&_nc_ss=7f289&_nc_zt=28&oh=00_AQLJRzcuMPWzDvZzi4NtUvbAoNSFailc_X9McU1QQ830VQ&oe=6AAD9EA2&bitrate=1195798&tag=dash_h264-basic-gen2_720p videoSdUrl: >- https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQOFqZ9wd36PuUFXb7EofKYVbrehl1XuN2OuwAVqWRMUqFdissjZ45nZadysKUcZIzWHl92OzCa-BnKPA7S7F2p-z5kjRjOD4K0RsLtF6w.mp4?_nc_cat=111&_nc_sid=8bf8fe&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=jGvF-OMQALMQ7kNvwE1PAFb&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MjE2ODgxNjE5NzEwMDc3MSwiYXNzZXRfYWdlX2RheXMiOjQ1LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6NDMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=XktuNMRr5DC8q3UjiV2k2Q&_nc_ss=7f289&_nc_zt=28&oh=00_AQJZIAD-mR9ivNUJI4jmKd5qwehh3owtXcVWA3jmyYe6qA&oe=6AADB27F&bitrate=297485&tag=sve_sd thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t15.5256-10/761113616_1058174873241710_4338206855944057211_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=596eb7&_nc_ohc=KxT2q3pEPpoQ7kNvwFYhme1&_nc_oc=AdpBjOHVZ49xQ7JPnUnqndczCD5qFcyUT1I2lzXCz3fAIRDFZVdtsV6teLupgJ8lCtM&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=UtGxMcPEbmdNq78tb6tlGQ&_nc_ss=7f289&oh=00_AQKlfnCq-gAW-Apm6O35mlOSUj5jzVy_vOSG3YzrsUumiA&oe=6AADAF63 width: 1080 height: 1920 durationSeconds: 43.745 images: - >- https://scontent-los4-1.xx.fbcdn.net/v/t15.5256-10/761113616_1058174873241710_4338206855944057211_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=596eb7&_nc_ohc=KxT2q3pEPpoQ7kNvwFYhme1&_nc_oc=AdpBjOHVZ49xQ7JPnUnqndczCD5qFcyUT1I2lzXCz3fAIRDFZVdtsV6teLupgJ8lCtM&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=UtGxMcPEbmdNq78tb6tlGQ&_nc_ss=7f289&oh=00_AQKlfnCq-gAW-Apm6O35mlOSUj5jzVy_vOSG3YzrsUumiA&oe=6AADAF63 music: null link: null stats: reactions: 19161 reactionsByType: [] comments: 282 shares: 263 views: null viewsLabel: 1.8M views comments: [] feedbackId: ZmVlZGJhY2s6MTAzNzYxNDE3MjUxNzQyNA== createdAtMs: 1785481347000 createdAt: '2026-07-31T07:02:27.000Z' fetchedAt: '2026-09-14T12:13:29.244Z' 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: Content not found / private / deleted. 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. ````