String docs
Site integrations

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
ActionDescriptionListed price
searchSearch 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
itemRead 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 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/search

Input

Unknown fields are rejected.

FieldTypeDescription
querystringWhat to search for, such as bike. Optional with a category, which then lists that category's newest listings.
categoryapparel classifieds electronics entertainment family free garden hobbies home home-improvements instruments office-supplies pets propertyrentals sports toys vehiclesSearch 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.
citystringA 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.
latitudenumber | nullThe latitude to search around, with longitude, instead of city. From -90 to 90.
longitudenumber | nullThe longitude to search around, with latitude, instead of city. From -180 to 180.
countryUS 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 NZThe 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.
minPricenumber | nullThe lowest price, in the local currency. At least 0.
maxPricenumber | nullThe highest price, in the local currency. At least 0.
conditionnew used_like_new used_good used_fair[] | nullOnly listings in these conditions: new, used_like_new, used_good, used_fair.
daysSinceListed1 7 30Only listings posted in the last 1, 7 or 30 days.
deliverylocal_pickup shippinglocal_pickup for listings collected near the place, or shipping for listings shipped from anywhere in the country. Defaults to both.
availabilityavailable soldavailable (the default) or sold.
minYearinteger | nullVehicles: the earliest model year. From 1900 to 2100.
maxYearinteger | nullVehicles: the latest model year. From 1900 to 2100.
minMileageinteger | nullVehicles: the lowest odometer reading, in the market's own unit (miles in the US and GB, kilometres elsewhere) At least 0.
maxMileageinteger | nullVehicles: the highest odometer reading. At least 0.
transmissionautomatic manualVehicles: automatic or manual.
sortrelevance newest price_asc price_desc distancerelevance (the default), newest, price_asc, price_desc or distance.
pagesintegerHow 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.
includeImagesbooleanAlso 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:

FieldTypeDescription
idstringThe listing id; its page is facebook.com/marketplace/item/<id>/.
titlestring—
pricenumber | nullThe asking price in the local currency; 0 for a free listing.
currencystring | nullThe 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.
locationstring | nullThe listing's city and state or region, such as New York, NY.
listedAtstring | nullWhen the listing was posted, RFC 3339 UTC.
statusstringavailable, pending or sold.
mileagestring | nullA vehicle's odometer reading as Marketplace shows it, such as 95K miles. May be absent.
imageUrlstring | nullThe 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/item

Input

Unknown fields are rejected.

FieldTypeDescription
itemsstring[]Required. Listing ids, such as 1700631871172669, or their facebook.com/marketplace/item/<id>/ URLs. 1 to 20 entries.
includePhotosbooleanAlso 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.
includeSellerbooleanAlso return the seller's public display name.
includeFullDescriptionbooleanReturn 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:

FieldTypeDescription
idstringThe listing id; its page is facebook.com/marketplace/item/<id>/.
titlestring—
descriptionstring | nullThe seller's description, cut at 300 characters with an ellipsis unless includeFullDescription.
pricenumber | nullThe asking price; 0 for a free listing.
currencystring | nullThe price's ISO 4217 currency code, such as USD.
conditionstring | nullThe condition the seller chose, such as Used - Good; null where the category has none.
categorystring | nullThe listing's category, such as Bicycles.
locationstring | nullWhere the item is, as Marketplace shows it, such as New York, NY.
latitudenumber | nullThe listing's approximate latitude, as Marketplace places it.
longitudenumber | nullThe listing's approximate longitude.
listedAtstring | nullWhen the listing was posted, RFC 3339 UTC.
statusstringavailable, pending or sold.
deliveryTypesstring[] | nullHow the seller hands the item over, such as IN_PERSON or SHIPPING_OFFSITE.
vehicleobject | nullA vehicle listing's details. May be absent.
vehicle.makestring | nullSuch as Toyota. May be absent.
vehicle.modelstring | nullSuch as Camry. May be absent.
vehicle.trimstring | nullSuch as LE. May be absent.
vehicle.yearinteger | nullThe model year, read from the title the listing form builds from it. May be absent.
vehicle.mileageinteger | nullThe odometer reading, in mileageUnit. May be absent.
vehicle.mileageUnitstring | nullmiles or kilometers. May be absent.
vehicle.transmissionstring | nullautomatic or manual. May be absent.
vehicle.exteriorColorstring | nullMay be absent.
vehicle.interiorColorstring | nullMay be absent.
vehicle.fuelTypestring | nullMay be absent.
propertyobject | nullA property listing's details. May be absent.
property.bedroomsnumber | nullMay be absent.
property.bathroomsnumber | nullMay be absent.
property.detailsstring[] | nullThe unit's details as Marketplace lists them, such as Apartment, 2 beds · 1 bath, Central AC. May be absent.
photosstring[] | nullThe listing's photos, largest published size, in the seller's order; only with includePhotos. May be absent.
sellerNamestring | nullThe 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.