Skip to main content
POST
Facebook posts

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string
required

Page URL, page name or post URL. e.g. https://www.facebook.com/humansofnewyork/

max_items
integer
default:20

Max posts from a page (up to 1000)

Required range: 1 <= x <= 1000
newer_than
string

Posts newer than (date or period). e.g. 2024-01-01 or 3 months

older_than
string

Posts older than (date or period). e.g. 2024-12-31 or 1 week

include_video_transcript
boolean

Include video transcript

Response

Run completed.

session_id
string

Session identifier for this run.

kind
string

Data source identifier for this endpoint.

url
string
max_items
integer
include_video_transcript
boolean
newer_than
string
older_than
string
partial
boolean

True when the scrape stopped early and returned the records collected so far.

human
string

Markdown summary of the result, for display.

machine
object

Structured result payload.

total_points
integer

Points charged for this run.