How is this different from the official Facebook Graph API?

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.

Can I really get Facebook Marketplace data? The Graph API does not offer it.

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.

What data can the API access, and is it compliant?

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.

How fresh is the data?

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.

What does a 202 response mean and how do I handle it?

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.

Do I need to build the /reviews URL myself for page reviews?

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.

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

Advanced Facebook API

Name: Advanced Facebook API
Brand: API Codex
SKU: 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.

Get a free API key Read the docs

Free tier included, no credit card required. One key works across every API.

Free calls / month: 40
Endpoints: 6
Response Time: 5-45s
Data Freshness: Live

Get your free API key

40 free calls on the free plan

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

MCP · for your agent

Hand the Advanced Facebook API to your agent

Connect Claude, Cursor or any MCP client once, then ask in plain words. Your agent finds this API, reads its docs and makes the call: 25 credits per call, the same as REST, from your team's balance.

Connect your agent

Compare reviews across platforms

“Compare what customers said about Northwind Coffee on Facebook and Google Maps this month. Are the complaints the same?”

list_apis · get_api_docsfree

api_request GET /facebook/v1/reviews?url=https://www.facebook.com/northwindcoffee&limit=50 25 cr

+ Google Maps Data API25 cr

Recent reviews from both platforms grouped by theme, with the complaints they share called out.

Price-check a Marketplace listing

“A used standing desk on Marketplace is listed at $180. Pull the listing and tell me how that compares with buying one new.”

list_apis · get_api_docsfree

api_request GET /facebook/v1/marketplace?url=https://www.facebook.com/marketplace/item/1234567890 25 cr

+ walmart-data-api1 cr

The listing's title, price, description and location, next to new prices from Walmart.

Add an event to a city guide

“Add this Facebook event, the Austin Food Truck Festival, to our weekend guide: date, time, venue and a two-line blurb.”

list_apis · get_api_docsfree

api_request GET /facebook/v1/events?url=https://www.facebook.com/events/1234567890 25 cr

Event name, date, time, venue and details, written up as a ready-to-publish guide entry.

$ claude mcp add --transport http apicodex https://mcp.apicodex.io

Illustrative asks; the calls and prices are real. Claude, Cursor, VS Code and Windsurf setup: mcp.apicodex.io

Try it

Build the request for your data

Edit the parameters below and see the exact request and curl command you'd send. No key required to preview.

GET /facebook/v1/profile

Open in Playground

Parameters

username

Request · HTTP

GET /facebook/v1/profile?username=zuck HTTP/1.1
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"
  }
}

Run it with your key

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 apicodex.io/register 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 /facebook/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 /facebook/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'

JavaScript/Node.js

const listing = encodeURIComponent('https://www.facebook.com/marketplace/item/1593339208189595/');
const res = await fetch(`https://api.apicodex.io/facebook/v1/marketplace?url=${listing}`, {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY'
  },
});
console.log(await res.json());

Python

import requests

url = "https://api.apicodex.io/facebook/v1/marketplace"
params = {"url": "https://www.facebook.com/marketplace/item/1593339208189595/"}
headers = {
    "X-Api-Key": "YOUR_API_KEY"
}
print(requests.get(url, headers=headers, params=params).json())

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

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'll recommend the cheapest plan that covers it.

Requests per month 10,000

Recommended plan

Starter

$29.99 /month

Credits used

Credits included

Cost per 1K requests

Choose Starter

Free

1,000 credits · ~40 requests/mo · 2 rps

All APIs included
No credit card required
Full documentation and examples
MCP server for your AI agents
Up to 5 active API keys

Start for free

Starter

Popular

$29.99 /month

50,000 credits · ~2,000 requests/mo · 10 rps

All APIs included
Email support
Usage dashboard and analytics
MCP server for your AI agents
Up to 5 active API keys

Start with Starter

Pro

$99.99 /month

250,000 credits · ~10,000 requests/mo · 25 rps

All APIs included
Priority support
MCP server for your AI agents
Up to 5 active API keys

Start with Pro

FAQ

Advanced Facebook API

Key features

Built for

Hand the Advanced Facebook API to your agent

Compare reviews across platforms

Price-check a Marketplace listing

Add an event to a city guide

Build the request for your data

Advanced Facebook API Documentation

Base URL

Authentication

Request and response

Code examples

Available Endpoints

GET /v1/marketplace

GET /v1/post

GET /v1/profile

GET /v1/reviews

GET /v1/events

GET /v1/result

Request Parameters

Required parameters

Optional parameters

Use public social data carefully

Advanced Facebook API Pricing

Free

Starter

Pro

Need a different plan?

Frequently asked questions

Related APIs