SoonOne MCP server, all 49 APIs as agent tools. See how it works

Marketplace, posts, pages, reviews & events as clean JSON

Advanced Facebook API

The Advanced Facebook API is a live Facebook scraper API: pass a facebook.com URL and get structured JSON back. Scrape Marketplace listings (title, price, seller, location, images), public posts with likes and author, profiles and pages, page reviews and events. No Facebook app review, no Graph API tokens.

Marketplace coverage is the standout: the official Graph API has no Marketplace access at all, while this API returns full listing data from a single GET request. Every call performs a fresh live scrape, so the data reflects Facebook right now, not a stale cache.

Free tier included, no credit card required. One key works across all 49 APIs.

At a glance
Endpoints
6
Response Time
5-45s
Data Freshness
Live

Key features

  • Facebook Marketplace listings: title, price, seller, location, images
  • Public posts with content, likes and author
  • Profiles and pages via URL or username
  • Page reviews as a structured array (limit 1-50)
  • Events with date and location details
  • No Facebook app review or Graph API tokens required

Built for

  • Marketplace price monitoring and resale tools
  • Social listening and brand monitoring
  • Lead enrichment from profiles and pages
  • Reputation tracking from page reviews
  • Local event aggregation and discovery

Try it

Build the request for your data

Edit the parameters below and see the exact curl command and JSON response you will get. No key required to preview.

GET/v1/profile
Open in Playground

Parameters

Request · HTTP
GET /facebook/v1/profile?username=zuck HTTP/1.1
Host: api.apicodex.io
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY
Response · JSON
200 OK
{
  "type": "profile",
  "url": "https://www.facebook.com/zuck/",
  "data": {
    "name": "Mark Zuckerberg",
    "id": "4",
    "url": "https://www.facebook.com/zuck/",
    "page_category": "Public figure"
  }
}

Documentation

Advanced Facebook API Documentation

Scrape Facebook posts, profiles, pages, page reviews, events and Marketplace listings with a single GET request. Pass a facebook.com URL and get structured JSON back. A fresh scrape usually returns in 5-45 seconds; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result, typically ready within 1-2 minutes.

Base URL

url
https://api.apicodex.io/facebook

Authentication

Create a key at dash.apicodex.io and send it as an X-Api-Key header (or an ?apikey= query parameter) on every request. Calls without a valid key return 401.

headers
GET /v1/profile?username=zuck
X-Api-Key: YOUR_API_KEY

Request and response

Illustrative values. Confirm current endpoint behavior, quotas, and data freshness in the API documentation before production use.

request · http
GET /v1/profile?username=zuck HTTP/1.1
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY
response · json
{
  "type": "profile",
  "url": "https://www.facebook.com/zuck/",
  "data": {
    "name": "Mark Zuckerberg",
    "id": "4",
    "url": "https://www.facebook.com/zuck/",
    "page_category": "Public figure"
  }
}

Code examples

cURL
curl --request GET \
  --url 'https://api.apicodex.io/facebook/v1/marketplace?url=https://www.facebook.com/marketplace/item/1593339208189595/' \
  --header 'X-Api-Key: YOUR_API_KEY'

Available Endpoints

GET /v1/marketplace

Scrape a Marketplace listing: title, price, description, location, images, seller.

/v1/marketplace?url=https://www.facebook.com/marketplace/item/1593339208189595/

GET /v1/post

Scrape a public post: content, likes, author.

/v1/post?url=https://www.facebook.com/somepage/posts/1234567890

GET /v1/profile

Scrape a profile or page by URL or username. Works for people and pages.

/v1/profile?username=zuck

GET /v1/reviews

Scrape page reviews as an array. /reviews is appended to the page URL automatically.

/v1/reviews?url=https://www.facebook.com/DominosPizza&limit=10

GET /v1/events

Scrape an event: date, location and details.

/v1/events?url=https://www.facebook.com/events/1234567890

GET /v1/result

Fetch a pending result by snapshot_id after a 202 response.

/v1/result?snapshot_id=s_abc123

Request Parameters

Required parameters

  • url The facebook.com URL to scrape. Required on every scrape endpoint (on /v1/profile you may pass username instead).

Optional parameters

  • username /v1/profile only: a username or page handle; the API builds the URL for you.
  • fields Comma-separated list of top-level fields to keep in data, e.g. fields=name,id.
  • limit /v1/reviews only: max reviews to return (1-50, default 10).
  • snapshot_id /v1/result only: the id returned by a 202 response.

Responsible use

Use public social data carefully

Only request data that is publicly accessible, and make sure your collection, storage, and use comply with applicable privacy laws and the relevant platform terms. Do not use these APIs to bypass access controls or to make decisions that require consent or human review.

Pricing

Advanced Facebook API Pricing

One key, one subscription, all 49 APIs. Start free and upgrade when you grow. No minimums, no lock-in.

This API costs 25 credits per request. Credits are shared across every API on your plan.

Estimate your monthly cost

Drag the slider to match your expected request volume. We will recommend the cheapest plan that covers it.

10,000

Recommended plan

Pro

$99.99 /month

Credits used250,000
Credits included250,000
Cost per 1K requests$9.999
Choose Pro

Free

Free
1,000 credits · ~40 requests/mo · 2 rps
  • All 49 APIs included
  • No credit card required
  • Full documentation and examples
Start for free

Starter

Popular
$29.99/month
50,000 credits · ~2,000 requests/mo · 10 rps
  • All 49 APIs included
  • Email support
  • Usage dashboard and analytics
Start with Starter

Pro

$99.99/month
250,000 credits · ~10,000 requests/mo · 25 rps
  • All 49 APIs included
  • Priority support
  • Up to 5 API keys
Start with Pro

Need a different plan?

Tell us about your API, volume, or support requirements.

Contact us

Coming soon · MCP

Use the Advanced Facebook API from your AI agent

The API Codex MCP server will expose this API, and the other 39, to Claude, Cursor and any MCP client as tools. Same key, same credits, one config entry.

About the MCP server

FAQ

Frequently asked questions

The Graph API requires a Facebook app, permissions review and user or page access tokens, and it only exposes data those tokens are authorized for. The Advanced Facebook API is a live scraper: you pass a public facebook.com URL and get structured JSON back, with no app review, no OAuth flow and no Graph API tokens. Your API Codex key is the only credential.

Yes, and that is the standout feature. The Graph API has no Marketplace access at all. /v1/marketplace?url= takes any public listing URL and returns title, price, description, location, images and seller details as clean JSON, which makes it ideal for price monitoring and resale tools.

The API only reads publicly visible Facebook content: public listings, posts, pages, profiles, reviews and events. It never logs into accounts, bypasses privacy settings or accesses private data. As with any scraping workflow, you are responsible for using the data in line with the laws and regulations that apply to your use case.

Every request performs a live scrape of Facebook at the moment you call the API; nothing is served from a pre-crawled database. That is why responses take 5-45 seconds instead of milliseconds: you trade a little latency for data that reflects Facebook right now.

A 202 means the scrape exceeded the synchronous window and is still running. The response includes a snapshot_id; poll GET /v1/result?snapshot_id= until it returns status "ready" with your data. Posts and reviews hit this path more often and are typically ready within 1-2 minutes.

No. Pass the plain page URL (for example https://www.facebook.com/DominosPizza) to /v1/reviews and the API automatically appends /reviews if it is missing. Use limit (1-50, default 10) to control how many reviews come back in the data array.