Facebook Scraper API endpoints

This guide shows you how to send a synchronous request to each Bright Data Facebook Scraper API endpoint. It covers profiles, page posts, posts, marketplace listings, and comments.

Prerequisites

A Bright Data account with an active API key
Completed the Quickstart

Request structure

Every synchronous request follows the same pattern:

POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.facebook.com/..."}]

The only thing that changes between endpoints is the dataset_id and the input URL format.

The /scrape endpoint is built for real-time, single-URL requests. Bright Data recommends 20 URLs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP 202 with a snapshot_id instead of data, and collection continues asynchronously. Fetch the result with async requests or have it pushed to you with webhook delivery.

How to scrape Facebook profiles

Dataset ID: gd_mf0urb782734ik94dz

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mf0urb782734ik94dz&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck"}]'

You should see a 200 response. Processing time varies with target-site conditions and scraper workload.

Example response

[
  {
    "name": "Mark Zuckerberg",
    "url": "https://www.facebook.com/zuck",
    "id": "4",
    "profile_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-1/632598281_10117314650513371_3238643608998008744_n.jpg?stp=dst-jpg_tt6&cstp=mx711x711&ctp=s200x200&_nc_cat=...",
    "cover_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-6/632550896_10117314656231911_7975049830116595629_n.png?stp=dst-png&cstp=mx820x360&ctp=s820x360&_nc_cat=110&...",
    "location": "Palo Alto, California",
    "city": "Palo Alto"
  }
]

Full Profiles response schema

Which output fields does the Facebook profiles scraper return?

The Facebook profiles scraper (gd_mf0urb782734ik94dz, collect_by_url) returns 11 output fields.

Field	Type	Description
`url`	url	URL
`name`	text	The name of the person
`id`	text	The Facebook profile ID
`profile_photo`	image	The profile photo
`cover_photo`	image	The profile’s cover photo
`work`	array	The working places of the profile
`college`	array	College data of the profile
`high_school`	array	High school data of the profile
`photos`	array	The profile’s photos
`location`	text	The location where the profile is from
`city`	text	The city where the profile is from

Machine-readable version with the input schema: /scrapers/gd_mf0urb782734ik94dz.json

How to scrape Facebook page posts

Dataset ID: gd_lkaxegm826bjpoo9m5

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkaxegm826bjpoo9m5&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/NASA"}]'

Example response

[
  {
    "url": "https://www.facebook.com/reel/28631238109803230/",
    "num_comments": 82,
    "date_posted": "2026-09-04T15:07:02.000Z",
    "post_id": "1620874212741282",
    "user_url": "https://www.facebook.com/NASA",
    "user_username_raw": "NAS***n",
    "content": "AvGeeks, assemble!\n\nMAX POWER, America’s newest and most exciting aerospace technology expo and air show, is touching down in Florida on Nov. 7–8.\n\nJUST CONF...",
    "num_shares": 62,
    "page_name": "NASA - National Aeronautics and Space Administration",
    "profile_id": "100044561550831"
  }
]

Full Page Posts response schema

Which output fields does the Facebook page posts scraper return?

The Facebook page posts scraper (gd_lkaxegm826bjpoo9m5, collect_by_url) returns 52 output fields.

Output fields (52)

Field	Type	Description
`url`	url	Facebook post URL
`post_id`	text	Unique identifier for each Facebook post
`user_url`	url	Unique identifier for each Facebook post
`user_username_raw`	text	Username of the user who posted the content
`content`	text	Text or media content of the post
`date_posted`	date	Date and time when the post was published
`hashtags`	array	Hashtags used in the post
`num_comments`	number	Number of comments on the post
`num_shares`	number	Number of shares of the post
`num_likes_type`	object	Type of likes received: The data point “count_reactions_type” contains all reactions received.
`page_name`	text	Name of the Facebook page where the post was published
`profile_id`	text	Unique identifier for the user’s profile
`page_intro`	text	Introduction or description of the Facebook page
`page_category`	text	Category of the Facebook page
`page_logo`	image	Logo of the Facebook page
`page_external_website`	text	External website associated with the Facebook page
`page_likes`	number	Number of likes on the Facebook page
`page_followers`	number	Number of followers of the Facebook page
`page_is_verified`	boolean	Verification status of the Facebook page
`original_post`	object	Indicates if the post is original or a repost
`attachments`	array	Media attachments included in the post
`other_posts_url`	array	Web address of other posts by the same user
`post_external_link`	url	External link included in the post
`post_external_title`	text	Title of the external link
`post_external_image`	url	Post external link image
`page_url`	url	Web address of the Facebook page
`header_image`	image	Header image of the Facebook page
`avatar_image_url`	text	The URL of the avatar image of the Facebook page
`profile_handle`	text	The handle or username of the Facebook page
`has_handshake`	text	Indicates if the post has a handshake
`is_sponsored`	boolean	Indicates whether the post is sponsored or not
`sponsor_name`	text	The name of the sponsor if the post is sponsored
`shortcode`	text	The shortcode of the post URL
`video_view_count`	number	The number of views if the post contains a video
`likes`	number	The number of likes on the post
`post_image`	image	post image url if exists
`post_type`	text	The type of the post
`following`	number	Number of profiles following
`link_description_text`	text	The text that is visible under the link title
`count_reactions_type`	array	Type of reactions received
`is_page`	boolean	Is the post from a page or a profile
`page_phone`	text	Public phone number listed on the page
`page_email`	text	Public email address listed on the page
`page_creation_time`	date	Date the page was created
`page_reviews_score`	text	Average page review score
`page_reviewers_amount`	number	Total number of page reviewers
`page_price_range`	text	Price range label shown on the page
`about`	array	Key-value pairs extracted from the page’s About section
`active_ads_urls`	array	Links to the page’s active ads in Facebook Ad Library
`delegate_page_id`	text	ID of the page shown as responsible for this page
`privacy_and_legal_info`	text	The privacy and legal info of the profile
`play_count`	number	Represents the number of times the video started playing (or was clicked to play)

Machine-readable version with the input schema: /scrapers/gd_lkaxegm826bjpoo9m5.json

Posts by post URL

Dataset ID: gd_lyclm1571iy3mv57zw

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyclm1571iy3mv57zw&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl"}]'

Example response

[
  {
    "url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl",
    "num_comments": 83,
    "date_posted": "2026-09-02T20:52:09.000Z",
    "post_id": "1619357056226331",
    "user_url": "https://www.facebook.com/NASA",
    "user_username_raw": "NAS***n",
    "content": "Red Moon over Louisiana\n\nOn the night of Aug. 27-28, the full moon slipped through Earth's shadow, creating a near-total lunar eclipse for skywatchers in the...",
    "num_shares": 164,
    "profile_id": "100044561550831",
    "page_logo": "https://scontent-nrt6-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s200x200&_nc_cat=1&ccb=..."
  }
]

Full Posts response schema

Which output fields does the Facebook posts by post URL scraper return?

The Facebook posts by post URL scraper (gd_lyclm1571iy3mv57zw, collect_by_url) returns 38 output fields.

Output fields (38)

Field	Type	Description
`url`	url	URL
`post_id`	text	Unique identifier for each Facebook post
`user_url`	url	Unique identifier for each Facebook post
`user_username_raw`	text	Username of the user who posted the content
`content`	text	Text or media content of the post
`date_posted`	date	Date and time when the post was published
`hashtags`	array	Hashtags used in the post
`num_comments`	number	Number of comments on the post
`num_shares`	number	Number of shares of the post
`num_likes_type`	array	Type of likes received (e.g., reactions, thumbs-up)
`profile_id`	text	Unique identifier for the user’s profile
`page_logo`	url	Logo of the Facebook page
`page_likes`	number	Number of likes on the Facebook page
`page_followers`	number	Number of followers of the Facebook page
`page_is_verified`	boolean	Verification status of the Facebook page
`original_post`	object	Indicates if the post is original or a repost
`attachments`	array	Attachments
`post_external_link`	url	External link included in the post
`post_external_title`	text	Title of the external link
`page_url`	url	Web address of the Facebook page
`header_image`	url	Header image of the Facebook page
`avatar_image_url`	text	The URL of the avatar image of the Facebook page
`profile_handle`	text	The handle or username of the Facebook page
`has_handshake`	text	Indicates if the post has a handshake
`is_sponsored`	boolean	Indicates whether the post is sponsored or not
`sponsor_name`	text	The name of the sponsor if the post is sponsored
`shortcode`	text	The shortcode of the post URL
`video_view_count`	number	The number of views if the post contains a video
`likes`	number	The number of likes on the post
`post_image`	url	post image url if exists
`post_type`	text	The type of the post
`user_handle`	text	User handle
`play_count`	number	Play count
`video_title`	text	Video title
`marketplace_price`	price	Price of the item from market place. This value is relevant for marketplace items that were shared in groups.
`delegate_page_id`	text	ID of the page delegated as “responsible for this Page”
`marketplace_is_sold`	text	Indicates whether the product has been sold, applicable only to marketplace posts
`comments`	array	Comments of the post

Machine-readable version with the input schema: /scrapers/gd_lyclm1571iy3mv57zw.json

How to scrape Facebook Marketplace

Dataset ID: gd_lvt9iwuh6fbcwmx1a

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvt9iwuh6fbcwmx1a&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/marketplace/item/123456789"}]'

Example response (illustrative, not captured)

[
  {
    "url": "https://www.facebook.com/marketplace/item/123456789",
    "title": "Vintage Coffee Table",
    "price": "$150",
    "location": "San Francisco, CA",
    "seller_name": "John Doe",
    "description": "Beautiful mid-century modern coffee table..."
  }
]

Full Marketplace response schema

Which output fields does the Facebook Marketplace scraper return?

The Facebook Marketplace scraper (gd_lvt9iwuh6fbcwmx1a, collect_by_url) returns 23 output fields.

Output fields (23)

Field	Type	Description
`url`	url	The direct URL of the Facebook Marketplace listing page
`title`	text	The title of the listing as posted by the seller
`initial_price`	number	The original listed price of the item before any discounts
`final_price`	number	The current or discounted price of the item
`currency`	text	The currency in which the price is listed
`product_id`	text	The unique identifier assigned to the listing by Facebook Marketplace.
`breadcrumbs`	array	A list of navigation breadcrumb items representing the category hierarchy of the listing
`condition`	text	The condition of the listed item as reported by the seller
`description`	text	The full textual description of the listing, as written by the seller
`location`	text	The general location
`country_code`	text	The two-letter ISO 3166-1 alpha-2 country code
`root_category`	text	The root category the listing belongs to on Facebook Marketplace
`images`	array	A list of URLs pointing to the listing’s product images uploaded by the seller
`seller_description`	text	A short bio or description from the seller’s Facebook Marketplace profile
`color`	text	The color of the listed item, if applicable and provided by the seller
`brand`	text	The brand or manufacturer of the listed item, if applicable
`videos`	array	A list of URLs pointing to any video content uploaded by the seller as part of the listing
`profile_id`	text	The unique Facebook profile ID of the seller who posted the listing
`listing_date`	date	The date and time when the listing was originally posted on Facebook Marketplace
`car_miles`	number	The mileage of the vehicle as reported by the seller. Only relevant for car/vehicle listings
`is_sold`	boolean	Indicates whether the product is sold
`transmission`	text	Transmission type shown in vehicle details. Only relevant for car/vehicle listings
`vehicle_details`	object	Detailed vehicle-specific attributes extracted from the ‘About this vehicle’ section of Facebook Marketplace car listings. Null for non-vehicle listings.

Machine-readable version with the input schema: /scrapers/gd_lvt9iwuh6fbcwmx1a.json

How to scrape Facebook comments

Dataset ID: gd_lkay758p1eanlolqw8

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkay758p1eanlolqw8&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl"}]'

Example response

[
  {
    "url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl?locale=en_US",
    "comment_text": "Rayleigh scattering filtering out blue light explains that red moon color same physics as sunsets nice that they captured it from michoud where sls rockets a...",
    "post_id": "pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl",
    "post_url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl?locale=en_US",
    "comment_id": "Y29tbWVudDoxNjE5MzU3MDU2MjI2MzMxXzEwNjQ1NzgzOTMyMjAzNTQ=",
    "user_name": "Tus***a",
    "user_id": "615***",
    "date_created": "2026-09-03T00:51:39.000Z",
    "num_likes": 2,
    "num_replies": 0
  }
]

Full Comments response schema

Which output fields does the Facebook comments scraper return?

The Facebook comments scraper (gd_lkay758p1eanlolqw8, collect_by_url) returns 22 output fields.

Output fields (22)

Field	Type	Description
`url`	url	The URL of the page or post containing the comments
`post_id`	text	Unique identifier for each post
`post_url`	url	URL of the specific post
`comment_id`	text	Unique identifier for each comment
`user_name`	text	Name of the user who made the comment
`user_id`	text	Unique identifier for each user
`user_url`	url	URL of the user’s profile
`date_created`	date	Date and time when the comment was created
`comment_text`	text	The actual text content of the comment
`num_likes`	number	Number of likes or reactions received by the comment
`num_replies`	number	Number of direct replies to the comment
`attached_files`	array	Any files or attachments associated with the comment
`video_length`	number	Length of video content, if applicable
`source_type`	text	Type of source (e.g., Facebook, external link)
`subtype`	text	Subcategory or specific type of the post or comment
`type`	text	General category of the post or comment
`commentator_profile`	url	Commentator profile
`comment_link`	url	Comment URL
`reply`	boolean	Reply
`parent_comment_id`	text	Parent comment id
`commentator_profile_url`	url	The URL of the profile picture of the commentator
`attached_images`	array	Any images associated with the comment

Machine-readable version with the input schema: /scrapers/gd_lkay758p1eanlolqw8.json

Quick reference: dataset IDs

Endpoint	Dataset ID	URL pattern
Pages Posts by Profile URL	`gd_lkaxegm826bjpoo9m5`	`facebook.com/{page_name}`
Comments	`gd_lkay758p1eanlolqw8`	`facebook.com/{user}/posts/{post_id}`
Posts by group URL	`gd_lz11l67o2cb3r0lkj3`	`facebook.com/groups/{group_id}`
Posts by post URL	`gd_lyclm1571iy3mv57zw`	`facebook.com/{user}/posts/{post_id}`
Marketplace	`gd_lvt9iwuh6fbcwmx1a`	`facebook.com/marketplace/item/{item_id}`
Profiles	`gd_mf0urb782734ik94dz`	`facebook.com/{username}`
Pages and Profiles	`gd_mf124a0511bauquyow`	`facebook.com/{page_or_profile}`
Events	`gd_m14sd0to1jz48ppm51`	`facebook.com/events/{event_id}`
Reels by profile URL	`gd_lyclm3ey2q6rww027t`	`facebook.com/{username}`
Company Reviews	`gd_m0dtqpiu1mbcyc2g86`	`facebook.com/{company_page}`

Output formats

Control the response format with the format query parameter:

Value	Description
`json`	JSON array
`ndjson`	Newline-delimited JSON, one record per line (default)
`csv`	Comma-separated values

These are the format values for /scrape. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in output formats.

Async batch requests

Scrape hundreds of URLs in a single batch job.

API reference

Full parameter and response field reference.

Get started

Data extraction

Web search

AI training data

Proxy networks

Facebook Scraper API endpoints

Prerequisites

Request structure

How to scrape Facebook profiles

Which output fields does the Facebook profiles scraper return?

How to scrape Facebook page posts

Which output fields does the Facebook page posts scraper return?

Posts by post URL

Which output fields does the Facebook posts by post URL scraper return?

How to scrape Facebook Marketplace

Which output fields does the Facebook Marketplace scraper return?

How to scrape Facebook comments

Which output fields does the Facebook comments scraper return?

Quick reference: dataset IDs

Output formats

Async batch requests

API reference

​Prerequisites

​Request structure

​How to scrape Facebook profiles

​Which output fields does the Facebook profiles scraper return?

​How to scrape Facebook page posts

​Which output fields does the Facebook page posts scraper return?

​Posts by post URL

​Which output fields does the Facebook posts by post URL scraper return?

​How to scrape Facebook Marketplace

​Which output fields does the Facebook Marketplace scraper return?

​How to scrape Facebook comments

​Which output fields does the Facebook comments scraper return?

​Quick reference: dataset IDs

​Output formats

​Related

Async batch requests

API reference

Prerequisites

Request structure

How to scrape Facebook profiles

Which output fields does the Facebook profiles scraper return?

How to scrape Facebook page posts

Which output fields does the Facebook page posts scraper return?

Posts by post URL

Which output fields does the Facebook posts by post URL scraper return?

How to scrape Facebook Marketplace

Which output fields does the Facebook Marketplace scraper return?

How to scrape Facebook comments

Which output fields does the Facebook comments scraper return?

Quick reference: dataset IDs

Output formats

Related