Facebook Marketplace API
按关键词搜索某个地点附近的 Facebook Marketplace 商品，可按价格、成色、配送方式、发布时间和是否在售筛选，以标准化 JSON 返回标题、价格、地点和图片。
US$1.20/千次请求，按请求付费，无需订阅。
Results for "bike"
$285
Trek FX 2 Hybrid Bike - Size Medium
Austin, TX
{"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 个字段}
价格与服务商
Facebook Marketplace API 价格：一个 API，2 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
试一试
一个请求获取 Facebook Marketplace
这个示例展示了 25 个字段中的 24 个。查看全部字段
{
"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
}
]
}
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- latstring
30.2677
搜索地点的纬度（例如 '30.2677'）。
- lngstring
-97.7475
搜索地点的经度（例如 '-97.7475'）。
- querystring
bike
Marketplace 商品的搜索关键词（例如 'bike'）。
- availabilityenum
按是否在售筛选：available（默认）、sold 或 all（例如 sold）。
- conditionenum
只返回此成色的商品（例如 used_good）。
- cursorstring
上一次响应返回的分页游标，用于获取下一页。
- dateListedenum
只返回在此时间窗口内发布的商品（例如 last_7_days）。
- deliveryMethodenum
只返回提供此配送方式的商品（例如 shipping）。
- priceMaxinteger
500
商品最高价格，以整数货币单位计，例如 500 表示 $500。Facebook 可能会混入少量超出该范围的推荐商品。
- priceMininteger
100
商品最低价格，以整数货币单位计，例如 100 表示 $100。Facebook 可能会混入少量超出该范围的推荐商品。
- sortenum
返回商品的排序方式（例如 price_ascend）。
响应
JSON，每个字段一个示例值。
- 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.
常见问题
关于 Facebook Marketplace API
AnyAPI 的 Facebook Marketplace API 只需一次 POST 请求 /v1/run/facebook.marketplace，就以统一格式的 JSON 返回 Facebook 数据。按关键词搜索某个地点附近的 Facebook Marketplace 商品，可按价格、成色、配送方式、发布时间和是否在售筛选，以标准化 JSON 返回标题、价格、地点和图片。AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$1.20 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Facebook Marketplace API 调用中有 100.0% 成功，响应时间中位数为 2.1 秒，共测量 10,471 次调用。