Facebook

List Facebook marketplace listings

Search Facebook Marketplace listings by keyword near a latitude and longitude.

get/v1/facebook/marketplace/search

Request

  • Base URL: https://api.socialfetch.dev
  • URL: https://api.socialfetch.dev/v1/facebook/marketplace/search
  • Auth: one of:
    • API key in header x-api-key
    • none

Query parameters

querystring required

Search query text for marketplace listings.

latnumber required

Latitude for the marketplace search location.

lngnumber required

Longitude for the marketplace search location.

radiusKmnumber

Optional search radius in kilometers.

minPricenumber

Optional minimum listing price. Must be less than or equal to maxPrice when both are set.

maxPricenumber

Optional maximum listing price. Must be greater than or equal to minPrice when both are set.

limitinteger

Optional number of listings to return (1–100). Prefer this over count.

sortBy'suggested' | 'distanceAscend' | 'creationTimeDescend' | 'priceAscend' | 'priceDescend'

Optional sort order for marketplace listings. suggested: Facebook's default relevance ranking. distanceAscend: nearest first. creationTimeDescend: newest listings first. priceAscend/priceDescend: lowest/highest price first.

deliveryMethod'all' | 'localPickup' | 'shipping'

Optional delivery method filter for marketplace listings.

condition'new' | 'usedLikeNew' | 'usedGood' | 'usedFair'

Optional item condition filter for marketplace listings.

dateListed'1' | '7' | '30' | 'all' | 'last24Hours' | 'last7Days' | 'last30Days'

Optional date-listed filter for marketplace listings. 1/last24Hours both mean the last 24 hours, 7/last7Days both mean the last 7 days, and 30/last30Days both mean the last 30 days — these are separate values Facebook accepts for the same window; prefer the named variants (last24Hours, last7Days, last30Days) for clarity. all applies no date filter.

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

Optional availability filter for marketplace listings.

cursorstring

Opaque pagination cursor returned by a previous response.

Response

Marketplace listings for the requested search.

Changes

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