Search Facebook Marketplace listings
Search Facebook Marketplace listings by keyword near a latitude and longitude.
Operation
/v1/facebook/marketplace/searchHeaders
API key (`sfk_...`)
Parameters
Search query text for marketplace listings.
min 1 chars · max 512 chars
Latitude for the marketplace search location.
≥ -90 · ≤ 90
Longitude for the marketplace search location.
≥ -180 · ≤ 180
Optional search radius in kilometers.
≥ 0
Optional minimum listing price.
≥ 0
Optional maximum listing price.
≥ 0
Optional number of listings to return.
≥ 1 · ≤ 100
Optional sort order for marketplace listings.
one of: suggested, distanceAscend, creationTimeDescend, priceAscend, priceDescend
Optional delivery method filter for marketplace listings.
one of: all, localPickup, shipping
Optional item condition filter for marketplace listings.
one of: new, usedLikeNew, usedGood, usedFair
Optional date-listed filter for marketplace listings.
one of: 1, 7, 30, all, last24Hours, last7Days, last30Days
Optional availability filter for marketplace listings.
one of: available, sold, all
Opaque pagination cursor returned by a previous response.
min 1 chars
Response fields
Endpoint-specific response payload.
Search query string evaluated for this response.
Location parameters evaluated for this response.
Latitude evaluated for this search.
Longitude evaluated for this search.
Search radius in kilometers when provided.
Listings returned for this page.
Stable marketplace listing identifier.
min 1 chars
Canonical public listing URL when available.
Listing title.
min 1 chars
Displayed price for the listing.
Formatted price label when available.
Numeric price amount when available.
Price amount with currency offset when available.
Strikethrough or original price when available.
Formatted price label when available.
Numeric price amount when available.
Price amount with currency offset when available.
Location summary for the listing.
City name when available.
State or region when available.
Human-readable location label when available.
Location page identifier when available.
Primary photo for the listing.
Primary photo identifier when available.
Primary photo URL when available.
Marketplace category identifier when available.
Delivery options reported for the listing.
Listing status flags.
Whether the listing is hidden when available.
Whether the listing is live when available.
Whether the listing is pending when available.
Whether the listing is sold when available.
Whether the viewer is the seller when available.
Story type metadata when available.
Story key metadata when available.
Number of listings returned in this response.
≥ 0
Pagination information for the current response.
Cursor to pass in the next request when another page is available; otherwise null.
Whether another page of listings can be requested.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Marketplace listings for the requested search.
Error codes