Skip to main content
POST /v1/data/facebook/posts/run Pricing: $0.005 per post ($5.00 per 1,000). Pull recent posts and reels from a public Facebook page/profile URL, or member posts from a public group URL.

Ways to call it

  • Page or Profile: set urls (optional: maxResults, onlyPostsNewerThan, onlyPostsOlderThan)
  • Group: set groupUrls (optional: maxResults)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
Public Facebook page or profile URL to scrape posts from (e.g. facebook.com/nike or facebook.com/zuck). Private profiles return no results. Use this OR Group URL, not both.Format e.g. https://www.facebook.com/nike.
string
Public Facebook group URL to scrape member posts from (e.g. facebook.com/groups/<group>). Use this OR Page or Profile URL, not both.Format e.g. https://www.facebook.com/groups/1082450387678660.
integer
Number of posts to return. Use 0 for all.
date
Only get posts published on or after this date (YYYY-MM-DD).
date
Only get posts published on or before this date (YYYY-MM-DD).

Example

Response fields

Each row in data is one post, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
To search posts by keyword instead of by page use facebook/posts-search; for comments on a post use facebook/comments; for reels with play counts use facebook/reels.