Marketplace search
Marketplace listings near a place, as Facebook's logged-out Marketplace search finds them: the first 24. Logged out, Facebook shows no more.
GET/v1/facebook/marketplace/search1 creditHeaders
Get your API keyx-api-key*stringrequiredheaderYour API key, made in the dashboard.
Parameters
7query*stringrequiredqueryWords to search for.
min 1 chars · max 200 chars · example: bike
lat*numberrequiredqueryWhere to search from: latitude (the locations search's latitude).
min -90 · max 90 · example: 30.2677
lng*numberrequiredqueryWhere to search from: longitude.
min -180 · max 180 · example: -97.7475
radius_kmintegeroptionalqueryHow far from there, in kilometres.
default: 40 · min 1 · max 500
min_priceintegeroptionalqueryOnly listings at this price or more.
min 0
max_priceintegeroptionalqueryOnly listings at this price or less.
min 0
sortenumoptionalqueryFacebook's own order (suggested), newest first, nearest first, or by price.
one of: suggested, newest, nearest, price_low, price_high · default: suggested
Response fields
31dataarrayThe result: one object, or a list for the endpoints that return several.
data[].idstringFacebook's id for the Marketplace listing: digits, written as text. The items endpoint takes it.
data[].urlstringThe listing's page.
data[].titlestringnullableIts title.
data[].pricestringnullableIts price as Facebook writes it ($220).
data[].amountnumbernullableIts price as a number.
data[].currencystringnullableThe price's currency (USD). Only the items endpoint gives it.
data[].descriptionstringnullableWhat the seller wrote. Only the items endpoint gives it.
data[].conditionstringnullableIts condition (Used – good). Only the items endpoint gives it.
data[].locationstringnullableWhere it is (Austin, TX).
data[].latitudenumbernullableWhere it is: latitude. Only the items endpoint gives it.
data[].longitudenumbernullableWhere it is: longitude. Only the items endpoint gives it.
data[].created_atstringnullableWhen it was listed.
format: date-time
data[].soldbooleannullableWhether it's sold.
data[].pendingbooleannullableWhether a sale is pending. Only the items endpoint gives it.
data[].sellerstringnullableThe seller's name.
data[].seller_idstringnullableThe seller's id.
data[].category_idstringnullableIts Marketplace category's id.
data[].imagestringnullableIts first photo's link.
data[].imagesstring[]nullableIts photos' links. Only the items endpoint gives them.
pageobjectnullablePaging, for the endpoints that page; null for the others.
page.next_cursorstringnullableSend it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.
page.has_morebooleanoptionalWhether another page follows.
default: false
metaobjectAbout this call.
meta.platformstringThe platform: reddit, threads, tiktok or youtube.
meta.endpointstringThe endpoint's name, such as channel_videos.
meta.paramsobjectThe call's parameters, defaults included. Parameters without a value, and the cursor, are left out.
meta.request_idstringThis call's id. Quote it when you report a problem.
meta.api_versionstringThe API version that answered.
meta.fetched_atstringWhen the data was fetched from the platform (UTC).
format: date-time
meta.cachedbooleanoptionalWhether it came from our cache; fetched_at says how old it is.
default: false
Code example
curl -X GET 'https://api.socialparse.dev/v1/facebook/marketplace/search?query=bike&lat=30.2677&lng=-97.7475' \ -H 'x-api-key: YOUR_API_KEY'Responses
Successful Response
{ "data": [ { "id": "string", "url": "string", "title": "string", "price": "string", "amount": 0, "currency": "string", "description": "string", "condition": "string", "location": "string", "latitude": 0, "longitude": 0, "created_at": "2019-08-24T14:15:22Z", "sold": true, "pending": true, "seller": "string", "seller_id": "string", "category_id": "string", "image": "string", "images": [ "string" ] } ], "page": { "next_cursor": "string", "has_more": false }, "meta": { "platform": "string", "endpoint": "string", "params": { "property1": "string", "property2": "string" }, "request_id": "string", "api_version": "string", "fetched_at": "2019-08-24T14:15:22Z", "cached": false }}