Skip to main content
GET
Search
💳 1 credit per request
Need a lat / lng for a city? Run Location Search first to grab them.

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

query
string
required

Search keyword

Example:

"bike"

lat
number
required

Latitude for the search location

Example:

30.2677

lng
number
required

Longitude for the search location

Example:

-97.7475

radius_km
number

Search radius in kilometers

Example:

65

min_price
number

Minimum listing price

Example:

100

max_price
number

Maximum listing price

Example:

500

count
integer

Number of listings to return

Example:

24

sort_by
enum<string>

Sort order

Available options:
suggested,
distance_ascend,
creation_time_descend,
price_ascend,
price_descend
Example:

"creation_time_descend"

delivery_method
enum<string>

Delivery filter

Available options:
all,
local_pickup,
shipping
Example:

"local_pickup"

condition
enum<string>

Condition filter

Available options:
new,
used_like_new,
used_good,
used_fair
Example:

"used_good"

date_listed
enum<string>

Date listed filter

Available options:
all,
1,
7,
30,
last_24_hours,
last_7_days,
last_30_days
Example:

"7"

availability
enum<string>

Availability filter

Available options:
available,
sold,
all
Example:

"available"

cursor
string

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

Example:

"eyJwZyI6MCwiYjJjIjp7..."

Response

Successful response

Key Response Fields:

  • data.listings[0].id: Marketplace listing identifier
  • data.listings[0].url: Direct link to the listing on Facebook
  • data.listings[0].title: Listing title
  • data.listings[0].price.amount: Numeric price value
  • data.listings[0].price.formatted_amount: Display price string (e.g. "£50")
  • data.listings[0].strikethrough_price: Original price before discount, or null
  • data.listings[0].location.city / display_name: Listing location
  • data.listings[0].primary_photo.url: Primary listing image URL
  • data.listings[0].is_sold: Whether the item has been sold
  • data.listings[0].delivery_types: Available delivery methods (e.g. IN_PERSON)
  • data.cursor: Opaque token — pass back as cursor to get the next page
  • data.has_next_page: Whether more results are available