Search Facebook Marketplace Local & Shipping Listings
GET/v1/facebook-marketplace/search5 Credits / call($0.20–$0.50 / 1K calls)· Updated 2026-11-14
Search real-time Facebook Marketplace listings by keyword and city/location (supports GET query params and POST JSON body; aliases: /v1/facebook/marketplace/search, /v1/fb-marketplace/search). Returns price, list_price, image, images, date_listed, status, location, delivery, condition, and seller. Cost: 5 Credits / call ($0.50/1K PAYG, $0.20/1K Business; 0 Credits if empty).
Parameters
querystringrequiredSearch keyword (aliases: q, keyword).
locationstringCity or region name (alias: city).
limitinteger (1 to 50)
Example Request (cURL / Python / JavaScript)
curl "https://api.shopdataapi.com/v1/facebook-marketplace/search?query=couch" \
-H "x-api-key: sd_live_your_api_key"import requests
res = requests.get(
"https://api.shopdataapi.com/v1/facebook-marketplace/search?query=couch",
headers={"x-api-key": "sd_live_your_api_key"},
timeout=30,
)
print(res.json())const res = await fetch("https://api.shopdataapi.com/v1/facebook-marketplace/search?query=couch", {
headers: { "x-api-key": "sd_live_your_api_key" },
});
const data = await res.json();
console.log(data);Response Fields
Normalized Facebook Marketplace search listings.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
status | string | Example: ok |
msg | string | Example: success |
meta | object | |
endpoint | string | Example: /v1/facebook-marketplace/search |
credits_cost | integer | Example: 5 |
credits_charged | integer | Example: 5 |
data | object | |
query | string | Example: couch |
location | string | Example: austin |
count | integer | Example: 20 |
items | array of FacebookMarketplaceListing | |
id | string | Example: 1500578701963217 |
title | string | Example: Beige couch with sleeper topper |
url | string | Example: https://www.facebook.com/marketplace/item/1500578701963217 |
price | numbernull | Example: 350 |
list_price | numbernull | Example: 350 |
image | stringnull | |
images | array of string | |
date_listed | string | Example: 2026-11-15T12:00:00.000Z |
status | string | Example: live |
location | string | Example: Austin, TX |
delivery | array of string | Example: IN_PERSON |
description | string | Example: Very comfy three-seat sofa with warm wood legs and sleeper t |
condition | string | Example: Used – good |
seller | object |
Status Codes
- 200
- Normalized Facebook Marketplace search listings.