Search APIs
Loading…
← API Store
Social

Facebook

Facebook

Facebook Marketplace search

GET /facebook/v1/marketplace
Test this endpoint

The 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

NameTypeDescription
qstringSearch text (optional when category is given). Example: electronics
locationstringA Marketplace city slug (nyc, sanfrancisco, la, …) or a place name ("Austin, TX"); default nyc. Example: sanfrancisco
min_pricenumberMinimum price, in the listing currency.
max_pricenumberMaximum price.
radius_kmintegerSearch radius around the location, km (1-500).
sortbest_match | newest | oldest | price_low | price_high | distance | distance_farbest_match (default), newest, oldest, price_low, price_high, distance, distance_far.
days_since_listedintegerListed within the last 1, 7 or 30 days.
conditionstringItem condition, comma-separated: new, used_like_new, used_good, used_fair.
deliverylocal_pickup | shippinglocal_pickup or shipping.
exactbooleantrue: only listings that match the words exactly.
categorystringWithout 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.listingsarray
$.listings[]object | string
$.listings[].category_idstring
$.listings[].created_atstring
$.listings[].currencynull
$.listings[].delivery_typesarray
$.listings[].delivery_types[]string
$.listings[].idstring
$.listings[].imagestring
$.listings[].is_pendingboolean
$.listings[].is_soldboolean
$.listings[].locationstring
$.listings[].pricenull
$.listings[].price_amountstring
$.listings[].sellerobject
$.listings[].seller.idstring
$.listings[].seller.namestring
$.listings[].strikethrough_pricenull
$.listings[].titlestring
$.listings[].urlstring
$.locationnull
$.querystring