Facebook Marketplace API
Search Facebook Marketplace listings by keyword near a location, filter by price, condition, delivery, recency, and availability, and get title, price, location, and image as normalized JSON.
$1.20/1k req, pay per request, no subscription.
{"id": "1029384756102938","url": "https://www.facebook.com/marketplace/item/1029384756102938/","title": "Trek FX 2 Hybrid Bike - Size Medium","priceFormatted": "$285","priceAmount": 285,"locationName": "Austin, TX","photoUrl": "https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_1029384756102938.jpg","isSold": false,... 11 more fields}
Pricing and providers
Facebook Marketplace API pricing: one API, 2 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get Facebook marketplace in one request
This sample shows 24 of 25 fields. See every field
{
"found": true,
"data": {
"nextCursor": "AbYq2_marketplace_cursor_04",
"hasNextPage": true,
"listings": [
{
"id": "1029384756102938",
"url": "https://www.facebook.com/marketplace/item/1029384756102938/",
"title": "Trek FX 2 Hybrid Bike - Size Medium",
"priceFormatted": "$285",
"priceAmount": 285,
"locationName": "Austin, TX",
"photoUrl": "https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_1029384756102938.jpg",
"isSold": false,
"createdUtc": 1790884800,
"listingDateText": "Listed 4 days ago",
"city": "Austin",
"state": "Texas",
"cityPageId": "110683425619321",
"photoId": "5920184736501928",
"categoryId": "1020384756192837",
"deliveryTypes": [
"IN_PERSON",
"SHIPPING"
],
"isLive": true,
"isPending": false,
"isHidden": false
},
{
"id": "2938475610293847",
"url": "https://www.facebook.com/marketplace/item/2938475610293847/",
"title": "Kids 20 inch BMX Bike - Barely Used",
"priceFormatted": "$120",
"priceAmount": 120,
"locationName": "Round Rock, TX",
"photoUrl": "https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_2938475610293847.jpg",
"isSold": false,
"createdUtc": 1791057600,
"listingDateText": "Listed 2 days ago",
"city": "Round Rock",
"state": "Texas",
"cityPageId": "129384756019283",
"photoId": "6019283746501928",
"categoryId": "1020384756192837",
"deliveryTypes": [
"IN_PERSON"
],
"isLive": true,
"isPending": false,
"isHidden": false
}
]
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- latstring
30.2677
Latitude of the search location (e.g. '30.2677').
- lngstring
-97.7475
Longitude of the search location (e.g. '-97.7475').
- querystring
bike
Search keyword for Marketplace listings (e.g. 'bike').
- availabilityenum
Filter by availability: available (default), sold, or all (e.g. sold).
- conditionenum
Only return listings in this condition (e.g. used_good).
- cursorstring
Pagination cursor from a previous response to fetch the next page.
- dateListedenum
Only return listings posted within this window (e.g. last_7_days).
- deliveryMethodenum
Only return listings offering this delivery method (e.g. shipping).
- priceMaxinteger
500
Maximum listing price in whole currency units, e.g. 500 for $500. Facebook may mix in a few suggested listings outside the range.
- priceMininteger
100
Minimum listing price in whole currency units, e.g. 100 for $100. Facebook may mix in a few suggested listings outside the range.
- sortenum
Sort order for the returned listings (e.g. price_ascend).
Response
JSON, one example value per field.
- hasNextPageboolean
true
- nextCursorstring
AbYq2_marketplace_cursor_04
Opaque cursor for the next page of listings, or null when this lane has no more. Pass it back as cursor to continue.
- categoryIdstring
1020384756192837
Numeric Facebook Marketplace category id, as a string.
- citystring
Austin
City the listing is located in.
- cityPageIdstring
110683425619321
Numeric Facebook id of the city page, as a string.
- createdUtcnumber
1790884800
UTC epoch timestamp in seconds (Unix time) the listing was created. Multiply by 1000 for a JS Date in milliseconds. Null when the source does not report it.
- deliveryTypesstring[]
Delivery options the seller offers, e.g. "IN_PERSON" or "SHIPPING".
- idstring
1029384756102938
Populated whenever the provider has data for the entity.
- isHiddenboolean
false
Whether the listing is hidden.
- isLiveboolean
true
Whether the listing is currently live.
- isPendingboolean
false
Whether the listing is marked pending.
- isSoldboolean
false
- listingDateTextstring
Listed 4 days ago
Human-readable listing age Facebook shows, e.g. "Listed 2 weeks ago".
- locationNamestring
Austin, TX
Populated whenever the provider has data for the entity.
- photoIdstring
5920184736501928
Numeric Facebook id of the listing's primary photo, as a string.
- photoUrlstring
https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_1029384756102938.jpg
Populated whenever the provider has data for the entity.
- priceAmountnumber
285
Populated whenever the provider has data for the entity.
- priceFormattedstring
$285
Populated whenever the provider has data for the entity.
- statestring
Texas
State or region the listing is located in.
- titlestring
Trek FX 2 Hybrid Bike - Size Medium
Populated whenever the provider has data for the entity.
- urlstring
https://www.facebook.com/marketplace/item/1029384756102938/
Populated whenever the provider has data for the entity.
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Facebook Marketplace API
The AnyAPI Facebook Marketplace API returns Facebook marketplace data as normalized JSON from one POST call to /v1/run/facebook.marketplace. Search Facebook Marketplace listings by keyword near a location, filter by price, condition, delivery, recency, and availability, and get title, price, location, and image as normalized JSON. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Facebook marketplace calls through AnyAPI succeeded, with a median response time of 1.9 seconds across 7,767 measured calls.
