Facebook Marketplace

Marketplace Search

Searches Facebook Marketplace listings by keyword and lat/lng. Pass category_id to restrict results to the numeric Facebook Marketplace category ID returned on listing results. Supports pagination with the returned cursor. Pass the cursor value back as-is. When sort_by is creation_time_descend, Facebook can still return slightly different ordering between identical requests. For alerting/new-item workflows, scrape multiple pages and dedupe by listing id instead of relying on page 1 item order being identical every run.

get/v1/facebook/marketplace/search

Query parameters

querystring required

Search keyword

category_idstring

Numeric Facebook Marketplace category ID. Listing results include this value as category_id.

latnumber required

Latitude for the search location

lngnumber required

Longitude for the search location

radius_kmnumber

Search radius in kilometers

min_pricenumber

Minimum listing price

max_pricenumber

Maximum listing price

countnumber

Number of listings to return

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

Sort order

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'

Date listed filter

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

Availability filter

cursorstring

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

Response

Successful response

Changes

No recorded changes to this endpoint across all 1 revision of this API.