Upscrape
Sign in Get an API key

Facebook scraper API

Scrapes public Facebook data including pages, posts, events, videos, reviews, and ads library.

Social & content 10 capabilities stable 69.3% success rate Streaming
Sign in to run this LLM brief

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Search Ads Library

facebook.ads-library.search
Streaming

Searches the Facebook Ads Library for active and inactive ads by advertiser or keyword.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"Meta AI"},"capability":"facebook.ads-library.search"}'

Input

Field Type Required Description
cursor string optional Pagination cursor from previous response
limit integer optional Maximum number of results to return
query string required Search query string

Output

Field Type Required Description
items — optional
next_cursor string optional Next page cursor
query string optional Search query
summary — optional
total_count integer optional Total ads found

List Page Posts

facebook.page-posts.list
Streaming

Lists recent posts from a Facebook page including text, media, and engagement metrics.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta"},"capability":"facebook.page-posts.list"}'

Input

Field Type Required Description
cursor string optional Pagination cursor from previous response
limit integer optional Maximum items per page
url string required Page URL

Output

Field Type Required Description
author_id string optional Author unique identifier
author_name string optional Author display name
comments_count integer optional Number of comments
created_at string optional Creation timestamp in RFC3339 format
id string optional Post identifier
items — optional
likes_count integer optional Number of likes
shares_count integer optional Number of shares or reposts
summary — optional
text string optional Post text content
url string optional Post URL

List Page Reels

facebook.page-reels.list
Streaming

Lists reels from a Facebook page with view counts and video metadata.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta"},"capability":"facebook.page-reels.list"}'

Input

Field Type Required Description
limit integer optional Maximum items to return
url string required Page URL

Output

Field Type Required Description
items — optional
summary — optional

List Page Videos

facebook.page-videos.list
Streaming

Lists videos posted by a Facebook page with titles, view counts, and engagement metrics.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta"},"capability":"facebook.page-videos.list"}'

Input

Field Type Required Description
cursor string optional Pagination cursor from previous response
limit integer optional Maximum items per page
url string required Page URL

Output

Field Type Required Description
author_name string optional Author display name
comments_count integer optional Number of comments
description string optional Video description
duration_seconds integer optional Duration in seconds
id string optional Video identifier
items — optional
likes_count integer optional Number of likes
published_at string optional Publication timestamp in RFC3339 format
summary — optional
thumbnail_url string optional Thumbnail image URL
title string optional Video title
url string optional Video URL
views_count integer optional Number of views

Get Page

facebook.page.get

Fetches a Facebook page's public profile including name, category, follower count, and page metadata.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta"},"capability":"facebook.page.get"}'

Input

Field Type Required Description
url string required Resource URL to scrape

Output

Field Type Required Description
avatar_url string optional Profile picture URL
best_description — optional
bio string optional User biography or description
category string optional Page category
category_name — optional
cover_photo — optional
ctwa_ad4ad_insights — optional
ctx_business_adoption_fact_based_benchmark_page_id — optional
display_name string optional Display name
followers_count integer optional Number of followers
id string optional Unique user identifier
likes_count integer optional Page likes
name — optional
profile_picture — optional
profile_picture_uri — optional
url string optional Profile URL
username string optional Username handle
verified boolean optional Whether the account is verified
viewer — optional

Get Photo

facebook.photo.get

Fetches details about a public Facebook photo including image URL and engagement metadata.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/photo/?fbid=266478569374694"},"capability":"facebook.photo.get"}'

Input

Field Type Required Description
url string required Photo URL

List Post Comments

facebook.post-comments.list
Streaming

Lists comments on a Facebook post including comment text, author, and reaction counts.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta/posts/pfbid0EwsxFj5K4PGG5XS58NxrZwEYgrx4aWwnSYJdFVsphLZDJMPXYiokrkefu1CmKm4Vl"},"capability":"facebook.post-comments.list"}'

Input

Field Type Required Description
cursor string optional Pagination cursor from previous response
limit integer optional Maximum items per page
url string required Post URL

Output

Field Type Required Description
author_id string optional Comment author identifier
author_name string optional Comment author display name
created_at string optional Comment creation timestamp
id string optional Comment identifier
items — optional
likes_count integer optional Number of likes on comment
reply_count integer optional Number of replies
summary — optional
text string optional Comment text content

Get Post

facebook.post.get

Fetches a Facebook post's details including text, reactions, shares, and comment count.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta/posts/pfbid0EwsxFj5K4PGG5XS58NxrZwEYgrx4aWwnSYJdFVsphLZDJMPXYiokrkefu1CmKm4Vl"},"capability":"facebook.post.get"}'

Input

Field Type Required Description
url string required Post URL

Output

Field Type Required Description
__isFeedUnit — optional
__isTrackableFeedUnit — optional
__module_component_CometFeedUnitContainerSection_feedUnit — optional
__module_operation_CometFeedUnitContainerSection_feedUnit — optional
__typename — optional
actors — optional
attached_story — optional
attachments — optional
bumpers — optional
cache_id — optional
can_viewer_see_menu — optional
cix_screen — optional
click_tracking_linkshim_cb — optional
client_view_config — optional
comet_sections — optional
debug_info — optional
encrypted_click_tracking — optional
encrypted_tracking — optional
feedback — optional
future_of_feed_info — optional
id — optional
is_story_civic — optional
matched_terms — optional
permalink_url — optional
post_id — optional
schema_context — optional
serialized_frtp_identifiers — optional
should_host_actor_link_in_watch — optional
sponsored_data — optional
to — optional
trackingdata — optional
viewability_config — optional
whatsapp_ad_context — optional
work_is_repost — optional
work_reposted_story — optional

Get Reel

facebook.reel.get

Fetches details about a public Facebook Reel including video URL, view count, and engagement.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/reel/911507208162880"},"capability":"facebook.reel.get"}'

Input

Field Type Required Description
url string required Resource URL to scrape

Output

Field Type Required Description
actors — optional
author_name string optional Author display name
collaborators — optional
comet_sections — optional
comments_count integer optional Number of comments
description string optional Video description
duration_seconds integer optional Duration in seconds
encrypted_tracking — optional
id string optional Video identifier
likes_count integer optional Number of likes
post_id — optional
published_at string optional Publication timestamp in RFC3339 format
thumbnail_url string optional Thumbnail image URL
title string optional Video title
to — optional
url string optional Video URL
views_count integer optional Number of views

Get Video

facebook.video.get

Fetches details about a public Facebook video including title, view count, and engagement metrics.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta/videos/911507208162880/"},"capability":"facebook.video.get"}'

Input

Field Type Required Description
url string required Resource URL to scrape

Output

Field Type Required Description
actors — optional
author_name string optional Author display name
collaborators — optional
comet_sections — optional
comments_count integer optional Number of comments
description string optional Video description
duration_seconds integer optional Duration in seconds
encrypted_tracking — optional
id string optional Video identifier
likes_count integer optional Number of likes
post_id — optional
published_at string optional Publication timestamp in RFC3339 format
thumbnail_url string optional Thumbnail image URL
title string optional Video title
to — optional
url string optional Video URL
views_count integer optional Number of views

Run Facebook in under a minute

Sign in, create an API key, and try any capability in the playground before you write code.

Get an API key