Resolve a Marketplace location
/v1/facebook/marketplace/location/searchBuild a location picker that resolves place names into the location values used by Marketplace search.
Resolve locations, search Marketplace listings, browse whole categories and read item details. Build local product research around the area that matters.
Gibran PulgaCEO, Desys FinanceWe use ScrapeAtlas to gather social sentiment data for our banking partners at a scale we wouldn't have been able to otherwise.
WHAT YOU CAN BUILD / 05 ENDPOINTS
Find your use case, then explore the request and response.
/v1/facebook/marketplace/location/searchBuild a location picker that resolves place names into the location values used by Marketplace search.
/v1/facebook/marketplace/searchBuild a local shopping finder using Marketplace search results and location and product filters.
/v1/facebook/marketplace/categoriesBuild a shopping category selector from Marketplace’s category identifiers and names.
/v1/facebook/marketplace/categoryBuild a category browsing page using Marketplace listings at selected coordinates, with price, condition, delivery and sorting filters.
/v1/facebook/marketplace/itemBuild listing comparison pages with item descriptions, prices, condition, category attributes, photos, videos and availability.
HOW IT WORKS
Run a sample below without a key.
Create a free account and copy your key. You start with 100 free credits; no card needed.
Pick one of the 5 Facebook Marketplace endpoints and add its input, such as a search query.
Call it with your key in the x-api-key header. ScrapeAtlas reads the public Facebook Marketplace data and retries when a read fails.
Get structured JSON with a coverage status. Only successful requests use a credit.
LIVE RESULTS
Try the Facebook Marketplace API right here. This sample uses the Search Marketplace listings endpoint and returns live JSON. No API key needed.
Start with bike, or change the query field to your own value.
Execute the sample code and see the response in the JSON response tab.
Open the full playground to try more parameters and copy code for your app.
// 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);
Run the sample to see the live JSON response here.
/v1/facebook/marketplace/searchA live example from our playground. Change the value above, then select Run sample.
CUSTOMER STORIES
Watch Nigel’s story
Matteo L.Small-Business (50 or fewer emp.)Read on G2I use ScrapeAtlas to find product ideas—real ideas that people need. I couldn’t get to people’s ideas on social media platforms without it. I like that it’s easy and capable, and it isn’t expensive. I value the scraping and MCP features. …
Ms H.Sales, Mid-Market (51-1000 emp.)Read on G2ScrapeAtlas saves me from juggling a different scraper for every platform. … ScrapeAtlas solves the problem of getting reliable public data from many social and e-commerce platforms without building and maintaining my own scrapers.
Watch Janu’s storyWe use ScrapeAtlas to gather social sentiment data for our banking partners at a scale we wouldn't have been able to otherwise.
Gibran PulgaCEO, Desys Finance
Stas D.Founder, Marketing and AdvertisingRead on G2I like the convenient documentation and conditions at ScrapeAtlas. The parsers work great: I use keyword data from fresh threads to find target audiences and clients in Threads. I also appreciate the higher quality API responses and more detailed request customization. The initial setup was very easy for me.
Pay as you go
One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.
Try the API with your next idea.
$0No credit card needed
100 free credits
One starter grant per account
For a new idea or a one-off project.
$19USD / one-time
10,000 credits
$1.90 per 1,000 credits
For regular workflows and bigger builds.
$89USD / one-time
50,000 credits
$1.78 per 1,000 credits
Save 6.3% compared with Starter
For high-volume data collection.
$249USD / one-time
200,000 credits
$1.25 per 1,000 credits
Save 34.5% compared with Starter
Enterprise Plan
Let’s talk about a plan that fits your scale.
Facebook Marketplace API
Retrieve Marketplace search results, category lists, category feeds and individual listing details. Item responses include price, description, condition, attributes, photos, videos and availability flags.
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.
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.
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.
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.
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.
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.
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.
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
Bring social data into your next project.
Start with 100 free credits and see what you can build.
We use essential storage to keep the site working. With your permission, optional analytics and ad-measurement cookies help us understand visits and which Google and ChatGPT ads lead to signups and purchases. You can change your choice anytime. Privacy policy
Google Analytics measures visits, page engagement and signup-link clicks on public pages. With separate ad-measurement consent, Google Analytics records confirmed signups and actual paid credit-pack purchases, including purchase value and currency. Google stores ad-click attribution cookies. OpenAI also measures confirmed signups and credit purchases and may match supported customer information using browser-side hashes. Rejecting optional cookies does not affect access to the site.
Allow Affonso to record your referral visit and store a cookie for 30 days. If you sign up, we share your verified email with Affonso to attribute purchases. Privacy policy