Facebook Marketplace

Facebook Marketplace listings as its logged-out web answers them: a keyword search around a city or a point, and a listing's detail with its photos.

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: 1.0.0
Reads from: facebook.com

Action	Description	Listed price
`search`	Search Facebook Marketplace listings for a keyword around a city or a latitude and longitude, in the US or the UK, with optional price bounds and sort: each listing's id, title, price, location, photo, URL and listing time.	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, photos, the seller's public name, status and listing time.	Billed per request at your plan's rates

`search`

Search Facebook Marketplace listings for a keyword around a city or a latitude and longitude, in the US or the UK, with optional price bounds and sort: each listing's id, title, price, location, photo, URL and listing time.

POST https://request.usestring.ai/v1/integrations/facebookmarketplace/search

Input

Unknown fields are rejected.

Field	Type	Description
`query`	string	Required. What to search for, such as bike. At least 1 character.
`city`	string	A Marketplace city: its slug as in facebook.com/marketplace/<slug>/ (nyc, la, london, chicago) or that page's URL. 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.
`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.
`sort`	`relevance` `newest` `price_asc` `price_desc` `distance`	relevance (the default), newest, price_asc, price_desc or distance.
`country`	`US` `GB`	The country the city or point is in, US or GB (ISO 3166-1 alpha-2). When given, a city or point outside it is refused, and rows carry the country's currency.
`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.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The listing id.
`url`	string	The listing's page.
`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, USD or GBP: the country's currency when the input names a country, else null, because the search answer names none.
`formattedPrice`	string \| null	The price as Marketplace shows it, with its currency symbol, such as $75 or £100.
`location`	string \| null	The listing's city and state or region, such as New York, NY.
`imageUrl`	string \| null	The listing's primary photo.
`listedAt`	string \| null	When the listing was posted, RFC 3339 UTC.
`isSold`	boolean	—
`isPending`	boolean	—

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": "1690802899423669",
    "url": "https://www.facebook.com/marketplace/item/1690802899423669/",
    "title": "18 gear women’s bike",
    "price": 75,
    "currency": "USD",
    "formattedPrice": "$75",
    "location": "New York, NY",
    "imageUrl": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.84726-6/830682251_1112031821416885_3070048350854648953_n.jpg?stp=c43.0.260.260a_dst-jpg_p261x260_tt6&_nc_cat=109&ccb=1-7&_nc_sid=92e707&_nc_ohc=8SywiDs6SsoQ7kNvwGHHeBl&_nc_oc=Adohw6bGk5CF-Y9oH82CZiB3Tr_Z5gJfokXapq2WGzL_0DB9f4as-7aKXP2kDAVbsSU&_nc_zt=14&_nc_ht=scontent-phl2-1.xx&_nc_gid=64KmIIUgAfFKUpEAYKCQbg&_nc_ss=79180&oh=00_AQQn3LAZL7inlzGdsU1yZzQ_4mj6HiBt42LE2HeV4WFzsg&oe=6AEECB7B",
    "listedAt": "2026-09-30T14:04:26Z",
    "isSold": false,
    "isPending": false
  },
  {
    "id": "3688404824643489",
    "url": "https://www.facebook.com/marketplace/item/3688404824643489/",
    "title": "Fuji Sagres vintage bike",
    "price": 80,
    "currency": "USD",
    "formattedPrice": "$80",
    "location": "New York, NY",
    "imageUrl": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.84726-6/797778550_1032551423107567_683454538925073018_n.jpg?stp=c0.43.261.261a_dst-jpg_p261x260_tt6&_nc_cat=107&ccb=1-7&_nc_sid=92e707&_nc_ohc=lr6Rbtg60m4Q7kNvwFqFVml&_nc_oc=Adrv4l0kWgIZf9RWfu230K3IrLGpRDRee8IBdVKdtkYlhzgebsGJ4wtMdqUtXJz825o&_nc_zt=14&_nc_ht=scontent-phl2-1.xx&_nc_gid=64KmIIUgAfFKUpEAYKCQbg&_nc_ss=79180&oh=00_AQScAiMTihl1tTmNKndRE28ms22A1PdLq-aSo4o4JA57xQ&oe=6AEEC687",
    "listedAt": "2026-09-05T19:14:37Z",
    "isSold": false,
    "isPending": false
  },
  {
    "id": "2372472703289852",
    "url": "https://www.facebook.com/marketplace/item/2372472703289852/",
    "title": "Full aluminum mountain bike",
    "price": 10,
    "currency": "USD",
    "formattedPrice": "$10",
    "location": "Flushing, NY",
    "imageUrl": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.84726-6/865082112_2291169488339750_6232255467563055995_n.jpg?stp=c43.0.260.260a_dst-jpg_p261x260_tt6&_nc_cat=100&ccb=1-7&_nc_sid=92e707&_nc_ohc=w4C6aV3IsuMQ7kNvwFSmOQG&_nc_oc=AdqvxBmbTfN2u961p5mnUwMQFz0RKRzpEnugvEkt2tyYIAjq6GTEQOabhr-IVBmC5Tc&_nc_zt=14&_nc_ht=scontent-phl2-1.xx&_nc_gid=64KmIIUgAfFKUpEAYKCQbg&_nc_ss=79180&oh=00_AQSiHiY5zX6N0HbMHhchdQDMYTs57-QoKIHtLwfNsXmhYw&oe=6AEEAD37",
    "listedAt": "2026-10-24T15:58:49Z",
    "isSold": false,
    "isPending": false
  }
]

Requests and billing

Requests: 1–2 Web Access requests per result page, plus up to 1 setup request 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, photos, the seller's public name, status and listing time.

POST https://request.usestring.ai/v1/integrations/facebookmarketplace/item