Is there a Facebook Marketplace API?
No, not one you can sign up for. Meta has never shipped a public Marketplace API, and the Marketplace endpoints it does document are gated behind approvals that are closed to almost everyone. This page walks through each one, what it actually returns, and what is left once you rule them out.
Four things in Meta's developer documentation carry the Marketplace name. None of them lets you search listings from your own code.
| What Meta documents | Who it is for | What it does | How you get it |
|---|---|---|---|
| Content Library API | Researchers at accredited academic institutions or not-for-profit research organisations | Search public Marketplace listings by country, price, view count and date, for study | Apply through Research Tools Manager. Reviewed by CASD, then by Meta, at two to three weeks per stage |
| Marketplace Partner Item API | Approved online classified ad services distributing their own inventory into Marketplace | Create, update and delete your own product items in batches of up to 300 | Meta's Marketplace Partner Program, which requires consumer-to-consumer listings in a European Economic Area country |
| Marketplace Partner Seller API | The same approved partners | Register and manage the sellers behind those listings | Same program, same approval |
| Vehicles catalog feed | Dealers and the software vendors working for them | Publish a vehicle inventory feed into Marketplace Vehicles and take leads through Messenger | A product catalog plus a linked Facebook Page. No approval, but it only carries your own stock |
Read from Meta's developer documentation on 9 August 2026.
What each Meta surface is really for
Three of the four exist so somebody can put listings into Marketplace. Only one reads them out, and it was built for academics.
The Content Library API is for research
This one genuinely covers Marketplace. Meta documents a marketplace listings search path with filters for country, price, view count and date range, and you can sort by views, date or price when you query a single country. If you are studying how a second-hand market behaves, it is the right tool.
It is the wrong tool for building anything. To apply you have to be affiliated with an accredited academic institution or a not-for-profit organisation whose core activity is scientific or public interest research. Applications go through Research Tools Manager, get reviewed independently by CASD, and then get processed by Meta, with Meta's own published estimate at two to three weeks per stage. Access is tied to the research purpose you stated, and a substantial change to that purpose means a new application. View counts refresh every two to three days, and multimedia is excluded by default from queries run in third-party cleanrooms.
The Partner APIs push listings in, they do not read them out
The Marketplace Partner Item API and the Seller API belong to Meta's Marketplace Partner Program, which exists so approved classified ad services can distribute their own inventory into Marketplace alongside everyone else's. The Item API takes batches of up to 300 product items and creates, updates or deletes them, with a documented ceiling of 30 calls a minute. Reading is limited to submission status and your own catalog through Commerce Manager.
Eligibility is narrow. Meta's partner page asks you to be an online classified ad service in the European Commission's sense of that term, with consumer-to-consumer listings available in a European Economic Area country. There is no signup form for a developer with a side project.
Vehicles runs on a catalog feed
Marketplace Vehicles works the same direction. A dealer, or the software vendor working for one, creates a product catalog, uploads a vehicle feed and links a Facebook Page, and the inventory appears in Marketplace with leads arriving through Messenger, or a lead form outside the US and Canada. Feed processing is asynchronous and Meta warns that changes can take up to 24 hours to appear. It publishes your own stock and tells you nothing about anybody else's.
The Graph API has no Marketplace node
Marketplace is not part of the social graph the Graph API exposes, so there is no route to a listing, a search or a seller. Meta's Automated Data Collection Terms cover the gap directly: you will not engage in automated data collection without first obtaining Meta's express written permission, and accepting those terms is not itself that permission. Nothing in Meta's current developer documentation suggests that is about to change.
What people build instead
Four approaches turn up in every thread on this. Each one has a real cost, and it is worth knowing which cost you are signing up for.
Unofficial libraries
A handful of open-source projects wrap Marketplace's internal calls and present them as an API. They work until Meta renames a field or rotates a query hash, and because none of that is a published contract, it happens without notice. Check the commit history and the open issues before you build on one: an unmaintained project here is a project that broke and nobody fixed.
Driving a real browser
Automating a headless browser gets you the page a person would see, which sidesteps the undocumented internals. It is slow, it costs you a browser session per request, and signed-out sessions run into rate limits and security checkpoints quickly.
Third-party data services
Several companies sell Marketplace listing data through REST endpoints of their own. You are paying them to carry the breakage risk, which is a reasonable trade. Ask what they promise about freshness, geographic coverage and how much of a listing they return, and remember that Meta's Automated Data Collection Terms still govern how they obtained it.
Marketplace's own saved searches
Saving a search inside Facebook and turning notifications on costs nothing and takes a minute. It is not programmable and the alerts are famously unreliable, but if all you need is to hear about a listing rather than process one, start there and see whether it is enough.
A read-only connection your assistant can use
Most people who go looking for a Marketplace API want a specific thing found at a specific price, not an endpoint.
Spottable runs a Model Context Protocol connection at https://api.spottableapp.com/v1/mcp. Point ChatGPT, Claude, Codex or Cursor at it, sign in once, and the assistant can search Marketplace near a location and open individual listings inside the conversation you are already having.
Ask for a 250cc dual-sport under $3,000 within 100 km of Denver and you get listings back with prices, distances, photos and the detail page fields Marketplace exposes, close enough to compare without opening twenty tabs. Ask it to look again at the three you liked and it pulls the full listings in one go.
What it does
- Search Marketplace listing cards near a set of coordinates, with radius, price, condition, shipping and sort filters.
- Open one listing for its full detail page, photos, condition, and category fields such as mileage and title status when Marketplace exposes them.
- Inspect up to ten known listings in one batch so an assistant can compare candidates side by side.
- Analyze a listing for price, condition and red flags before contacting the seller.
- Report the connected account, the plan on it, and how many credits are left.
What it will not do
- It is not a REST or GraphQL endpoint. Your own code cannot call it. An assistant that speaks Model Context Protocol calls it for you.
- It is read-only. It cannot message a seller, post a listing, make an offer, or buy anything.
- It needs a paid Spottable Pro or Max plan. There is no free tier for the connection.
- It is metered. Searches, listing lookups and fresh AI analyses use one credit. Fair-use limits cap it at 100 searches and 200 combined listing lookups, photo requests or analyses an hour.
Common questions
Does Facebook Marketplace have an API?
Not a public one. Meta documents a Content Library API for approved researchers and a pair of Partner APIs for approved classified ad services, and neither is open to a general developer. There is no Marketplace node or edge in the Graph API.
Is there a Facebook Marketplace search API I can call?
Only inside the Content Library API, which searches historical public listings and is limited to researchers at accredited academic or not-for-profit research institutions. Applications go through Research Tools Manager and are reviewed twice.
Can I read Marketplace listings through the Graph API?
No. Marketplace has no node or edge in the Graph API, so there is no path to a listing, a search result or a seller profile. The Graph API endpoints that carry the Marketplace name write your own catalog items into Marketplace rather than reading anyone else out of it.
Is there a Facebook Marketplace REST API for listings?
Meta does not publish one. Several companies sell Marketplace listing data through REST endpoints of their own, but those are third-party services rather than Meta products, and Meta’s Automated Data Collection Terms still govern how the data was gathered.
Can I post listings to Marketplace automatically?
For vehicles, yes. Build a product catalog, upload a vehicle feed and link a Facebook Page, and the inventory appears in Marketplace Vehicles. Feed processing is asynchronous and Meta warns that changes can take up to 24 hours to show. For general consumer listings, automated posting is limited to approved partners.
Is using an unofficial Marketplace API against Meta’s terms?
Meta’s Automated Data Collection Terms say you will not engage in automated data collection without first obtaining Meta’s express written permission, and that accepting the terms is not itself that permission. Read them and take your own legal advice before you ship anything that depends on it.
What does Spottable’s Marketplace connection cost?
It is included with the Pro and Max plans. Searches, listing lookups and fresh AI analyses use one credit from the plan. Matching previous analyses are free, with hourly fair-use limits of 100 searches and 200 combined listing lookups, photo requests or analyses.