Platform · Social

Facebook

Pages, posts, reels, groups, events, Marketplace and the Meta ad library.

Exploring what to build? See the Facebook API overview with endpoint pages and working examples.

Endpoints: 21
Base price: 1 cr
Source: Provider

Endpoint	Returns	Credits
GET /v1/facebook/profile	Profile	1
GET /v1/facebook/posts	Post[]	1
GET /v1/facebook/post	Post	1
GET /v1/facebook/comments	Comment[]	1
GET /v1/facebook/linked-profiles	LinkedProfile[]	10
GET /v1/facebook/reels	Post[]	1
GET /v1/facebook/photos	Post[]	1
GET /v1/facebook/transcript	Transcript	1
GET /v1/facebook/summary	Summary	4
GET /v1/facebook/community	Profile	1
GET /v1/facebook/community/posts	Post[]	1
GET /v1/facebook/marketplace/search	Product[]	1
GET /v1/facebook/marketplace/item	Product	1
GET /v1/facebook/ads/search	Ad[]	1
GET /v1/facebook/ads	Ad[]	1
GET /v1/facebook/ad	Ad	1
GET /v1/facebook/ad/transcript	Transcript	1
GET /v1/facebook/advertisers/search	Advertiser[]	1
GET /v1/facebook/events	Event[]	1
GET /v1/facebook/events/search	Event[]	1
GET /v1/facebook/event	Event	1

Core

Profile

1 credit

Get a public profile by handle.

GET/v1/facebook/profile→Profile

handle	required	Username without the @.
enrich	optional	arabic: add dialect, sentiment, entities and topics (+3 credits).

curl -G https://api.crawlfeed.dev/v1/facebook/profile \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=nike"

Profile API overview →

Posts

1 credit

List a profile's recent posts.

GET/v1/facebook/posts→Post[]

handle	required	Username without the @.
cursor	optional	From meta.next_cursor, to get the next page.
enrich	optional	arabic: add dialect, sentiment, entities and topics (+3 credits).

curl -G https://api.crawlfeed.dev/v1/facebook/posts \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=nike"

Posts API overview →

Post

1 credit

Get a single post by id.

GET/v1/facebook/post→Post

id	required	The post id on that platform.
enrich	optional	arabic: add dialect, sentiment, entities and topics (+3 credits).

curl -G https://api.crawlfeed.dev/v1/facebook/post \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

Post API overview →

Comments

1 credit

List comments on a post.

GET/v1/facebook/comments→Comment[]

post_id	required	The post to read comments from.
cursor	optional	From meta.next_cursor, to get the next page.
enrich	optional	arabic: add dialect, sentiment, entities and topics (+3 credits).

curl -G https://api.crawlfeed.dev/v1/facebook/comments \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "post_id=<post_id>"

Comments API overview →

Profiles and people

Linked profiles

10 credits

The same creator's accounts on other platforms, matched through their public links.

GET/v1/facebook/linked-profiles→LinkedProfile[]

handle	required	Username without the @.
cursor	optional	From meta.next_cursor, to get the next page.

curl -G https://api.crawlfeed.dev/v1/facebook/linked-profiles \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=nike"

Linked profiles API overview →

Posts and feeds

Reels and shorts

1 credit

A profile's short-form videos: reels, shorts.

GET/v1/facebook/reels→Post[]

handle	required	Username without the @, or the profile URL.
cursor	optional	From meta.next_cursor, to get the next page.
enrich	optional	arabic: add dialect, sentiment, entities and topics (+3 credits).

curl -G https://api.crawlfeed.dev/v1/facebook/reels \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=nike"

Reels and shorts API overview →

Photos

1 credit

A page's photos.

GET/v1/facebook/photos→Post[]

handle	required	Username without the @, or the profile URL.
cursor	optional	From meta.next_cursor, to get the next page.
enrich	optional	arabic: add dialect, sentiment, entities and topics (+3 credits).

curl -G https://api.crawlfeed.dev/v1/facebook/photos \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=charlidamelio"

Photos API overview →

Transcripts and media

Transcript

1 credit

The spoken text of a video, with timings when available.

GET/v1/facebook/transcript→Transcript

required

The video or post id, or its URL.

curl -G https://api.crawlfeed.dev/v1/facebook/transcript \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

Transcript API overview →

Summary

4 credits

An AI summary of a video: a few sentences, the key points and the topics, written from its transcript.

GET/v1/facebook/summary→Summary

id	required	The video or post id, or its URL.
lang	optional	Language to write the summary in (ISO 639-1, e.g. en, ar). Defaults to the video’s language.

curl -G https://api.crawlfeed.dev/v1/facebook/summary \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

Summary API overview →

Communities

Community

1 credit

A community (subreddit, group) as a profile.

GET/v1/facebook/community→Profile

id	required	Community name or URL.
enrich	optional	arabic: add dialect, sentiment, entities and topics (+3 credits).

curl -G https://api.crawlfeed.dev/v1/facebook/community \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

Community API overview →

Community posts

1 credit

Posts in a community, or a channel’s community tab.

GET/v1/facebook/community/posts→Post[]

id	required	Community name or URL, or a YouTube channel handle.
cursor	optional	From meta.next_cursor, to get the next page.
enrich	optional	arabic: add dialect, sentiment, entities and topics (+3 credits).

curl -G https://api.crawlfeed.dev/v1/facebook/community/posts \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

Community posts API overview →

Shops and marketplaces

Marketplace search

1 credit

Marketplace listings near a location.

GET/v1/facebook/marketplace/search→Product[]

q	required	What to search for.
lat	required	Latitude.
lng	required	Longitude.
cursor	optional	From meta.next_cursor, to get the next page.

curl -G https://api.crawlfeed.dev/v1/facebook/marketplace/search \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "q=coffee" \
  --data-urlencode "lat=40.7128" \
  --data-urlencode "lng=-74.006"

Marketplace search API overview →

Marketplace item

1 credit

One marketplace listing.

GET/v1/facebook/marketplace/item→Product

required

Listing id or URL.

curl -G https://api.crawlfeed.dev/v1/facebook/marketplace/item \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

Marketplace item API overview →

Ad libraries

Search ads

1 credit

Ads in the public ad library matching a keyword.

GET/v1/facebook/ads/search→Ad[]

q	required	What to search for.
country	optional	ISO country code.
cursor	optional	From meta.next_cursor, to get the next page.

curl -G https://api.crawlfeed.dev/v1/facebook/ads/search \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "q=coffee"

Search ads API overview →

An advertiser's ads

1 credit

Every ad an advertiser is running or ran.

GET/v1/facebook/ads→Ad[]

advertiser	required	Advertiser name, page id or domain.
country	optional	ISO country code.
cursor	optional	From meta.next_cursor, to get the next page.

curl -G https://api.crawlfeed.dev/v1/facebook/ads \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "advertiser=nike.com"

An advertiser's ads API overview →

1 credit

One ad from the ad library.

GET/v1/facebook/ad→Ad

required

Ad id or ad-library URL.

curl -G https://api.crawlfeed.dev/v1/facebook/ad \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

Ad API overview →

Ad transcript

1 credit

The spoken text of a video ad.

GET/v1/facebook/ad/transcript→Transcript

required

Ad id or ad-library URL.

curl -G https://api.crawlfeed.dev/v1/facebook/ad/transcript \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

Ad transcript API overview →

Search advertisers

1 credit

Find an advertiser, and the id its ads are filed under.

GET/v1/facebook/advertisers/search→Advertiser[]

q	required	What to search for.
cursor	optional	From meta.next_cursor, to get the next page.

curl -G https://api.crawlfeed.dev/v1/facebook/advertisers/search \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "q=coffee"

Search advertisers API overview →

Events

1 credit

A page's upcoming and past events, or a streamer's schedule.

GET/v1/facebook/events→Event[]

handle	required	Username without the @, or the profile URL.
cursor	optional	From meta.next_cursor, to get the next page.

curl -G https://api.crawlfeed.dev/v1/facebook/events \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=nike"

Events API overview →

Search events

1 credit

Public events matching a keyword.

GET/v1/facebook/events/search→Event[]

q	required	What to search for.
cursor	optional	From meta.next_cursor, to get the next page.

curl -G https://api.crawlfeed.dev/v1/facebook/events/search \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "q=coffee"

Search events API overview →

Event

1 credit

One event.

GET/v1/facebook/event→Event

required

Event id or URL.

curl -G https://api.crawlfeed.dev/v1/facebook/event \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

Event API overview →

Every endpoint also takes fresh=true (skip the cache, 2× price) and include_raw=true (add the platform’s own payload). See Response shape and Credits.