Facebook Marketplace Browse

Browse or search Facebook Marketplace listings by city.

GET/api/v1/facebook/marketplace-browse

Alpha: this endpoint is new and its response fields may still change.

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Request parameters

Browse or search Facebook Marketplace listings by city.

Parameter	Type	Description
`limit`	integer	Maximum listings per response; fewer may be available.Default: 20.Range: 1 to 26.
`location`	string	Marketplace city slug or numeric city ID, such as austin or london. Required for keyword search and radius filtering.
`query`	string	Listing search keywords. Supply location to keep the search geography fixed.Up to 200 characters.
`radius_km`	integer	Search radius in kilometers, from 1 to 500. Requires location; defaults to 65 km when omitted. Shipped or promoted listings may fall outside this radius.Range: 1 to 500.
`min_price`	number	Minimum listing price in local currency units. Requires query and location.Range: 0 to 10000000.
`max_price`	number	Maximum listing price in local currency units, at least min_price. Requires query and location.Range: 0 to 10000000.
`sort_by`	"price_ascend" \| "price_descend" \| "creation_time_descend"	Search ordering: lowest price, highest price or newest listings. Requires query and location.
`condition`	"new" \| "used_like_new" \| "used_good" \| "used_fair"	Item condition for keyword search. Requires query and location.
`days_since_listed`	integer	Restrict keyword search to recent listings, from 1 to 30 days. Requires query and location.Range: 1 to 30.
`continuation_token`	string	Token from pagination.continuation_token in the preceding response. Repeat the same query, location and filters; limit may change. Keyword search only. Later requests may fail or be rate limited.Up to 32,768 characters.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: listings. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/facebook/marketplace-browse?location=austin&query=bicycle&radius_km=20&min_price=10&max_price=200&limit=20" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "location": "austin",
  "query": "bicycle",
  "radius_km": 20,
  "min_price": 10,
  "max_price": 200,
  "limit": 20
});
const res = await fetch(`https://serpfast.com/api/v1/facebook/marketplace-browse?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "location": "austin",
  "query": "bicycle",
  "radius_km": 20,
  "min_price": 10,
  "max_price": 200,
  "limit": 20
}
res = requests.get(
    "https://serpfast.com/api/v1/facebook/marketplace-browse",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())