How to choose a Facebook Marketplace API
A Facebook Marketplace API returns public listings as data: what is for sale near a place, at what price and in what condition. This guide covers the common jobs, Meta’s own options and what to compare.
By PrimaryAPIReviewed
What people use Marketplace data for
Most Marketplace projects are one of four jobs.
- Price research: what similar items are listed for near you, and which ones have sold.
- Flipping: spotting underpriced items early in a category you know well.
- Alerts: a saved search that runs on a schedule and flags new listings.
- Local market studies: how supply and asking prices for a product differ between cities.
Meta’s own Marketplace APIs
Meta’s Content Library API can search Marketplace listings, but access is by application for researchers at qualified academic or not-for-profit institutions, and queries run in a controlled cleanroom.
Meta’s Marketplace partner APIs go the other way: they let eligible partners publish listings onto Marketplace. If you are building for a business, check the eligibility details in the official API section before you plan around either one.
From a city name to listings
A typical flow takes three calls, and each one feeds the next.
- Location search: turn a city or place name into coordinates and a place page id.
- Marketplace search: send a keyword with that latitude and longitude, add price, condition, delivery and date filters, and page through results with a cursor.
- Item details: send a listing’s URL or id for its description, photos, current and previous price, condition, status and seller.
Building listing alerts
Run the same search on a schedule from your own code, sorted newest first, and keep the listing ids you have already seen. Anything new is a candidate for an alert.
Check the item before you act on it: a listing can be pending or sold by the time you look.
Calling Marketplace data through PrimaryAPI
Create an account, copy your API key and POST a keyword with coordinates to the Marketplace search API. Every Marketplace API page documents its input and output fields, with an example.
Calls spend credits from a prepaid balance, and you only pay when data comes back.