InsightSocial APIFacebook Marketplace Search API reference
Your first 10 calls are free, no card needed. Pricing and FAQ
Get a free API keycurl "https://api.insightsocial.app/v1/facebook/marketplace/search?query=bike&lat=40.7128&lng=-74.0060" \ -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
Returns Facebook Marketplace listings near a lat/lng, each with title, price, location, photo, delivery types, and sold or live flags.
Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Schema 2.
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.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Search keyword (e.g., bike, couch).
Latitude of the search location.
Longitude of the search location.
Search radius in kilometers.
Minimum listing price.
Maximum listing price.
Number of listings to return per page.
Sort order for results.
Value in
- "suggested"
- "distance_ascend"
- "creation_time_descend"
- "price_ascend"
- "price_descend"
Delivery filter: local pickup only, shipping only, or all.
Value in
- "all"
- "local_pickup"
- "shipping"
Filter listings by item condition.
Value in
- "new"
- "used_like_new"
- "used_good"
- "used_fair"
Filter by listing recency (relative window or numeric day count).
Value in
- "all"
- "1"
- "7"
- "30"
- "last_24_hours"
- "last_7_days"
- "last_30_days"
Filter by listing status: available, sold, or all.
Value in
- "available"
- "sold"
- "all"
Opaque pagination cursor returned by the previous response: forward as-is.
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.
Value in
- "1"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.insightsocial.app/v1/facebook/marketplace/search?query=string&lat=string&lng=string"{ "success": true, "platform": "string", "endpoint": "string", "schema_version": "2", "pagination": { "next_cursor": "string", "has_more": true, "page_size": 0, "stopped_at": "since" }, "unavailable": [ "string" ], "credits_used": 0, "credits_remaining": 0, "request_id": "string", "cached": true, "idempotent_replay": true, "charge_reason": "string", "free_call": true, "data": { "property1": null, "property2": null }}