Search APIs
Loading…
← API Store
Social

Facebook

Facebook

Facebook Marketplace search

GET /facebook/v1/marketplace/search
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: bike
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

{
  "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_locationobject
$.buy_location.buy_locationobject
$.buy_location.buy_location.idstring
$.buy_location.buy_location.locationobject
$.buy_location.buy_location.location.reverse_geocodeobject
$.buy_location.buy_location.location.reverse_geocode.citystring
$.cachedboolean
$.citystring
$.countinteger
$.credits_usedinteger
$.listingsarray
$.listings[]object | string
$.listings[].category_idstring
$.listings[].created_atstring
$.listings[].custom_titlenull
$.listings[].deliveryarray
$.listings[].delivery[]string
$.listings[].idstring
$.listings[].imagestring
$.listings[].imagesarray
$.listings[].images[]string
$.listings[].is_hiddenboolean
$.listings[].is_liveboolean
$.listings[].is_pendingboolean
$.listings[].is_shippingboolean
$.listings[].is_soldboolean
$.listings[].locationobject
$.listings[].location.citystring
$.listings[].location.statestring
$.listings[].location.textstring
$.listings[].origin_groupnull
$.listings[].priceobject
$.listings[].price.amountinteger
$.listings[].price.currencynull
$.listings[].price.formattedstring
$.listings[].sellerobject
$.listings[].seller.idstring
$.listings[].seller.namestring
$.listings[].story_idnull
$.listings[].strikethrough_pricenull
$.listings[].sub_titlesarray
$.listings[].titlestring
$.listings[].urlstring
$.listings[].videonull | string
$.locationstring
$.next_cursornull
$.querystring