facebook

Marketplace › Search

Returns Facebook Marketplace listings near a lat/lng, each with title, price, location, photo, delivery types, and sold or live flags.

Use it to find listings in an area; get lat and lng from marketplace/location/search, and de-duplicate by listing id since ordering can shift.

10 credits per call.

Paginates by cursor: see Pagination.

get/v1/facebook/marketplace/search

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/facebook/marketplace/search
  • Auth: API key in header x-api-key

Query parameters

querystring required
Example:bike

Search keyword (e.g., bike, couch).

latstring required
Example:40.7128

Latitude of the search location.

lngstring required
Example:-74.0060

Longitude of the search location.

radius_kminteger

Search radius in kilometers.

min_priceinteger

Minimum listing price.

max_priceinteger

Maximum listing price.

countinteger

Number of listings to return per page.

sort_by'suggested' | 'distance_ascend' | 'creation_time_descend' | 'price_ascend' | 'price_descend'

Sort order for results.

delivery_method'all' | 'local_pickup' | 'shipping'

Delivery filter: local pickup only, shipping only, or all.

condition'new' | 'used_like_new' | 'used_good' | 'used_fair'

Filter listings by item condition.

date_listed'all' | '1' | '7' | '30' | 'last_24_hours' | 'last_7_days' | 'last_30_days'

Filter by listing recency (relative window or numeric day count).

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

Filter by listing status: available, sold, or all.

cursorstring

Opaque pagination cursor returned by the previous response: forward as-is.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
dataConventionsData required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

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