Profile Posts
GET/v1/facebook/profile/posts1 credit
Returns the latest posts from a Facebook page or profile's timeline, 3 per page, with text, media, reaction and comment counts and top comments.
01Query parameters
| Name | Type | Description |
|---|---|---|
| urloptional | string | A Facebook page or profile URL, e.g. `https://www.facebook.com/NASA`. One of `url` or `pageId` is required. |
| pageIdoptional | string | The numeric Facebook profile id. One of `url` or `pageId` is required. |
| cursoroptional | string | The `cursor` from the previous page. |
02Request
curl "https://api.scrapesocial.ai/v1/facebook/profile/posts?url=https%3A%2F%2Fwww.facebook.com%2FNASA" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/facebook/profile/posts?url=https%3A%2F%2Fwww.facebook.com%2FNASA
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"posts": [
{
"id": "1665530011609035",
"text": "We are not slowing down. 🚀\n\nOur Artemis III mission will send four astronauts to low Earth orbit next year to test critical systems needed for future lunar landings https://go.nasa.gov/4zV3TuG and we’re accelerating efforts to ensure the success of Artemis IV, the first Artemis mission on the lunar surface https://go.nasa.gov/3UeKjdl.",
"url": "https://www.facebook.com/reel/1803909017420449/",
"permalink": "https://www.facebook.com/reel/1803909017420449/",
"author": {
"__typename": "User",
"name": "NASA - National Aeronautics and Space Administration",
"short_name": "NASA - National Aeronautics and Space Administration",
"id": "100044561550831"
},
"videoDetails": {
"sdUrl": "https://video.fkco5-1.fna.fbcdn.net/o1/v/t2/f2/m412/AQPmxViNexUB6xVrvFjHBBcIJismrAQ9uEtNFuQMOfPMiR3xJ5Mr2vSGPJmV-0dFwJyyT_xGt-CyE1m-nzgcMME9dK-C2-ri4WjL5lKlKw.mp4?_nc_cat=111&_nc_oc=AdqdS4N3kY8rHqRKALIvpcgPq-TcNqh6T5CKy9aOHLXKxFZqvKQ8ozTQr9mmrlfkdg8&_nc_sid=8bf8fe&_nc_ht=video.fkco5-1.fna.fbcdn.net&_nc_ohc=JZhmmSwXIV4Q7kNvwF-bmoQ&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIuNjQw…",
"hdUrl": "https://video.fkco5-1.fna.fbcdn.net/o1/v/t2/f2/m366/AQOrR7mXmkNxEorB-LS9EEo5aIQjyCpClJ_vp7yt0fKywnl9WB8y8aLcIiXFjXY6z4DijZm4k3MiUpxkl7j9N8D72G81B_PlU6tzm4YrbYkd4Q.mp4?_nc_cat=109&_nc_oc=Adr4SKqk1vP1FvebhpBWNDKyC425yHG5S_9O6tL6l4962HfwXEzDT7tu6iDceDuSXxU&_nc_sid=5e9851&_nc_ht=video.fkco5-1.fna.fbcdn.net&_nc_ohc=uXhF4RfcSiQQ7kNvwFMblkd&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIu…",
"thumbnailUrl": "https://scontent.fkco5-1.fna.fbcdn.net/v/t15.5256-10/861707093_1378071157463251_3699379084540793101_n.jpg?stp=dst-jpg_tt6&cstp=mx3840x2160&ctp=s960x960&_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=be8305&_nc_ohc=QzmqNFRLy8UQ7kNvwFXTsPG&_nc_oc=Adrj1f7HqBgFQx9nuT7uzARFmc2v8lE6DbIUb1TXo4Dgdsy_besYaYZT0NWIKps8Coo&_nc_zt=23&_nc_ht=scontent.fkco5-1.fna&_nc_gid=sNFzJpfRsDJQ69MFNT0pZw&_nc_ss=7b28…"
},
"image": "https://scontent.fkco5-1.fna.fbcdn.net/v/t15.5256-10/861707093_1378071157463251_3699379084540793101_n.jpg?stp=dst-jpg_tt6&cstp=mx3840x2160&ctp=s960x960&_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=be8305&_nc_ohc=QzmqNFRLy8UQ7kNvwFXTsPG&_nc_oc=Adrj1f7HqBgFQx9nuT7uzARFmc2v8lE6DbIUb1TXo4Dgdsy_besYaYZT0NWIKps8Coo&_nc_zt=23&_nc_ht=scontent.fkco5-1.fna&_nc_gid=sNFzJpfRsDJQ69MFNT0pZw&_nc_ss=7b28…",
"images": [
"https://scontent.fkco5-1.fna.fbcdn.net/v/t15.5256-10/861707093_1378071157463251_3699379084540793101_n.jpg?stp=dst-jpg_tt6&cstp=mx3840x2160&ctp=s960x960&_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=be8305&_nc_ohc=QzmqNFRLy8UQ7kNvwFXTsPG&_nc_oc=Adrj1f7HqBgFQx9nuT7uzARFmc2v8lE6DbIUb1TXo4Dgdsy_besYaYZT0NWIKps8Coo&_nc_zt=23&_nc_ht=scontent.fkco5-1.fna&_nc_gid=sNFzJpfRsDJQ69MFNT0pZw&_nc_ss=7b28…"
],
"reactionCount": 3186,
"share_count": 337,
"reaction_counts": {
"thankful": 0,
"like": 2715,
"love": 412,
"care": 33,
"haha": 11,
"wow": 14,
"sad": 0,
"anger": 1,
"pride": 0,
"confused": 0
},
"commentCount": 121,
"videoViewCount": 53908,
"publishTime": 1792798858,
"creation_time": "2026-10-23T23:40:58.000Z",
"topComments": [
{
"id": "Y29tbWVudDoxNjY1NTMwMDExNjA5MDM1XzE4MTc5MzU5Nzk2MjUzMDc=",
"text": "Testing Artemis III's critical systems in low Earth orbit first is exactly the right approach — every lesson learned there makes the Artemis IV lunar landing safer. Here's to not slowing down.",
"publishTime": 1792825966,
"author": {
"id": "61594630482587",
"name": "Beyond Earth",
"gender": "UNKNOWN",
"url": "https://www.facebook.com/people/Beyond-Earth/61594630482587/"
}
}
]
},
{
"id": "1665224618306241",
"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 stars within the nebula emit rays of high-energy light, including X-rays shown in pink by our Chandra X-ray Observatory.",
"url": "https://www.facebook.com/NASA/posts/pfbid0zwvjBLbhcggFpTWjw3srTcEPvMjhpgVokNygvYskTEzxm8D4UiBLnnBi7zmkMkEfl",
"author": {
"__typename": "User",
"name": "NASA - National Aeronautics and Space Administration",
"short_name": "NASA - National Aeronautics and Space Administration",
"id": "100044561550831"
},
"videoDetails": {},
"image": "https://scontent.fkco5-1.fna.fbcdn.net/v/t39.99422-6/861422087_1689398352779407_6512216750936510542_n.png?stp=dst-jpg_tt6&cstp=mx1041x941&ctp=s1041x941&_nc_cat=101&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=127cfc&_nc_ohc=Gz-y5C-tjo4Q7kNvwFhdKIc&_nc_oc=Adpsb1A7arP9dFGGOciBssXGEHmnVtEDj2RUoYpRkgNY1x1ULomUM87Iuo49p6ZaEos&_nc_zt=14&_nc_ht=scontent.fkco5-1.fna&_nc_gid=sNFzJpfRsDJQ69MFNT0pZw&_nc_ss=7b28…",
"reactionCount": 5067,
"share_count": 479,
"reaction_counts": {
"thankful": 0,
"like": 3110,
"love": 1763,
"care": 100,
"haha": 7,
"wow": 85,
"sad": 1,
"anger": 1,
"pride": 0,
"confused": 0
},
"commentCount": 127,
"videoViewCount": null,
"publishTime": 1792769664,
"creation_time": "2026-10-23T15:34:24.000Z",
"topComments": [
{
"id": "Y29tbWVudDoxNjY1MjI0NjE4MzA2MjQxXzEwODk5MzI4NTcyMTE5MTY=",
"text": "Light can not be seen. Light as we know it is the shock wave of the light. Light is instant but its the shock waves that travel is what we know as the speed of Light.",
"publishTime": 1792773254,
"author": {
"id": "pfbid026eWJvpBVnmWLB5MXSi3RMso3EhqcJz6SpZnzr83Z2HVrpMrTWEHJch123WYnfv7cl",
"name": "Paul Smith",
"gender": "MALE",
"url": null
}
}
]
}
],
"cursor": "Cg8Ob3JnYW5pY19jdXJzb3IJAAACREFRSFRvU3RDOVpoT3VzNDZzdWxhWmdTeXgtNGxuTXNUNElWQmNiVUdUVnR6alduZVotV1hWS09nQUh1WDRlaU8tdVhQVW05bm1LemJ5R04wV0pQYTdMbHZjRjJOd19HSDNxQURnemlxeTZQRmJCaWtHU0RhUEJqazRFVUtrZ0RGY0l1VC1INVVDd2pNTUtwcjJhRmVDVVAzZzY4bnk2VU1sU1dLXzB0WVVVX01VRGZuQW5WNUpCNG1yWE9adTFCeDM3bEM3T3E2aU8wUnZkUTh1cE8wdThkbTY2ZGhINEhtTjVCSWp5R2hmaURKSmlTU1VOeTBWOXNxOU5KVGVKRWFXOVdlUTJaekFRdk54YkpWbDJweG8y…"
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
Pass the response's `cursor` back as `cursor` for the next page. A timeline with no more posts returns an empty list for 0 credits. `permalink` and `images` appear only on some posts.
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.