SCscrapecreators
Facebook Marketplace

Marketplace Search

Changed on

Search Facebook Marketplace by keyword or browse a supported category without query. lat and lng are required. See category_id for allowed IDs. Pages usually contain about 24 listings and cost 1 credit, including empty filtered pages. Follow cursor as-is while has_next_page is true, keep inputs unchanged, and dedupe by listing id; keyword and category-only cursors cannot be mixed. Category-only date_listed, availability, and delivery_method filters apply to listing cards; condition requires a keyword. creation_time_descend is not strictly newest-first, and last_24_hours uses calendar days, not a rolling cutoff. creation_time (ISO 8601 UTC) and listing_date_text can be null.

get/v1/facebook/marketplace/search

Request

  • Base URL
    https://api.scrapecreators.com
  • URL
    https://api.scrapecreators.com/v1/facebook/marketplace/search
  • Auth
    API key in header x-api-key

Query parameters

querystring

Search keyword. Required unless category_id is provided.

latnumber required

Latitude for the search location

lngnumber required

Longitude for the search location

category_idstring

Category ID from listing results. Omit query to browse a category below.

Allowed IDs for keyword-free browsing:

  • Antiques: 393860164117441
  • Appliances: 678754142233400
  • Bicycles: 1658310421102081
  • Boats: 712638205822882
  • Electronics: 1792291877663080
  • Furniture: 1583634935226685
  • Garden: 800089866739547
  • Household: 1569171756675761
  • Tools: 1670493229902393
  • Trailers: 655837954899686
  • Vehicles: 807311116002614
  • Vehicles (alternate ID): 546583916084032

Other category IDs, including Housing, Food, and Services, require a keyword.

radius_kmnumber

Search radius in kilometers

min_pricenumber

Minimum listing price

max_pricenumber

Maximum listing price

sort_by'suggested' | 'distance_ascend' | 'creation_time_descend' | 'price_ascend' | 'price_descend'

Facebook Marketplace sort option. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages.

delivery_method'all' | 'local_pickup' | 'shipping'

Delivery filter

condition'new' | 'used_like_new' | 'used_good' | 'used_fair'

Condition filter

date_listed'all' | '1' | '7' | '30' | 'last_24_hours' | 'last_7_days' | 'last_30_days'

Facebook Marketplace date filter. Uses the same calendar-day buckets as the UI, so last_24_hours can include listings from the prior calendar day.

availability'available' | 'sold' | 'all'

Availability filter

cursorstring

Opaque pagination cursor returned from the previous response. Pass it back as-is.

Response

Successful response

Changes