← API Store
SocialFacebook
Facebook Marketplace search
GET /facebook/v1/marketplace/searchThe 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: bike |
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
{
"buy_location": {
"buy_location": {
"id": "108424279189115",
"location": {
"reverse_geocode": {
"city": "New York"
}
}
}
},
"cached": false,
"city": "New York",
"count": 24,
"credits_used": 1,
"listings": [
{
"category_id": "1658310421102081",
"created_at": "2026-10-22T01:58:55.000Z",
"custom_title": null,
"delivery": [
"IN_PERSON",
"DOOR_PICKUP"
],
"id": "939150895655173",
"image": "https://scontent.fgyd4-2.fna.fbcdn.net/v/t39.84726-6/858308745_1458378809544409_1043596443854990520_n.jpg?stp=c89.0.540.540a_dst-jpg_p180x54…",
"images": [
"https://scontent.fgyd4-2.fna.fbcdn.net/v/t39.84726-6/858308745_1458378809544409_1043596443854990520_n.jpg?stp=c89.0.540.540a_dst-jpg_p180x54…"
],
"is_hidden": false,
"is_live": true,
"is_pending": false,
"is_shipping": true,
"is_sold": false,
"location": {
"city": "Bronx",
"state": "NY",
"text": "New York, New York"
},
"origin_group": null,
"price": {
"amount": 50,
"currency": null,
"formatted": "$50"
},
"seller": {
"id": "pfbid02ZKuM1wjzBSDPYfd9x6SfzyzapBX38H8kcrUbW9G7wcLsgFx1BiPXzG9eqZZcCWP5l",
"name": "Tania Candelario"
},
"story_id": null,
"strikethrough_price": null,
"sub_titles": [],
"title": "Huffy bike",
"url": "https://www.facebook.com/marketplace/item/939150895655173/",
"video": null
},
{
"category_id": "1658310421102081",
"created_at": "2026-10-21T22:53:51.000Z",
"custom_title": null,
"delivery": [
"IN_PERSON",
"DOOR_PICKUP"
],
"id": "2206435059966494",
"image": "https://scontent.fgyd4-2.fna.fbcdn.net/v/t39.84726-6/855508353_1406271924553936_9070625478757325093_n.jpg?stp=c0.87.526.526a_dst-jpg_p526x39…",
"images": [
"https://scontent.fgyd4-2.fna.fbcdn.net/v/t39.84726-6/855508353_1406271924553936_9070625478757325093_n.jpg?stp=c0.87.526.526a_dst-jpg_p526x39…"
],
"is_hidden": false,
"is_live": true,
"is_pending": false,
"is_shipping": true,
"is_sold": false,
"location": {
"city": "Ridgewood",
"state": "NY",
"text": "New York, New York"
},
"origin_group": null,
"price": {
"amount": 160,
"currency": null,
"formatted": "$160"
},
"seller": {
"id": "61565796641076",
"name": "Michael Lakota"
},
"story_id": null,
"strikethrough_price": null,
"sub_titles": [],
"title": "Raleigh C200 Hybrid Bike",
"url": "https://www.facebook.com/marketplace/item/2206435059966494/",
"video": "2111506833060674"
},
"… 22 more"
],
"location": "nyc",
"next_cursor": null,
"query": "bike"
} Response fields (48)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.buy_location | object |
$.buy_location.buy_location | object |
$.buy_location.buy_location.id | string |
$.buy_location.buy_location.location | object |
$.buy_location.buy_location.location.reverse_geocode | object |
$.buy_location.buy_location.location.reverse_geocode.city | string |
$.cached | boolean |
$.city | string |
$.count | integer |
$.credits_used | integer |
$.listings | array |
$.listings[] | object | string |
$.listings[].category_id | string |
$.listings[].created_at | string |
$.listings[].custom_title | null |
$.listings[].delivery | array |
$.listings[].delivery[] | string |
$.listings[].id | string |
$.listings[].image | string |
$.listings[].images | array |
$.listings[].images[] | string |
$.listings[].is_hidden | boolean |
$.listings[].is_live | boolean |
$.listings[].is_pending | boolean |
$.listings[].is_shipping | boolean |
$.listings[].is_sold | boolean |
$.listings[].location | object |
$.listings[].location.city | string |
$.listings[].location.state | string |
$.listings[].location.text | string |
$.listings[].origin_group | null |
$.listings[].price | object |
$.listings[].price.amount | integer |
$.listings[].price.currency | null |
$.listings[].price.formatted | string |
$.listings[].seller | object |
$.listings[].seller.id | string |
$.listings[].seller.name | string |
$.listings[].story_id | null |
$.listings[].strikethrough_price | null |
$.listings[].sub_titles | array |
$.listings[].title | string |
$.listings[].url | string |
$.listings[].video | null | string |
$.location | string |
$.next_cursor | null |
$.query | string |