Skip to content
truescrape
Free key

Contents

Site

Facebook Page Posts API

Open in ChatGPTOpen in ClaudeOpen in Gemini

Recent public posts from a Facebook Page, newest first, three per page, with text, reaction, comment and share counts, and the publish timestamp. Pass pagination.cursor back for the next three. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/facebook/page-posts
ParameterTypeRequiredDescription
urlstringyesPage URL, @handle, slug, or numeric page id
cursorstringnopagination.cursor from a previous response

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/facebook/page-posts?url=https%3A%2F%2Fwww.facebook.com%2Fnike&cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  url: 'https://www.facebook.com/nike',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/facebook/page-posts?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/facebook/page-posts",
    params={
        "url": "https://www.facebook.com/nike",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "items": [
      {
        "platform": "facebook",
        "id": "2166091230582141",
        "type": "reel",
        "url": "https://www.facebook.com/reel/2166091230582141/",
        "title": null,
        "text": "Leave your limits at the surface. #JustDoIt",
        "authorId": "100044541544829",
        "authorHandle": "nike",
        "authorName": "Nike",
        "thumbnailUrl": "https://scontent.fsin14-1.fna.fbcdn.net/v/t51.82787-10/549104239_18565912819020081_2330706867671026439_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=101&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=50ce42&_nc_ohc=rVdYD4wcxDkQ7kNvwEN5T2v&_nc_oc=AdrTJqXelYlzXG7LJZsJb37c2fuFGbgAUh1V6s2GPCIJiiyEsF-lOrxCFMO23u3Rrk8&_nc_zt=23&_nc_ht=scontent.fsin14-1.fna&_nc_gid=ntYwcsdCyINYybzWhHs0lQ&_nc_ss=70289&oh=00_AQOS4sbUXGIjUmiFHPEhP5Pyn6dxOqxYj6g5aUk5lSheUg&oe=6ADDE2E4",
        "mediaUrls": [
          "https://video.fsin15-2.fna.fbcdn.net/o1/v/t2/f2/m86/AQN_d55OewP32rlaSZcqUhJpzoq0UPil1hva-6NJse7-pSsLfeyZ1i-XAv1T7deHVk1ANQ86oODPzQ4n-_IpCACCu4wxI5xY0mDCcxk.mp4?_nc_cat=108&_nc_oc=AdpYFCFqqJEY2VZj__DF72KtSPi6eOOZKqp9MkCj6iyerx8ONdcPlcbZDBCkN_dk0Lc&_nc_sid=5e9851&_nc_ht=video.fsin15-2.fna.fbcdn.net&_nc_ohc=yW-wglxZZcMQ7kNvwF_xYCy&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLmRhc2hfYmFzZWxpbmVfM192MSIsInhwdl9hc3NldF9pZCI6MjI5NzE1Mzc2NDA3MjE1NywiYXNzZXRfYWdlX2RheXMiOjQwMCwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjMwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=b7df3c75f2d2a904&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8yQzQwQTkwQUNENTkxMjlGRDNCMjIyMTcwQUI5MEU5OF92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC83Njk4NjExNTI1NjA5ODFfNDMzNjYwMzI0MTI0NzQwODA0MS5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmuuvQofnPlAgVAigCQzMsF0A-Cn752yLRGBJkYXNoX2Jhc2VsaW5lXzNfdjERAHUCZeadAQA&_nc_gid=ntYwcsdCyINYybzWhHs0lQ&_nc_ss=70289&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQOCojzKI-I8ybyTHJS06G_L9APLYhbZVWgaECGxm16ySg&oe=6AD9E471&bitrate=264209&tag=dash_baseline_3_v1"
        ],
        "durationSeconds": 30,
        "viewCount": 509737,
        "likeCount": 8380,
        "commentCount": 2689,
        "shareCount": 1179,
        "hashtags": [
          "JustDoIt"
        ],
        "mentions": [],
        "isSponsored": false,
        "publishedAt": "2025-09-15T16:01:59.000Z",
        "fetchedAt": "2026-10-21T01:51:59.369Z"
      },
      {
        "platform": "facebook",
        "id": "752115997659579",
        "type": "reel",
        "url": "https://www.facebook.com/reel/752115997659579/",
        "title": null,
        "text": "The longest jump is the one you didn’t doubt. #JustDoIt",
        "authorId": "100044541544829",
        "authorHandle": "nike",
        "authorName": "Nike",
        "thumbnailUrl": "https://scontent.fsin14-2.fna.fbcdn.net/v/t51.82787-10/548838919_18565615666020081_158902364425729178_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=50ce42&_nc_ohc=dIMDPPPte5wQ7kNvwGNnNCZ&_nc_oc=Adqx-op3FDsUyA8-0UltWRBAvcZGX8YyFFJq1p4jzAYP_DchCFiOwcnBRloY0cpLpsY&_nc_zt=23&_nc_ht=scontent.fsin14-2.fna&_nc_gid=ntYwcsdCyINYybzWhHs0lQ&_nc_ss=70289&oh=00_AQNs9JwcDvIerlHWMQibYC4aV5h9nclAycEZGl0JtxQA7g&oe=6ADDFC8D",
        "mediaUrls": [
          "https://video.fsin14-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQMKCI1WX31qqKYh6dQ1-zJ_O0_QT_1EoQ0DDcK-8-PKJbjjOyRxJY_Tb7MB5MWdIwGG9axCfH_ZvPUTbzHSOLugG9cobk8OrClu65c.mp4?_nc_cat=111&_nc_oc=AdpqNzy54jmVIaM_RcsvhM49UehY-7YQHu0FgOYCMVm6b0t2xJDAncFunlTAEGq2ru4&_nc_sid=5e9851&_nc_ht=video.fsin14-1.fna.fbcdn.net&_nc_ohc=KjR4rHJV1T0Q7kNvwETRbOM&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLmRhc2hfYmFzZWxpbmVfM192MSIsInhwdl9hc3NldF9pZCI6MTk3MzMzNjQ0MzQ2MjQ3MiwiYXNzZXRfYWdlX2RheXMiOjQwMiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjMwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=81a0ea7698d773dc&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9GQjQ1MEE5MENEODM5NkE0NzhDRUE3OTE1QkM3ODk5M192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNDMzNTA0NDQ0NjIwNDQxXzM0MDA2MzQyOTEyNTQwNzUxNjcubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJpCN4Zumr4EHFQIoAkMzLBdAPgp--dsi0RgSZGFzaF9iYXNlbGluZV8zX3YxEQB1AmXmnQEA&_nc_gid=ntYwcsdCyINYybzWhHs0lQ&_nc_ss=70289&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQMdXWpkOsJB_W3SzfQZCZSS-N2WiR2qtVRu7gHA6nr0Qg&oe=6AD9E784&bitrate=278982&tag=dash_baseline_3_v1"
        ],
        "durationSeconds": 30,
        "viewCount": null,
        "likeCount": 5662,
        "commentCount": 871,
        "shareCount": 653,
        "hashtags": [
          "JustDoIt"
        ],
        "mentions": [],
        "isSponsored": false,
        "publishedAt": "2025-09-13T23:53:03.000Z",
        "fetchedAt": "2026-10-21T01:51:59.371Z"
      }
    ]
  },
  "pagination": {
    "cursor": "WyIxMDAwNDQ1NDE1NDQ4MjkiLCJDZzhPYjNKbllXNXBZMTlqZFhKemIzSUpBQUFDbWtGUlNGUk5Na001VVhGTGJUVXdRM1ZTTVY5UlFuRlZSV3g2V0hoSVFYWndka0ZoYmpOcFlWTk1aM1pCY3pJNU5XVlpZVTlLVnkxWlJuZGZRMWhpWVdOSVNXRlNWMU5PUTBwSGVrWk5NMDVyVjNOVmExcHZUemxHY1dsSVNVbDRVWFF3VTBoWFpERjJVRFJoUzIxNVpVSlFORlIyWVhOeWEzSkhibTV3UldoWmQzZHNVbVEzWTBSNWRVcGxUazVpWXpacFNETllRakY2V1hwaGVFVjRSVE5oZEVwMFdEUXhjVmQxUlRCdmJVd3haa2gzYVVwWmJqUkdWakppY205T2JGcERhVEpDV0RCalVWODJaR1EwUlUxck0yb3pRVEJNTkRCRGVqSmZRV3hHYzFsWVduQmlNbTl6UjFWeVl6UllkRzkxUkV4VGFIbERWVmxLYjJsM2NsVnJWVXhxU1VGQlpHOUhlRWxOVUhBM2JsOWFkMk16ZWs4d1EzbDRTR2xVY1VKd0xVRnhaRlYzUkVsVVptTTFjME5PT1ZsWVIwcG1ZVTR6VVRKemMzUndXbEJRVURGaFpGaHNTVEZtTTI1NVlXVjNRbEZ4Y2xRNGVGRlpVM0Y1TFVONGVqTnZhbWRqTVY5blZXNDFNM2xEU2pWQ2FUTkthSEZLTVdKYVVXWkhZVlJzU1ZkNU1FdHpibGt4Um5Wa2RHTk5UWG81Ykd0MWRrSjVkekZEVEdsTFNqbGlMVmg0VjBkM1dYVk9OSFJIU2pock4wUmllbU50Y2xOWVZHTmxjRGhmTjJNMWVGRk1iSHBNT0VNd1pYUkRWMkpPWVhSNmFrSlpUSEZpU2tRM1duTXhOWHA1TFVaTFVIcEhOMjg1UWxGblFtOTVNRmg0WWtGMVRsVjJTazlJVXpCdVRGcDRTbk13UlhRMGMwVlpTRXQyZVU1dVlWTXhlSHB4Y2tkM05rWXlWWGhLTWpkVVFsTnpZWFZKY1VoTGFrTXljMDV3U2tFM1kxcGljMFpwV1RFNWVHbFVVMlpwTkhBNVYwZE9NWEJEYm5SM2NuUlpSMUZRTjNWQk16WXlOalZVWWpOYWJHb3hlbE01YlRGMk1WWkxWamR4Vld0TVRXUkRhVGM1WVRKdlNXVXdjVWxQU2s5T1VYcERkbEJNWlhKcGJHOTBUSEZSZHc4SllXUmZZM1Z5YzI5eURnOFBaMnh2WW1Gc1gzQnZjMmwwYVc5dUFnQVBCbTltWm5ObGRBSUFEeEJzWVhOMFgyRmtYM0J2YzJsMGFXOXVBdjhCIl0.SrevUtdPXSutVC3W3VvUOw",
    "hasMore": true,
    "count": 3
  },
  "meta": {
    "platform": "facebook",
    "endpoint": "facebook.pagePosts",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 11973,
    "requestId": "req_y7sieqfx2cfligimk6c6"
  }
}

Returns

Returns a list of Post in data.items.

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableyes: usable as a target in POST /v1/jobs/batch
Subscribableyes: as often as every 3600 seconds, firing a webhook only on a change

Other Facebook endpoints

All Facebook endpointsThe unified schema