Scrape a Facebook post by URL
Returns structured JSON for a Facebook post URL (post_id, user_url, content, likes and more). A fresh scrape usually returns in ~5-45s; posts exceed the sync window more often, in which case you get a snapshot_id to fetch from /v1/result (typically ready within 1-2 minutes).
query Parameters
urlThe Facebook post URL to scrape.
fieldsOptional comma-separated list of top-level fields to keep in data.
Scrape a Facebook post by URL › Responses
Scraped data.
typeurlScrape a Facebook profile or page by URL or username
Returns structured JSON for a Facebook profile or page (name, id and more). Works for both people and pages. Pass either url or username; with username the API builds https://www.facebook.com/
query Parameters
urlThe Facebook profile or page URL to scrape. Required unless username is given.
usernameUsername or page handle; used instead of url.
fieldsOptional comma-separated list of top-level fields to keep in data.
Scrape a Facebook profile or page by URL or username › Responses
Scraped data.
typeurlScrape reviews of a Facebook page
Returns an array of review objects (company_name, review_time, review text, reviewer url and more) for a Facebook page. Pass the page URL; the API automatically appends /reviews if missing. Reviews often exceed the sync window, in which case you get a snapshot_id to fetch from /v1/result (typically ready within 1-2 minutes).
query Parameters
urlThe Facebook page URL. /reviews is appended automatically if missing.
limitMax reviews to return (1-50).
fieldsOptional comma-separated list of top-level fields to keep on each review.
Scrape reviews of a Facebook page › Responses
Scraped reviews.
typeurlScrape a Facebook event by URL
Returns structured JSON for a Facebook event URL (event_id, event_date, location and more). A fresh scrape usually returns in ~5-45s; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result.
query Parameters
urlThe Facebook event URL to scrape.
fieldsOptional comma-separated list of top-level fields to keep in data.
Scrape a Facebook event by URL › Responses
Scraped data.
typeurlScrape a Facebook Marketplace listing by URL
Returns structured JSON for a Marketplace listing URL (title, price, description, location, images, seller and more). A fresh scrape usually returns in ~5-45s; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result.
query Parameters
urlThe Marketplace listing URL to scrape.
fieldsOptional comma-separated list of top-level fields to keep in data.
Scrape a Facebook Marketplace listing by URL › Responses
Scraped data.
typeurlFetch a pending scrape result
Retrieve the result of a scrape that exceeded the sync window, using its snapshot_id. When ready, data is an array if the snapshot holds multiple records, otherwise a single object.
query Parameters
snapshot_idFetch a pending scrape result › Responses
Result ready. data is an array for multi-record snapshots, otherwise a single object.
statussnapshot_iddata