Facebook Marketplace API
Find listings near a city or coordinates, compare asking prices, and browse categories. Get structured listing data for sourcing tools, price research and marketplace analysis.
Use Cases
Local Price Research
Compare asking prices for similar items across locations. Narrow searches with keywords, categories and price ranges.
Listing Discovery
Search with newest-first ordering and use listing IDs to identify results you have already seen.
Marketplace Analysis
Collect successive result pages to study available listings, categories and delivery options.
API Endpoints
Available endpoints for the Facebook Marketplace API
/v1/facebook/marketplace/search Facebook Marketplace search
Read public Facebook Marketplace search results for a query by city or coordinates, with radius, price filters and newest-first ordering. Each successful request, including each continuation page, costs one credit. Keep all search inputs unchanged when continuing. Availability varies by region and Facebook access restrictions.
Parameters
cursor string Continuation cursor from this endpoint. Expires after 30 minutes. Keep all search filters and limit unchanged. latitude number Search center latitude. Requires longitude; omit location. limit integer Maximum listings to return. Facebook may return fewer. Continue with next_cursor and keep all other inputs unchanged. location string Facebook city slug or an ID from location lookup. Use location OR latitude and longitude together. longitude number Search center longitude. Requires latitude; omit location. max_price number Maximum price in the location's currency. min_price number Minimum price in the location's currency. query string required What to search for. radius number Search radius; defaults to kilometres. Converted to the nearest whole kilometre (minimum 1). Facebook may include results outside the area. radius_unit string Unit for radius; defaults to km. Requires radius. sort string Facebook search ordering. Newest ordering may contain timestamp inversions. /v1/facebook/marketplace/category Facebook Marketplace category
Read public Facebook Marketplace listings in a category by city or coordinates, with radius, price filters and newest-first ordering. Each successful request, including each continuation page, costs one credit. Keep all search inputs unchanged when continuing. Availability varies by region and Facebook access restrictions.
Parameters
category string required Category slug from a Marketplace URL, such as electronics, furniture, or vehicles. cursor string Continuation cursor from this endpoint. Expires after 30 minutes. Keep all search filters and limit unchanged. latitude number Search center latitude. Requires longitude; omit location. limit integer Maximum listings to return. Facebook may return fewer. Continue with next_cursor and keep all other inputs unchanged. location string Facebook city slug or an ID from location lookup. Use location OR latitude and longitude together. longitude number Search center longitude. Requires latitude; omit location. max_price number Maximum price in the location's currency. min_price number Minimum price in the location's currency. radius number Search radius; defaults to kilometres. Converted to the nearest whole kilometre (minimum 1). Facebook may include results outside the area. radius_unit string Unit for radius; defaults to km. Requires radius. sort string Facebook search ordering. Newest ordering may contain timestamp inversions. /v1/facebook/marketplace/item Facebook Marketplace listing
Get a public Facebook Marketplace listing, including its price, description, condition, seller, location and photos when available. Login-only or unavailable listings return an error.
Parameters
item_id string Numeric listing id, as an alternative to url. url string Facebook Marketplace listing URL. /v1/facebook/marketplace/locations Facebook Marketplace location lookup
Find Facebook Marketplace city, neighbourhood and postal-code identifiers and coordinates. Select the matching suggestion and use its id as location when searching. Specify country to disambiguate place names.
Parameters
country string Two-letter country code to narrow suggestions, for example GB or US. limit integer Maximum location suggestions. query string required City, neighbourhood or postal code to find. Frequently Asked Questions
Common questions about the Facebook Marketplace API
Which endpoints are included?
Search, category browsing, individual listing lookup and location lookup. Seller inventory is not currently supported.
How do I choose a location?
Use a Facebook city slug or an ID from location lookup, or supply latitude and longitude together. Choose one location method per request. Radius defaults to kilometres unless you specify miles; it is rounded to the nearest whole kilometre, with a minimum of one.
Will every result be inside my radius?
Facebook may include results outside the selected area. The response reports the search center and radius used. Listing coordinates may be unavailable, so results are not guaranteed to fall within a strict distance boundary.
How fresh are the results?
A search without a cursor fetches a new source page. Pagination can return previously fetched rows; fetched_at records when that page was retrieved. Facebook controls listing visibility and ordering, so newest-first results can contain timestamp inversions and do not guarantee immediate detection of every new listing.
How much does a request cost?
Each endpoint costs one credit per successful request. Each additional page is a separate request.
What happens when fields are unavailable?
Missing values are null. Delivery methods can include pickup, shipping or unknown. Creation timestamps come from Facebook when available. Prices are asking prices, not verified sale prices.
Do I need a Facebook account?
These endpoints use public access without a connected Facebook account. Availability varies by region and Facebook access restrictions. Login-only or unavailable listings return an error.
Explore More APIs
Discover other data sources available through Browsable
Reddit Scraper API
Powerful Reddit scraping API to extract posts, comments, user profiles, subreddit data, and more. Search Reddit globally, get trending content, access user activity, and retrieve subreddit metadata.
Vinted Scraper API
Extract Vinted marketplace data including listings, pricing, seller profiles, and sold items. Perfect for resale analytics and market research.
Instagram Scraper API
Scrape Instagram public profiles, posts, hashtags, and follower counts with our API. Extract social media data at scale for influencer analysis, brand monitoring, and research.