scrapeatlas. Get started
Facebook Marketplace API

Facebook Marketplace Scraper API for Local Listings

Resolve locations, search Marketplace listings, browse whole categories and read item details. Build local product research around the area that matters.

Try a request API reference

WHAT YOU CAN BUILD / 05 ENDPOINTS

Put Facebook Marketplace data to work.

Find your use case, then explore the request and response.

Resolve a Marketplace location

GET/v1/facebook/marketplace/location/search

Build a location picker that resolves place names into the location values used by Marketplace search.

Search Marketplace listings

GET/v1/facebook/marketplace/search

Build a local shopping finder using Marketplace search results and location and product filters.

List Marketplace categories

GET/v1/facebook/marketplace/categories

Build a shopping category selector from Marketplace’s category identifiers and names.

Browse a Marketplace category

GET/v1/facebook/marketplace/category

Build a category browsing page using Marketplace listings at selected coordinates, with price, condition, delivery and sorting filters.

Get a Marketplace listing

GET/v1/facebook/marketplace/item

Build listing comparison pages with item descriptions, prices, condition, category attributes, photos, videos and availability.

HOW IT WORKS

From API key to Facebook Marketplace data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 5 Facebook Marketplace endpoints and add its input, such as a search query.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Facebook Marketplace data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

TRY IT HERE / LIVE SAMPLE

Try a sample request.

Try the Facebook Marketplace API right here. This sample uses the Search Marketplace listings endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with bike, or change the query field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Search Marketplace listingsNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "bike";
const url = new URL("/website/demo/facebook-marketplace",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/facebook/marketplace/search

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

Digging your ScrapeAtlas experience?

Email Viktor with a testimonial & receive 10,000 free credits.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Save 6.3%

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Facebook Marketplace API

Frequently Asked Questions

Explore the API reference

Facebook Marketplace API and scraping

What listing data does the Facebook Marketplace API return?

Retrieve Marketplace search results, category lists, category feeds and individual listing details. Item responses include price, description, condition, attributes, photos, videos and availability flags.

How do I scrape Facebook Marketplace listings by location?

Resolve a city or place with Location Search, then pass the returned coordinates to Marketplace Search. Apply price, condition, delivery, date, availability and sorting filters to refine your listing research.

Can I retrieve a single Facebook Marketplace listing through the API?

Use Item Details to retrieve a selected listing’s description, price, condition and availability flags. The response also includes its category and attributes for building a detailed product research card.

Facebook Marketplace: listing search and category filters

Can I get Facebook Marketplace categories and browse their listings?

Yes. Categories returns top-level categories or the children of a selected category. Pass the category slug and location coordinates to Category Feed to browse its listings with product filters.

Can the Facebook Marketplace API search prices and product conditions?

Yes. Search Listings supports price and condition filters alongside location, delivery, dates, availability and sorting. Use Item Details to enrich a selected result with its description, category attributes and media.

Can the Facebook Marketplace API retrieve listing photos and videos?

Yes. Item Details returns the listing’s published photo and video references alongside its description and product attributes. Use those media references to illustrate the item in a comparison view with its source listing link.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

Start building for free Explore pricing
No credit card needed.Building with an AI agent?