POST /v1/data/facebook/reels/run
Pricing: $0.005 per reel ($5.00 per 1,000).
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Facebook page or profile URL to pull recent reels from.Format e.g.
https://www.facebook.com/nike.Example
curl -X POST "https://api.mindcase.co/v1/data/facebook/reels/run?wait=true" \
-H "Authorization: Bearer $MINDCASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"params": {
"startUrls": "https://www.facebook.com/9gag",
"maxReels": 20
}
}'
import os, requests
r = requests.post(
"https://api.mindcase.co/v1/data/facebook/reels/run",
params={"wait": "true"},
headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
json={"params": {
"startUrls": "https://www.facebook.com/9gag",
"maxReels": 20
}},
)
job = r.json()
rows = job.get("data", []) # if job["status"] == "running", poll /v1/jobs/{job_id}/results
const r = await fetch("https://api.mindcase.co/v1/data/facebook/reels/run?wait=true", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ params: {
"startUrls": "https://www.facebook.com/9gag",
"maxReels": 20
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
Response fields
Each row indata is one reel, keyed by these fields.
| Field | Name | Type |
|---|---|---|
reelUrl | Reel URL | text |
reelId | Reel ID | text |
page | Page | object |
plays | Plays | number |
playsLabel | Plays Label | text |
publishedAt | Published At | text |
durationSec | Duration (sec) | number |
dimensions | Dimensions | text |
videoUrl | Video URL | text |
thumbnailUrl | Thumbnail URL | text |
audioTitle | Audio Title | text |
audioArtist | Audio Artist | text |
audioTrack | Audio Track | text |
audioType | Audio Type | text |
audioTrackId | Audio Track ID | text |
remixable | Remixable | boolean |
audioMuted | Audio Muted | boolean |
captionLanguages | Caption Languages | object_array |
captionsFileUrl | Captions File URL | text |
dubbedAudioLanguages | Dubbed Audio Languages | object_array |
error | Error | text |
errorDescription | Error Description | text |
Example response
Abridged: long text and lists are shortened.{
"job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
"agent": "facebook/reels",
"status": "completed",
"row_count": 1,
"truncated": false,
"data": [
{
"audioMuted": false,
"audioTitle": "9GAG ยท Original audio",
"videoUrl": "https://video-sea5-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQOd4LI5WmKAkV7LDHHFvlQZraKb8b_djWWf0t1tm90PQQf5IZKzbw8xc7fFc5o-po16uwEKxppZDLd2-Btyr7bazKwqRPdTBjtfKH5ApqA...",
"page": {
"name": "9GAG",
"url": "https://www.facebook.com/9gag",
"pageId": "100064681269092",
"verified": true,
"profilePicUrl": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.30808-1/558650524_1259567689542595_3406789140787719152_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1000x1000&ctp=s40x40&_nc_c..."
},
"durationSec": 14.228,
"remixable": true,
"captionLanguages": [],
"dimensions": "1080x1920",
"thumbnailUrl": "https://scontent-sea5-1.xx.fbcdn.net/v/t15.5256-10/774165303_2565773080523066_264543870700428453_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=s960x960&_nc_cat=...",
"error": null,
"captionsFileUrl": null,
"reelId": "3733834300104641",
"audioType": "CUSTOM_AUDIO",
"playsLabel": "156K",
"plays": 156000,
"errorDescription": null,
"audioTrackId": "27737455815956585",
"dubbedAudioLanguages": [],
"publishedAt": "2026-08-16T23:24:55.000Z",
"reelUrl": "https://www.facebook.com/reel/3733834300104641",
"audioArtist": "9GAG",
"audioTrack": "Original audio"
}
]
}
Related APIs
For all posts usefacebook/posts.