Skip to main content
GET
Marketplace Category & Reference
Browse a Marketplace category feed — vehicles, propertyrentals, electronics, apparel and the rest — scoped to one location, with price and sort filters. Returns the same MarketplaceListing shape as /marketplace/search. This page also documents the two free reference endpoints that list the valid location and category slugs. Credits: 5 (category browse) · 0 (/marketplace/locations, /marketplace/categories)

Authorization

string
required
Your ScrapeBadger API key.

Path Parameters

string
required
Marketplace category slug — one of vehicles, propertyrentals, propertyforsale, apparel, electronics, entertainment, family, free, garden, hobbies, homegoods, homeimprovement, instruments, officesupplies, petsupplies, sportinggoods, toys.

Query Parameters

string
default:"nyc"
A Facebook Marketplace location slug (nyc, la, london) or a numeric Facebook place id. Human-readable names such as Durham, UK return a 400 invalid_location rather than silently browsing a different place — see Location targeting. Facebook honours radius on search only, so there is no radius here.
integer
Minimum price.
integer
Maximum price.
string
One of best_match, price_ascend, price_descend, distance_ascend, creation_time_descend.
string
Pagination cursor — the end_cursor from a previous response.

Response

MarketplaceListing[]
Same shape as /marketplace/searchid, title, url, price_formatted, price_amount, currency, primary_photo, creation_time_utc, created_at, location_text, city_page_id, city, state, latitude, longitude, subtitles[], delivery_types[], attributes, is_sold, is_pending, is_live and seller.
integer
Number of listings in this page.
string
Pass as after for the next page.
boolean
Whether more listings are reachable.
string
Echoes the category slug that was browsed.
string
The location value you sent.
ResolvedLocation
The location Facebook actually browsed: slug, latitude, longitude and radius. Verify it against your target geography before ingesting.
Vertical categories fill attributes with vertical-specific keys — vehicle make / model / mileage on vehicles, beds / baths on propertyrentals and propertyforsale. subtitles[] carries the same metadata as Facebook’s own display bullets.

Example

Response

Reference endpoints

Both are free (0 credits) and hit no Facebook surface.

GET /v1/facebook/marketplace/locations

object[]
{ slug, name } pairs for the high-traffic Marketplace cities — nyc, la, chicago, houston, seattle, sanfrancisco, miami, atlanta, london, toronto, sydney. Not exhaustive: any city slug Facebook accepts works as a location.
integer
Number of locations returned.

GET /v1/facebook/marketplace/categories

object[]
{ slug, name } pairs for every Marketplace top-level category.
integer
Number of categories returned.
cURL
Response