APIs / Social media / Facebook

1 credit per call20 endpoints

Facebook API

Get Facebook data as structured JSON with one API key: marketplace search, event, event post and events. Free credits every month.

Facebook
GET/v1/facebook/marketplace-search?query=bike&location=San+Francisco
curl "https://api.perceptlayer.com/v1/facebook/marketplace-search?query=bike&location=San+Francisco" \
  -H "X-API-Key: $API_KEY"
cURL1 credit per successful call
Run this call below or from your dashboard to see a live response.

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/facebook/marketplace-search?query=bike&location=San+Francisco" \
  -H "X-API-Key: $API_KEY"

Facebook · 20 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

Note
Endpoints marked “Needs terms” return personal or social data. They work once you accept the restricted-endpoint terms in your dashboard.
EndpointRequired parametersCost
GET/v1/facebook/event
event_idNeeds terms
1 credit
GET/v1/facebook/event-post
permalinkNeeds terms
1 credit
GET/v1/facebook/events
query+1 optionalNeeds terms
1 credit
GET/v1/facebook/group
group_idNeeds terms
1 credit
GET/v1/facebook/group-posts
group_idNeeds terms
1 credit
GET/v1/facebook/marketplace-browse
none+1 optionalNeeds terms
1 credit
GET/v1/facebook/marketplace-item
listing_idNeeds terms
1 credit
GET/v1/facebook/marketplace-search
none+2 optionalNeeds terms
1 credit
GET/v1/facebook/page
handleNeeds terms
1 credit
GET/v1/facebook/page-about
handleNeeds terms
1 credit
GET/v1/facebook/page-events
handleNeeds terms
1 credit
GET/v1/facebook/photo
photoNeeds terms
1 credit
GET/v1/facebook/photos
handleNeeds terms
1 credit
GET/v1/facebook/post
permalinkNeeds terms
1 credit
GET/v1/facebook/profile
handleNeeds terms
1 credit
GET/v1/facebook/profile-about
handleNeeds terms
1 credit
GET/v1/facebook/profile-feed
handleNeeds terms
1 credit
GET/v1/facebook/reel
permalinkNeeds terms
1 credit
GET/v1/facebook/reels
handleNeeds terms
1 credit
GET/v1/facebook/videos
handleNeeds terms
1 credit

Overview

About the Facebook API

What you can get

The Facebook API returns marketplace search, event, event post and events as clean JSON. Each successful call costs one credit, and calls that fail are free.

Social mediaJSONRESTMCPSome endpoints need terms

More social media APIs

Use cases

Monitor mentions of your brand

Use the Facebook API to monitor mentions of your brand

Find and vet creators

Use the Facebook API to find and vet creators

Track trends and engagement over time

Use the Facebook API to track trends and engagement over time

FAQ

Questions

How much does the Facebook API cost?

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Do I need a separate key for Facebook?

No. One key works for every API in the catalogue.

Try the Facebook API with 1,000 free credits

No credit card. Failed calls are never billed.