SocialScrape
Get an API key
Facebook Marketplace search API
  1. Docs
  2. Facebook
  3. Facebook Marketplace search API

Facebook Marketplace search API

Search Marketplace by keyword, or browse a category without a keyword.

GET /v1/facebook/marketplace/search

GET /v1/facebook/marketplace/search

Search Marketplace by keyword, or browse a category without a keyword. Needs a place: lat and lng (see marketplace/location/search) or a location name. About 24 listings a page; keep the inputs unchanged while paging and de-duplicate by listing id.

  • Cost: 1 credit
  • Cache: Results are kept up to 30 days; send max_age_days to reuse them for free.
  • Timeout: A request still running after about 25 seconds answers 202 with a job to poll (Batch and jobs).

Parameters#

NameTypeRequiredDescription
querystringnoSearch keyword. Required unless category_id is given. Also accepted as keyword, q.
locationstringone ofCity or area to search around ("Austin, TX").
latnumberone ofLatitude of the search centre. Also accepted as latitude.
lngnumbernoLongitude of the search centre. Also accepted as longitude.
category_idstringnoMarketplace category id. Without a keyword only these browse: Antiques 393860164117441, Appliances 678754142233400, Bicycles 1658310421102081, Boats 712638205822882, Electronics 1792291877663080, Furniture 1583634935226685, Garden 800089866739547, Household 1569171756675761, Tools 1670493229902393, Trailers 655837954899686, Vehicles 807311116002614 (or 546583916084032). Other ids need a keyword.
radius_kmnumbernoSearch radius in km. Also accepted as radius.
min_pricenumbernoLowest listing price.
max_pricenumbernoHighest listing price.
sortstringnoOrder of results. Changing it restarts the cursor chain. One of relevance, distance, newest, price_low, price_high. Also accepted as sort_by, sortBy, order. Also accepted values: suggested for relevance, distance_ascend for distance, creation_time_descend for newest, price_ascend for price_low, price_descend for price_high.
delivery_methodstringnoDelivery filter. One of all, local_pickup, shipping.
conditionstringnoCondition filter. One of new, used_like_new, used_good, used_fair.
date_listedstringnoListed within. Uses the UI's calendar-day buckets. One of all, day, week, month. Also accepted values: 1 for day, 7 for week, 30 for month, last_24_hours for day, last_7_days for week, last_30_days for month.
availabilitystringnoAvailability filter. One of available, sold, all.

Send at least one of lat, location. If you send several, the first listed is used and the rest are ignored.

Every request also accepts:

  • cursor: the cursor from the previous page (Pagination).
  • trim: true for a smaller response without null fields and extra.
  • raw: true to also get the platform's original object as raw.
  • max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).

Example request#

Set your key in the environment first (see Authentication).

1curl -G "https://api.socialscrape.dev/v1/facebook/marketplace/search" \2  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3  --data-urlencode "query=bike" \4  --data-urlencode "lat=30.2672" \5  --data-urlencode "lng=-97.7431" \6  --data-urlencode "cursor=eyJrIjoibWFya2V0IiwibGF0IjozMC4yNjcyLCJsbmciOi05Ny43NDMxLCJhZnRlciI6IntcInBnXCI6MCxcImIyY1wiOntcImJyXCI6XCJcIixcIml0XCI6MCxcImhtc3JcIjpmYWxzZSxcInRiaVwiOjB9LFwiYzJjXCI6e1wiYnJcIjpcIkFicGxreFpHQmZ2R0M1a1ZXbV81Q1F2RFdUdTNRSm9sMnI4NmJtZG1yNEdrZW1PTVFXemdJTERXbHNJSTlBaU92WGdWRFoyLVFvZDRlNDdSNFFDM2Zjd2JvRUNyWjBKTXJxVm9jckNxUGJMdjVXV3U2NDJOS25zR1pCMEVkNl9kaE5NTWgxeXNUbXhrSzYxeWxFQmFIUnRkNTdZX0dxY3hkTVdUTFgtaXh6NE5BNkNGVUtoTlZzQUN1SXZIQXFleHA4OFdnWXZ2VE5OYTJ1YzJXMHo1Y3E1SC1NZmlrR291MmpIQjM3YXRobm9rclo5UTlVTmlpNmtqME5tNTRuNTJUUF83cUJ5UkowdWhVWDVtUWh3Y0pqdWoxdjBGWjQwVU1iLVdXTnNNUUNWVFlKYkM0ZXhrWFVEb0xES0YxVG8wdmFTajhoVVpyOWxhZ0c2ZTJBN212Z196eFpBdWJ4ODRLQUhpTmxrNFliQ3pFZXhsSFdVbmdlQk1QVFlIUkhVQ19Ucm9mZ204NG5GLTRodGxzbXNFdWpsTmd0VEtMbkxfVmQ5OFVLZXpHS0tzbnVnT1lsZUdJbmVoZV9oTE5XdGFvb2Y4dDBEc2hVc0NIbWFLNFFTNUxXNWhraFZaRXlsN0lVT1JWVWxYbFpqQnlaMHBYM3RmT0NaU2twaUwtRzdKelJhU0FqR1U0QlBXd2xZM2hpR2U0dDE3Y1NwZS1Na1BWZmR6cTJnRXlzazV5TlRZckg5QUN4ZlE0R01CMW9kaWs4c1wiLFwiaXRcIjoxMyxcInJwYnJcIjpcIlwiLFwicnBoclwiOmZhbHNlLFwicm1oclwiOmZhbHNlLFwic3NpXCI6ZmFsc2UsXCJzc2NvXCI6MCxcInNzcGlcIjpbXCI0MDAzNzA0OTI1OTIyNjcxMFwiLFwiMzkyNzgxODM4NzUxNTgxNjlcIixcIjI5NDQxMzYxMjQyMTE1NDA5XCIsXCIyODg5NDQ1NjgyNjkxMzc5NFwiLFwiMjgxOTkwNTUzOTk3NzIwNjNcIixcIjI4ODM5MDQ1Mjk1Njk2ODI3XCIsXCIyNzkzMzM1NzU2NjMwNDQ2MlwiLFwiMjg3MDk2ODY3NjUzNTk1ODVcIixcIjI4MzcwODkxMTQ1OTMwNjExXCIsXCIyODM0NzQ3NDUxODIwNDYzMVwiLFwiMjg2MDk0NzE0ODIwMTY3OTRcIixcIjI4MzUxMzkxOTExMjE3MzI5XCIsXCIyODI4MjM5ODM2NDY5ODc1OVwiXX0sXCJpcnJcIjpmYWxzZSxcInNlcnBfY3RhXCI6ZmFsc2UsXCJydWlcIjpbXSxcIm1waWRcIjpbXSxcInNzaWNcIjowLFwidWJwXCI6bnVsbCxcIm5jcm5kXCI6MCxcImlyc3JcIjpmYWxzZSxcImJtcHJcIjpbXSxcImJtcGVpZFwiOltdLFwibm1ibXBcIjpmYWxzZSxcInNrcnJcIjpmYWxzZSxcImlvb3VyXCI6ZmFsc2UsXCJpc2VcIjpmYWxzZSxcInNtc19jdXJzb3JcIjp7XCJwYWdlX2luZGV4XCI6MCxcImJsZW5kZWRfYWRfaW5kZXhcIjowLFwib3JnYW5pY3Nfc2luY2VfbGFzdF9hZFwiOjAsXCJwYWdlX29yZ2FuaWNfY291bnRcIjowLFwiYmxlbmRlZF9vcmdhbmljX2luZGV4XCI6MCxcInJldHVybmVkX2FkX2luZGV4XCI6MCxcInRvdGFsX2luZGV4XCI6MH19In0"

Example response#

This is a sample from a recorded response, lists and long text are shortened, other people's names and handles are replaced. Status 200.

200 OKSample response
1{2  "ok": true,3  "credits_charged": 1,4  "credits_remaining": 4999,5  "cached": false,6  "cached_at": null,7  "request_id": "req_353464b6e185587ae414088a",8  "data": {9    "object": "list",10    "items": [11      {12        "object": "product",13        "platform": "facebook",14        "id": "1759754668539731",15        "url": "https://www.facebook.com/marketplace/item/1759754668539731/",16        "title": "Basically new Concord Cruiser bike.",17        "description": null,18        "price": {19          "amount": 100.0,20          "currency": null,21          "original_amount": null,22          "display": "$100"23        },24        "seller": {25          "id": "1000000001",26          "handle": null,27          "name": "Sample User",28          "url": null,29          "avatar_url": null,30          "verified": null31        },32        "rating": null,33        "review_count": null,34        "sold_count": null,35        "image_urls": [36          "https://scontent-atl3-2.xx.fbcdn.net/v/t39.84726-6/777867885_1065152789345589_1899757173861478598_n.jpg?stp=c43.0.260.260a_dst-jpg_p261x260_tt6&_nc_cat=104&ccb=1-7&_nc_sid=92e707&_nc_ohc=9ltnWglNdX0Q7kNvwFezn5Z&_nc_oc=AdoiUwi-9ULthCO4gLJ0n1..."37        ],38        "category": null,39        "in_stock": true,40        "location": {41          "name": null,42          "address": null,43          "city": "Austin",44          "region": "TX",45          "country": null,46          "latitude": null,47          "longitude": null48        },49        "published_at": "2026-08-17T00:42:36Z",50        "extra": {51          "category_id": "1658310421102081",52          "city_page_id": "106224666074625",53          "delivery_types": [54            "IN_PERSON"55          ],56          "is_hidden": false,57          "is_live": true,58          "is_pending": false,59          "is_sold": false,60          "source": "logged_out_public_view",61          "story_key": "28351391911217329"62        }63      }64    ],65    "cursor": "eyJrIjoibWFya2V0IiwibGF0IjozMC4yNjcyLCJsbmciOi05Ny43NDMxLCJhZnRlciI6IntcInBnXCI6MSxcImIyY1wiOntcImJyXCI6XCJcIixcIml0XCI6MCxcImhtc3JcIjpmYWxzZSxcInRiaVwiOjB9LFwiYzJjXCI6e1wiYnJcIjpcIkFicmhhXzg1OXRUa0xWcm1wQVJnWUgwdURfdDJsNE5VT1pTOG93S1pPeVk5...",66    "has_more": true,67    "parent": null68  },69  "cursor": "eyJrIjoibWFya2V0IiwibGF0IjozMC4yNjcyLCJsbmciOi05Ny43NDMxLCJhZnRlciI6IntcInBnXCI6MSxcImIyY1wiOntcImJyXCI6XCJcIixcIml0XCI6MCxcImhtc3JcIjpmYWxzZSxcInRiaVwiOjB9LFwiYzJjXCI6e1wiYnJcIjpcIkFicmhhXzg1OXRUa0xWcm1wQVJnWUgwdURfdDJsNE5VT1pTOG93S1pPeVk5...",70  "has_more": true71}

Response#

A list of Product objects in data.items, with data.cursor and data.has_more.

See Data models for every field. The envelope around data is described in Responses.

Errors#

Failures are free: credits_charged is 0. Branch on error.code, never on the message.

CodeHTTPRetryMeaning
invalid_params400noA parameter is missing, unknown or has the wrong type.
not_found404noThe platform says this profile, post or item does not exist.

Every request can also fail with the account and platform errors listed on the Errors page.