Facebook

Post

A post, reel or video: its text, author, time, reactions, comments, shares and views, and its photo or video.

GET/v1/facebook/posts1 credit

Headers

Get your API key

x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

post_idstringoptionalquery

A post's id: digits (the posts endpoints give it). Give post_id or url.

urlstringoptionalquery

A post's, reel's or video's link: facebook.com/<page>/posts/..., /groups/<group>/posts/..., /permalink.php?story_fbid=..., /story.php?story_fbid=..., /share/p/... (or /share/r/..., /share/v/...), /reel/<id>, /watch/?v=<id> or /<page>/videos/<id>. Give post_id or url.

max 500 chars · example: https://www.facebook.com/uniladmag/posts/pfbid02h8QyMzZrMtHks9iU7oneNe4yTKMzNPynvA9WYMedK7eLjU422HD6u3dfmvmgT5QQl

Response fields

dataobject

The result: one object, or a list for the endpoints that return several.

data.idstringnullable

Facebook's id for the post: digits, written as text. The comments endpoint takes it.

data.urlstringnullable

The post's link.

data.textstringnullable

What it says.

data.created_atstringnullable

When it was posted.

format: date-time

data.authorstringnullable

Its author's name: a person, a Page or a group member.

data.author_idstringnullable

Its author's id.

data.author_urlstringnullable

Its author's profile.

data.likesintegernullable

Reactions (likes and the others).

data.comment_countintegernullable

Comments.

data.sharesintegernullable

Shares.

data.viewsintegernullable

A video's or reel's plays. Facebook rounds them in lists (127K).

data.imagestringnullable

Its photo's link, the first of several, or its video's thumbnail.

data.video_idstringnullable

Its video's or reel's id.

data.video_urlstringnullable

Its video's file (MP4), in HD where there is one.

data.duration_secondsnumbernullable

Its video's length, in seconds.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/facebook/posts?url=https%3A%2F%2Fwww.facebook.com%2Funiladmag%2Fposts%2Fpfbid02h8QyMzZrMtHks9iU7oneNe4yTKMzNPynvA9WYMedK7eLjU422HD6u3dfmvmgT5QQl' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": {    "id": "string",    "url": "string",    "text": "string",    "created_at": "2019-08-24T14:15:22Z",    "author": "string",    "author_id": "string",    "author_url": "string",    "likes": 0,    "comment_count": 0,    "shares": 0,    "views": 0,    "image": "string",    "video_id": "string",    "video_url": "string",    "duration_seconds": 0  },  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}

Profile events

A Page's upcoming events, 8 a page. A Page without any answers an empty list.

Post comments

A post's, reel's or video's comments, 10 a page.