Facebook Marketplace

Search Marketplace listings

Search public Marketplace listings at explicit coordinates, with price, condition, delivery, date, availability and sorting filters. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/facebook/marketplace/search

Request

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

Query parameters

querystring required

Public keyword/location query, 1–512 characters.

latstring required

Search latitude, -90 to 90.

lngstring required

Search longitude, -180 to 180.

category_idstring

Numeric Marketplace category ID.

radius_kmstring

Search radius, 0–500 kilometers; default 50.

min_pricestring

Minimum price in major currency units, at most max_price.

max_pricestring

Maximum price in major currency units.

countstring

Marketplace result count, 1–100. If limit is also sent, the values must agree.

limitstring

Maximum result count: 1–100 for Marketplace or 1–50 for full reels. Full reels walk at most five pages within the same request budget.

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

Native group or Marketplace ordering. See the enumerated request schema.

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

all, local_pickup or shipping.

condition'new' | 'used_like_new' | 'used_good' | 'used_fair' | 'usedLikeNew' | 'usedGood' | 'usedFair'

new, used_like_new/usedLikeNew, used_good/usedGood or used_fair/usedFair.

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

all, 1, 7, 30, last_24_hours, last_7_days or last_30_days.

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

available, sold or all.

cursorstring

Opaque continuation from this service. Preserve it exactly; cursors are source- and route-specific.

radiusKmstring

Camel-case alias for radius_km. Do not send both.

minPricestring

Camel-case alias for min_price. Do not send both.

maxPricestring

Camel-case alias for max_price. Do not send both.

sortBy'suggested' | 'distanceAscend' | 'creationTimeDescend' | 'priceAscend' | 'priceDescend'

Ordering names, normalized to the native Facebook sort.

deliveryMethod'all' | 'localPickup' | 'shipping'

all, localPickup or shipping; do not combine with delivery_method.

dateListed'all' | '1' | '7' | '30' | 'last24Hours' | 'last7Days' | 'last30Days'

Camel-case date windows: all, 1, 7, 30, last24Hours, last7Days or last30Days.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

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