Facebook Marketplace
Facebook Marketplace listings as its logged-out web answers them, in 48 countries: a keyword or category search around a city or a point with the search panel's filters, and a listing's detail.
Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.
- Site:
facebookmarketplace - Version:
2.0.0 - Reads from:
facebook.com
| Action | Description | Listed price |
|---|---|---|
search | Search Facebook Marketplace listings by keyword or category around a city or a latitude and longitude, in any of the countries it serves, filtered by price, condition, listing age, delivery, availability and vehicle year, mileage and transmission: each listing's id, title, price and currency, location, listing time and status, with the photo on request. | Billed per request at your plan's rates |
item | Read Facebook Marketplace listings by id or URL: title, description, price and currency, condition, category, location, status, listing time and delivery, a vehicle's make, model, year and mileage, or a rental's bedrooms and bathrooms; photos and the seller's public name on request. | Billed per request at your plan's rates |
search
Search Facebook Marketplace listings by keyword or category around a city or a latitude and longitude, in any of the countries it serves, filtered by price, condition, listing age, delivery, availability and vehicle year, mileage and transmission: each listing's id, title, price and currency, location, listing time and status, with the photo on request.
POST https://request.usestring.ai/v1/integrations/facebookmarketplace/searchInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
query | string | What to search for, such as bike. Optional with a category, which then lists that category's newest listings. |
category | apparel classifieds electronics entertainment family free garden hobbies home home-improvements instruments office-supplies pets propertyrentals sports toys vehicles | Search within one of Marketplace's categories: apparel, classifieds, electronics, entertainment, family, free (free listings only), garden, hobbies, home, home-improvements, instruments, office-supplies, pets, propertyrentals, sports, toys or vehicles. |
city | string | A Marketplace city: its slug as in facebook.com/marketplace/<slug>/ (nyc, la, london, chicago) or that page's URL, or with country a city's name (London, São Paulo). Give either city or latitude and longitude. |
latitude | number | null | The latitude to search around, with longitude, instead of city. From -90 to 90. |
longitude | number | null | The longitude to search around, with latitude, instead of city. From -180 to 180. |
country | US CA MX BR AR CL CO PE GB IE FR DE ES IT PT NL BE AT FI GR PL SE NO DK CH RO CZ HU TR JP KR TW IN PH TH MY SG ID VN AE SA IL EG NG ZA KE AU NZ | The country the city or point is in (ISO 3166-1 alpha-2), such as US, GB, DE or JP. When given, a city name is looked up in that country (london with CA is London, Ontario), and a city or point outside it is refused. |
minPrice | number | null | The lowest price, in the local currency. At least 0. |
maxPrice | number | null | The highest price, in the local currency. At least 0. |
condition | new used_like_new used_good used_fair[] | null | Only listings in these conditions: new, used_like_new, used_good, used_fair. |
daysSinceListed | 1 7 30 | Only listings posted in the last 1, 7 or 30 days. |
delivery | local_pickup shipping | local_pickup for listings collected near the place, or shipping for listings shipped from anywhere in the country. Defaults to both. |
availability | available sold | available (the default) or sold. |
minYear | integer | null | Vehicles: the earliest model year. From 1900 to 2100. |
maxYear | integer | null | Vehicles: the latest model year. From 1900 to 2100. |
minMileage | integer | null | Vehicles: the lowest odometer reading, in the market's own unit (miles in the US and GB, kilometres elsewhere) At least 0. |
maxMileage | integer | null | Vehicles: the highest odometer reading. At least 0. |
transmission | automatic manual | Vehicles: automatic or manual. |
sort | relevance newest price_asc price_desc distance | relevance (the default), newest, price_asc, price_desc or distance. |
pages | integer | How many result pages to read, 1 to 20. A page holds about 13 listings on relevance and 24 to 29 otherwise. Defaults to 1. From 1 to 20. |
includeImages | boolean | Also return each listing's primary photo URL as imageUrl. Off by default: a photo URL is about two thirds of a row. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
id | string | The listing id; its page is facebook.com/marketplace/item/<id>/. |
title | string | — |
price | number | null | The asking price in the local currency; 0 for a free listing. |
currency | string | null | The price's ISO 4217 currency code, such as USD, EUR or JPY, read from the listing's own price; for a price that names none, the country's currency when the input names a country, else null. |
location | string | null | The listing's city and state or region, such as New York, NY. |
listedAt | string | null | When the listing was posted, RFC 3339 UTC. |
status | string | available, pending or sold. |
mileage | string | null | A vehicle's odometer reading as Marketplace shows it, such as 95K miles. May be absent. |
imageUrl | string | null | The listing's primary photo; only with includeImages. May be absent. |
Example
curl https://request.usestring.ai/v1/integrations/facebookmarketplace/search \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "bike",
"city": "nyc",
"country": "US",
"pages": 2
}'data starts with these rows:
[
{
"id": "2496049387471659",
"title": "Bike 27.5 inch",
"price": 0,
"currency": "USD",
"location": "Old Bridge, NJ",
"listedAt": "2026-11-02T20:16:55Z",
"status": "available"
},
{
"id": "2134408030549442",
"title": "Bike",
"price": 60,
"currency": "USD",
"location": "Jersey City, NJ",
"listedAt": "2026-10-25T01:10:59Z",
"status": "available"
},
{
"id": "2991887701167875",
"title": "Shogun Trail Blaster 18-Speed Bike + Schwinn Pump",
"price": 65,
"currency": "USD",
"location": "New York, NY",
"listedAt": "2026-11-02T17:08:30Z",
"status": "available"
}
]Requests and billing
- Requests: 1–6 Web Access requests per result page, plus up to 9 setup requests per call.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
item
Read Facebook Marketplace listings by id or URL: title, description, price and currency, condition, category, location, status, listing time and delivery, a vehicle's make, model, year and mileage, or a rental's bedrooms and bathrooms; photos and the seller's public name on request.
POST https://request.usestring.ai/v1/integrations/facebookmarketplace/itemInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
items | string[] | Required. Listing ids, such as 1700631871172669, or their facebook.com/marketplace/item/<id>/ URLs. 1 to 20 entries. |
includePhotos | boolean | Also return every photo URL, in the seller's order. Off by default: photos are about three quarters of a row and take a second request per listing. |
includeSeller | boolean | Also return the seller's public display name. |
includeFullDescription | boolean | Return the seller's whole description. Off by default: a description longer than 300 characters is cut there, ending with an ellipsis. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
id | string | The listing id; its page is facebook.com/marketplace/item/<id>/. |
title | string | — |
description | string | null | The seller's description, cut at 300 characters with an ellipsis unless includeFullDescription. |
price | number | null | The asking price; 0 for a free listing. |
currency | string | null | The price's ISO 4217 currency code, such as USD. |
condition | string | null | The condition the seller chose, such as Used - Good; null where the category has none. |
category | string | null | The listing's category, such as Bicycles. |
location | string | null | Where the item is, as Marketplace shows it, such as New York, NY. |
latitude | number | null | The listing's approximate latitude, as Marketplace places it. |
longitude | number | null | The listing's approximate longitude. |
listedAt | string | null | When the listing was posted, RFC 3339 UTC. |
status | string | available, pending or sold. |
deliveryTypes | string[] | null | How the seller hands the item over, such as IN_PERSON or SHIPPING_OFFSITE. |
vehicle | object | null | A vehicle listing's details. May be absent. |
vehicle.make | string | null | Such as Toyota. May be absent. |
vehicle.model | string | null | Such as Camry. May be absent. |
vehicle.trim | string | null | Such as LE. May be absent. |
vehicle.year | integer | null | The model year, read from the title the listing form builds from it. May be absent. |
vehicle.mileage | integer | null | The odometer reading, in mileageUnit. May be absent. |
vehicle.mileageUnit | string | null | miles or kilometers. May be absent. |
vehicle.transmission | string | null | automatic or manual. May be absent. |
vehicle.exteriorColor | string | null | May be absent. |
vehicle.interiorColor | string | null | May be absent. |
vehicle.fuelType | string | null | May be absent. |
property | object | null | A property listing's details. May be absent. |
property.bedrooms | number | null | May be absent. |
property.bathrooms | number | null | May be absent. |
property.details | string[] | null | The unit's details as Marketplace lists them, such as Apartment, 2 beds · 1 bath, Central AC. May be absent. |
photos | string[] | null | The listing's photos, largest published size, in the seller's order; only with includePhotos. May be absent. |
sellerName | string | null | The seller's public display name; only with includeSeller. May be absent. |
Example
curl https://request.usestring.ai/v1/integrations/facebookmarketplace/item \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"items": ["1700631871172669", "https://www.facebook.com/marketplace/item/28934009402959274/?ref=search", "1720207995949881"]
}'data starts with these rows:
[
{
"id": "1700631871172669",
"title": "Black Mamachari Bicycle – 5-Min Walk from Osaki Station",
"description": "Selling a used black mamachari (Japanese city bicycle).\n\n- Color: Black\n- Type: Mamachari / city bike\n- Condition: Used with some signs of wear and age, but it…",
"price": 5000,
"currency": "JPY",
"condition": "Used - Good",
"category": "Bicycles",
"location": "品川区, 東京都",
"latitude": 35.620422363281,
"longitude": 139.72961425781,
"listedAt": "2026-07-31T01:35:49Z",
"status": "available",
"deliveryTypes": ["IN_PERSON"]
},
{
"id": "28934009402959274",
"title": "Fahrrad Bike",
"description": "All work",
"price": 120,
"currency": "EUR",
"condition": "Used - Good",
"category": "Bicycles",
"location": "Berlin, BE",
"latitude": 52.517395019531,
"longitude": 13.397827148438,
"listedAt": "2026-11-02T11:58:37Z",
"status": "available",
"deliveryTypes": ["IN_PERSON"]
},
{
"id": "1720207995949881",
"title": "Scott road bike - STOLEN BIKE SAFETY ALERT",
"description": "Hello! Unfortunately, my bike was stolen outside YMCA Long Island City yesterday afternoon. I'm sure it will pop up on Marketplace soon. Please do not support t…",
"price": 0,
"currency": "USD",
"condition": "Used - Good",
"category": "Sports & Outdoors",
"location": "Sunnyside, NY",
"latitude": 40.745544433594,
"longitude": -73.921508789062,
"listedAt": "2026-09-10T19:11:19Z",
"status": "available",
"deliveryTypes": ["IN_PERSON"]
}
]Requests and billing
- Requests: 1–6 Web Access requests per entry in
items, plus up to 3 setup requests per call. - Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
RingGo
RingGo's UK pay-by-phone parking: the councils and operators it takes payment for; every zone one operator runs, with its RingGo location code and coordinates; the zones nearest a point, with postcode, distance, spaces, live occupancy and emissions zone; and one zone's tariffs, fees and stay limits.
Lowe's
Lowe's product search, product detail with specifications, and what the Lowe's shopping assistant tells a signed-out shopper.