← API Store
SocialFacebook
Facebook page / profile posts
GET /facebook/v1/profile/postsEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
urlrequired | string | Example: https://www.facebook.com/NASA |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 3,
"credits_used": 4,
"next_cursor": "eyJ2Ijp7ImNvdW50IjoxLCJmZWVkYmFja1NvdXJjZSI6MCwiZmVlZExvY2F0aW9uIjoiVElNRUxJTkUiLCJvbWl0UGlubmVkUG9zdCI6dHJ1ZSwicHJpdmFjeVNlbGVjdG9yUmVuZGVy…",
"page_info": {
"end_cursor": "Cg8Ob3JnYW5pY19jdXJzb3IJAAACREFRSFROTVpoMmk2cHFsN1pualFvY1VEc3FJUmFIZ3YybEdWRXZBSHlpQ0xYOFRTUkJsbG1Hd3RaVDJsUVdWRl8xd1BGR1BlOWdHRGE2eVIwaGMt…",
"has_next_page": true
},
"posts": [
{
"attachment_types": [
"StoryAttachmentPhotoStyleRenderer"
],
"author": {
"id": "100044561550831",
"name": "NASA - National Aeronautics and Space Administration",
"url": "https://www.facebook.com/NASA"
},
"author_details": {
"id": "100044561550831",
"name": "NASA - National Aeronautics and Space Administration",
"profile_pic": "https://scontent.flim2-2.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png_s100x100&_nc_cat=1&ccb=…",
"type": "User",
"url": "https://www.facebook.com/NASA",
"verified": null
},
"comments": 47,
"created_at": "2026-10-23T15:34:24.000Z",
"creation_time": 1792769664,
"feedback_id": "ZmVlZGJhY2s6MTY2NTIyNDYxODMwNjI0MQ==",
"hashtags": [],
"id": "1665224618306241",
"link": null,
"photo_details": [
{
"alt": null,
"height": null,
"id": "1665224601639576",
"image": null,
"url": null,
"width": null
}
],
"photos": [
"https://scontent.flim2-2.fna.fbcdn.net/v/t39.30808-6/858550186_1665224608306242_5963798559688782078_n.jpg?_nc_cat=103&_nc_map=urlgen_bucketl…"
],
"privacy": "Public",
"reaction_count_text": "1.4K",
"reactions": 1457,
"share_count_text": "171",
"shares": 171,
"story_id": "UzpfSTEwMDA0NDU2MTU1MDgzMToxNjY1MjI0NjE4MzA2MjQxOjE2NjUyMjQ2MTgzMDYyNDE=",
"text": "Ahh… blue lagoon 🏖️\n \nThis deep-blue sea of gas and dust—called Messier 8 or the Lagoon Nebula—is a hotbed of star formation. The young star…",
"top_reactions": [
{
"count": 985,
"type": "Like"
},
{
"count": 427,
"type": "Love"
},
"… 2 more"
],
"url": "https://www.facebook.com/NASA/posts/pfbid02185jUUsSSBcEFdrte3mN6jSmmMmLYrh7hoy2NEPoTXu28VuTBizAqjbxCt7gXvCJl",
"videos": [],
"views": null
},
{
"attachment_types": [
"StoryAttachmentPhotoStyleRenderer"
],
"author": {
"id": "100044561550831",
"name": "NASA - National Aeronautics and Space Administration",
"url": "https://www.facebook.com/NASA"
},
"author_details": {
"id": "100044561550831",
"name": "NASA - National Aeronautics and Space Administration",
"profile_pic": "https://scontent.flim2-2.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png_s100x100&_nc_cat=1&ccb=…",
"type": "User",
"url": "https://www.facebook.com/NASA",
"verified": null
},
"comments": 118,
"created_at": "2026-10-22T19:53:38.000Z",
"creation_time": 1792698818,
"feedback_id": "ZmVlZGJhY2s6MTY2NDQ3Nzg3NTA0NzU4Mg==",
"hashtags": [],
"id": "1664477875047582",
"link": null,
"photo_details": [
{
"alt": null,
"height": null,
"id": "1664477861714250",
"image": null,
"url": null,
"width": null
}
],
"photos": [
"https://scontent.flim2-6.fna.fbcdn.net/v/t39.30808-6/857745998_1664477865047583_7948459830471427458_n.jpg?_nc_cat=109&_nc_map=urlgen_bucketl…"
],
"privacy": "Public",
"reaction_count_text": "5.2K",
"reactions": 5213,
"share_count_text": "607",
"shares": 607,
"story_id": "UzpfSTEwMDA0NDU2MTU1MDgzMToxNjY0NDc3ODc1MDQ3NTgyOjE2NjQ0Nzc4NzUwNDc1ODI=",
"text": "That's our jam 🎼\n \nAstronomers used our Chandra X-ray Observatory to find out that this radio wave formation, known as the \"Treble Clef\" tha…",
"top_reactions": [
{
"count": 2802,
"type": "Like"
},
{
"count": 2186,
"type": "Love"
},
"… 5 more"
],
"url": "https://www.facebook.com/NASA/posts/pfbid02ofYB5G3miLoSfgysUwQYp2NaBGDFsbFGMZ43T5HETaBZNwXnYeUEpDSVwKKdCs4wl",
"videos": [],
"views": null
},
"… 1 more"
],
"user_id": "100044561550831"
} Response fields (55)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.page_info | object |
$.page_info.end_cursor | string |
$.page_info.has_next_page | boolean |
$.posts | array |
$.posts[] | object | string |
$.posts[].attachment_types | array |
$.posts[].attachment_types[] | string |
$.posts[].author | object |
$.posts[].author.id | string |
$.posts[].author.name | string |
$.posts[].author.url | string |
$.posts[].author_details | object |
$.posts[].author_details.id | string |
$.posts[].author_details.name | string |
$.posts[].author_details.profile_pic | string |
$.posts[].author_details.type | string |
$.posts[].author_details.url | string |
$.posts[].author_details.verified | null |
$.posts[].comments | integer |
$.posts[].created_at | string |
$.posts[].creation_time | integer |
$.posts[].feedback_id | string |
$.posts[].hashtags | array |
$.posts[].id | string |
$.posts[].link | null |
$.posts[].photo_details | array |
$.posts[].photo_details[] | object |
$.posts[].photo_details[].alt | null |
$.posts[].photo_details[].height | null |
$.posts[].photo_details[].id | string |
$.posts[].photo_details[].image | null |
$.posts[].photo_details[].url | null |
$.posts[].photo_details[].width | null |
$.posts[].photos | array |
$.posts[].photos[] | string |
$.posts[].privacy | string |
$.posts[].reaction_count_text | string |
$.posts[].reactions | integer |
$.posts[].share_count_text | string |
$.posts[].shares | integer |
$.posts[].story_id | string |
$.posts[].text | string |
$.posts[].top_reactions | array |
$.posts[].top_reactions[] | object | string |
$.posts[].top_reactions[].count | integer |
$.posts[].top_reactions[].type | string |
$.posts[].url | string |
$.posts[].videos | array |
$.posts[].views | null |
$.user_id | string |