Search Facebook Marketplace listings
Search Facebook Marketplace listings by keyword near a latitude and longitude.
Headers
Get your API keyAPI key (`sfk_...`)
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. Must be less than or equal to `maxPrice` when both are set.
≥ 0
Optional maximum listing price. Must be greater than or equal to `minPrice` when both are set.
≥ 0
Optional number of listings to return (1–100). Prefer this over `count`.
≥ 1 · ≤ 100
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.
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. `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.
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
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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/facebook/marketplace/search?query=bike&lat=30.2677&lng=-97.7475" \
-H "x-api-key: YOUR_API_KEY"Responses
Marketplace listings for the requested search.