> ## 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.
# Post
> Fetches a public Facebook post or reel and returns its text, author, media (video/thumbnail), engagement stats, and timestamp. Accepts share, reel, permalink, /posts/, and /videos/ URLs.
**Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free.
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
```text Prompt
I want to make an API call to /v1/facebook/post. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/facebook/post
Description: Fetches a public Facebook post or reel and returns its text, author, media (video/thumbnail), engagement stats, and timestamp. Accepts share, reel, permalink, /posts/, and /videos/ URLs.
Required Headers:
- x-api-key: Your API key
Parameters:
- url (string) [required]: Public Facebook post or reel URL.
- cache_max_age (select): 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.
Example Response:
{
"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…",
"verified": false
},
"media": {
"type": "video",
"videoId": "1058174846575046",
"videoUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQMhueuWuQYfhe2SsSOoJ0yQdP45hgqpTczGF1EZ7RKFvW0UQaJKu0UP1ONFwDsw5mPh2y2ZCaeT0haDcnY4wrlDBeANnb739_JrfAXD1w5PbA…",
"videoHdUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQMhueuWuQYfhe2SsSOoJ0yQdP45hgqpTczGF1EZ7RKFvW0UQaJKu0UP1ONFwDsw5mPh2y2ZCaeT0haDcnY4wrlDBeANnb739_JrfAXD1w5PbA…",
"videoSdUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQOFqZ9wd36PuUFXb7EofKYVbrehl1XuN2OuwAVqWRMUqFdissjZ45nZadysKUcZIzWHl92OzCa-BnKPA7S7F2p-z5kjRjOD4K0RsLtF6w.mp4…",
"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=OaWtXkprfIAQ7…",
"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=OaWtXkprfIAQ7…"
],
"music": null
},
"link": null,
"stats": {
"reactions": 22725,
"reactionsByType": [],
"comments": 364,
"shares": 319,
"views": null,
"viewsLabel": "2.1M views"
},
"comments": [],
"feedbackId": "ZmVlZGJhY2s6MTAzNzYxNDE3MjUxNzQyNA==",
"createdAtMs": 1785481347000,
"createdAt": "2026-07-31T07:02:27.000Z"
},
"fetchedAt": "2026-10-05T14:42:41.368Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
```
## 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: LinkedIn
description: LinkedIn scraping endpoints
- name: Twitch
description: Twitch scraping endpoints
- name: TikTok
description: TikTok (tiktok.com) scraping endpoints
paths:
/v1/facebook/post:
get:
tags:
- Facebook
summary: Post
description: >-
Fetches a public Facebook post or reel 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=ydr4yHuSOWIQ7kNvwGhhXAc&_nc_oc=Adqv3JFGHjH0T_6Cu_GbMuLMftcCuke7hCq7B2ryTs-6S2e7vCbuxJUWXmVdCA0Dr6c&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=gNpMkbha3C01ZNfbnrUL6Q&_nc_ss=7c289&oh=00_AQMj9hzk4zi2YwlXeAQo--K0o8PatnQ1-5lImGq53JHA6g&oe=6AC98073
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=PyRjqEyNF_YQ7kNvwG8uZyy&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjIxNjg4MTYxOTcxMDA3NzEsImFzc2V0X2FnZV9kYXlzIjo2NiwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=5cbf6c144f3b0ddc&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC80NDQ3MzdBODUxMDhEMkVEODAzMzg5NzZGMDZGMDlCRl9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0RBNDlEN0QzRTIyNTY5NjVDOTU0MTc5QkNDMkE1MEE0X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbGk5fw26HaBxUCKAJDMywXQEXd0vGp--cYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=gNpMkbha3C01ZNfbnrUL6Q&_nc_ss=7c289&_nc_zt=28&oh=00_AQONRXUMYhQ1ayC6p_adkik3V6p-abcQEgVFHtq_atJBDg&oe=6AC98662&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=PyRjqEyNF_YQ7kNvwG8uZyy&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjIxNjg4MTYxOTcxMDA3NzEsImFzc2V0X2FnZV9kYXlzIjo2NiwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=5cbf6c144f3b0ddc&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC80NDQ3MzdBODUxMDhEMkVEODAzMzg5NzZGMDZGMDlCRl9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0RBNDlEN0QzRTIyNTY5NjVDOTU0MTc5QkNDMkE1MEE0X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbGk5fw26HaBxUCKAJDMywXQEXd0vGp--cYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=gNpMkbha3C01ZNfbnrUL6Q&_nc_ss=7c289&_nc_zt=28&oh=00_AQONRXUMYhQ1ayC6p_adkik3V6p-abcQEgVFHtq_atJBDg&oe=6AC98662&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=CM9fzJ2w4xUQ7kNvwH9tdNE&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MjE2ODgxNjE5NzEwMDc3MSwiYXNzZXRfYWdlX2RheXMiOjY2LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6NDMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=gNpMkbha3C01ZNfbnrUL6Q&_nc_ss=7c289&_nc_zt=28&oh=00_AQNeHE4Us5b-hRyawGKZlJrws9R2RcvA7hAaj-6HdKWvYA&oe=6AC99A3F&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=OaWtXkprfIAQ7kNvwGdit3A&_nc_oc=AdpLbnEwWiHklidwzh_eRHLKD3oqlAwrCdeAuDcfV5b_aaGEwKfaGq23qyyqs4cnAQo&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=2Kd5tKTExQWd3zLj9ryhiQ&_nc_ss=7c289&oh=00_AQMu6GT2tOqeLvcqhL5D9oVGDfASm4eCBmDEOwOaNPk1lw&oe=6AC99723
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=OaWtXkprfIAQ7kNvwGdit3A&_nc_oc=AdpLbnEwWiHklidwzh_eRHLKD3oqlAwrCdeAuDcfV5b_aaGEwKfaGq23qyyqs4cnAQo&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=2Kd5tKTExQWd3zLj9ryhiQ&_nc_ss=7c289&oh=00_AQMu6GT2tOqeLvcqhL5D9oVGDfASm4eCBmDEOwOaNPk1lw&oe=6AC99723
music: null
link: null
stats:
reactions: 22725
reactionsByType: []
comments: 364
shares: 319
views: null
viewsLabel: 2.1M views
comments: []
feedbackId: ZmVlZGJhY2s6MTAzNzYxNDE3MjUxNzQyNA==
createdAtMs: 1785481347000
createdAt: '2026-07-31T07:02:27.000Z'
fetchedAt: '2026-10-05T14:42:41.368Z'
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
'503':
description: >-
Temporarily unavailable — retry after `Retry-After`. `error.code`
tells you why: `UPSTREAM_BLOCKED` (the source blocked this request),
`EXTRACTION_FAILED` (the source returned unexpected data),
`PLATFORM_UNAVAILABLE` (the source is down), or
`SERVICE_UNAVAILABLE` (we are at capacity).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UPSTREAM_BLOCKED
message: >-
The source is 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.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.