← API Store
SocialFacebook
Facebook Marketplace search
GET /facebook/v1/marketplaceThe server-rendered Marketplace search page: 24 listings. Logged out, Facebook's Marketplace search API answers with empty pages (checked Oct 2026), so there are no further pages; narrow the search with the filters instead. All filters are applied by Facebook. Without q, category browses a category with the same filters.
Every response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
q | string | Search text (optional when category is given). Example: electronics |
location | string | A Marketplace city slug (nyc, sanfrancisco, la, …) or a place name ("Austin, TX"); default nyc. Example: sanfrancisco |
min_price | number | Minimum price, in the listing currency. |
max_price | number | Maximum price. |
radius_km | integer | Search radius around the location, km (1-500). |
sort | best_match | newest | oldest | price_low | price_high | distance | distance_far | best_match (default), newest, oldest, price_low, price_high, distance, distance_far. |
days_since_listed | integer | Listed within the last 1, 7 or 30 days. |
condition | string | Item condition, comma-separated: new, used_like_new, used_good, used_fair. |
delivery | local_pickup | shipping | local_pickup or shipping. |
exact | boolean | true: only listings that match the words exactly. |
category | string | Without q: browse a Marketplace category instead (vehicles, electronics, propertyrentals, apparel, homegoods, …). |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 14,
"credits_used": 1,
"listings": [
{
"category_id": "1658310421102081",
"created_at": "2026-10-23T18:31:06.000Z",
"currency": null,
"delivery_types": [
"IN_PERSON",
"PUBLIC_MEETUP"
],
"id": "2963002064059641",
"image": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.84726-6/863354530_1687643846258407_2524435719423800305_n.jpg?stp=c43.0.260.260a_dst-jpg_p261x260_…",
"is_pending": false,
"is_sold": false,
"location": "San Francisco, CA",
"price": null,
"price_amount": "150.00",
"seller": {
"id": "pfbid0FF3rbWXXi4YRFukUTX6SzXcVpRoc5FgCJqweMSeKk86rFddCWixESHHwJLzhayEQl",
"name": "Vincent Zheng"
},
"strikethrough_price": null,
"title": "Ancheer Gladiator Electric Mountain Bike (Motor Issue / Noise)",
"url": "https://www.facebook.com/marketplace/item/2963002064059641/"
},
{
"category_id": "1658310421102081",
"created_at": "2026-10-18T13:44:21.000Z",
"currency": null,
"delivery_types": [
"IN_PERSON",
"DOOR_PICKUP"
],
"id": "1134501135980560",
"image": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.84726-6/853714201_1083904828006109_7315105887646411559_n.jpg?stp=c0.43.261.261a_dst-jpg_p261x260_…",
"is_pending": false,
"is_sold": false,
"location": "San Francisco, CA",
"price": null,
"price_amount": "100.00",
"seller": {
"id": "pfbid0jkP8Jw6i8tMDnmAkP7fxrpfy7sRfb3WB3XbtBB8JoELdcwpRpQFap7XJKNPdYk8tl",
"name": "Courtney Jordan"
},
"strikethrough_price": null,
"title": "Zagster white bike",
"url": "https://www.facebook.com/marketplace/item/1134501135980560/"
},
"… 12 more"
],
"location": null,
"query": "bike"
} Response fields (26)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.listings | array |
$.listings[] | object | string |
$.listings[].category_id | string |
$.listings[].created_at | string |
$.listings[].currency | null |
$.listings[].delivery_types | array |
$.listings[].delivery_types[] | string |
$.listings[].id | string |
$.listings[].image | string |
$.listings[].is_pending | boolean |
$.listings[].is_sold | boolean |
$.listings[].location | string |
$.listings[].price | null |
$.listings[].price_amount | string |
$.listings[].seller | object |
$.listings[].seller.id | string |
$.listings[].seller.name | string |
$.listings[].strikethrough_price | null |
$.listings[].title | string |
$.listings[].url | string |
$.location | null |
$.query | string |