UnifAPI Docs

Search Facebook Marketplace listings

Returns Facebook Marketplace listings for a keyword near a latitude and longitude, with price, condition and delivery filters. Paginate with `cursor`.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/facebook/marketplace/search

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

query*string

Search query text for marketplace listings.

Length1 <= length <= 512
category_id?string

Optional numeric Marketplace category id. Only listings in that category are returned. Listings report their category as category_id.

Length1 <= length
lat*string

Latitude for the marketplace search location.

Length1 <= length
lng*string

Longitude for the marketplace search location.

Length1 <= length
radius_km?string

Optional search radius in kilometers.

Length1 <= length
min_price?string

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

Length1 <= length
max_price?string

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

Length1 <= length
limit?string

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

Length1 <= length
sort_by?string

Optional sort order for marketplace listings. suggested: Facebook's default relevance ranking. distance_ascend: nearest first. creation_time_descend: newest listings first. price_ascend/price_descend: lowest/highest price first.

Value in

  • "suggested"
  • "distanceAscend"
  • "creationTimeDescend"
  • "priceAscend"
  • "priceDescend"
delivery_method?string

Optional delivery method filter for marketplace listings.

Value in

  • "all"
  • "localPickup"
  • "shipping"
condition?string

Optional item condition filter for marketplace listings.

Value in

  • "new"
  • "usedLikeNew"
  • "usedGood"
  • "usedFair"
date_listed?string

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.

Value in

  • "1"
  • "7"
  • "30"
  • "all"
  • "last24Hours"
  • "last7Days"
  • "last30Days"
availability?string

Optional availability filter for marketplace listings.

Value in

  • "available"
  • "sold"
  • "all"
cursor?string

Opaque pagination cursor from a previous response's pagination.next_cursor. Omit for the first page.

Length1 <= length <= 16384

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/facebook/marketplace/search?query=string&lat=string&lng=string"
{  "request_id": "string",  "data": [    {      "id": "string",      "url": "string",      "title": "string",      "price": {        "formatted_amount": "string",        "amount": 0,        "amount_with_offset_in_currency": 0      },      "strikethrough_price": {        "formatted_amount": "string",        "amount": 0,        "amount_with_offset_in_currency": 0      },      "location": {        "city": "string",        "state": "string",        "display_name": "string",        "city_page_id": "string"      },      "primary_photo": {        "id": "string",        "url": "string"      },      "category_id": "string",      "delivery_types": [        "string"      ],      "status": {        "is_hidden": true,        "is_live": true,        "is_pending": true,        "is_sold": true,        "is_viewer_seller": true      },      "story_type": "string",      "story_key": "string"    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}