Facebook Marketplace API

按关键词搜索某个地点附近的 Facebook Marketplace 商品，可按价格、成色、配送方式、发布时间和是否在售筛选，以标准化 JSON 返回标题、价格、地点和图片。

POST/v1/run/facebook.marketplace

可用率

100.00%

30d · 88 次调用

请求数

30d · 按周，近 12 周

响应时间

1.9s

中位数 · 30d

服务商网络

按流量排序的服务商

服务商调用占比

Giraffe优先调用已服务 85可用率 96.59%1710ms p5096.6%96.6%96.59% (88 次调用)1710ms (85 次调用)85US$1.20/千次请求固定价

Fox已服务 3可用率 100.00%11129ms p503.4%3.4%100.00% (3 次调用)11129ms (3 次调用)3US$3.60/千次请求固定价

试一试

发出你的第一个请求

lat*string搜索地点的纬度（例如 '30.2677'）。lng*string搜索地点的经度（例如 '-97.7475'）。query*stringMarketplace 商品的搜索关键词（例如 'bike'）。availabilityenum按是否在售筛选：available（默认）、sold 或 all（例如 sold）。conditionenum只返回此成色的商品（例如 used_good）。cursorstring上一次响应返回的分页游标，用于获取下一页。dateListedenum只返回在此时间窗口内发布的商品（例如 last_7_days）。deliveryMethodenum只返回提供此配送方式的商品（例如 shipping）。priceMaxinteger 0-商品最高价格，以整数货币单位计，例如 500 表示 $500。Facebook 可能会混入少量超出该范围的推荐商品。priceMininteger 0-商品最低价格，以整数货币单位计，例如 100 表示 $100。Facebook 可能会混入少量超出该范围的推荐商品。sortenum返回商品的排序方式（例如 price_ascend）。

打开于提示词已复制

获取免费密钥

示例响应

免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

{
  "data": {
    "hasNextPage": true,
    "listings": [
      {
        "categoryId": "general",
        "city": "San Francisco",
        "cityPageId": "San Francisco",
        "createdUtc": 12.5,
        "deliveryTypes": [
          "general"
        ],
        "id": "a1b2c3d4",
        "isHidden": false,
        "isLive": true,
        "isPending": true,
        "isSold": true,
        "listingDateText": "A short example description of this item.",
        "locationName": "Example title",
        "photoId": "https://example.com/image.jpg",
        "photoUrl": "https://example.com/image.jpg",
        "priceAmount": 19.99,
        "priceFormatted": "19.99",
        "state": "CA",
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ],
    "nextCursor": "example"
  },
  "found": true,
  "reason": "not_found"
}

响应类型定义

interface FacebookMarketplaceResponse {
  data: {
    hasNextPage: boolean;
    listings: {
      categoryId?: string;
      city?: string;
      cityPageId?: string;
      createdUtc?: number | null;
      deliveryTypes?: string[];
      id: string;
      isHidden?: boolean;
      isLive?: boolean;
      isPending?: boolean;
      isSold: boolean;
      listingDateText?: string;
      locationName: string;
      photoId?: string;
      photoUrl: string;
      priceAmount: number;
      priceFormatted: string;
      state?: string;
      title: string;
      url: string;
    }[];
    nextCursor: string | null;
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计

POST /v1/run/facebook.marketplace

curl -X POST https://api.getanyapi.com/v1/run/facebook.marketplace \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"30.2677","lng":"-97.7475","priceMax":500,"priceMin":100,"query":"bike"}'

字段	类型	示例值
请求体
lat	string	"30.2677"搜索地点的纬度（例如 '30.2677'）。
lng	string	"-97.7475"搜索地点的经度（例如 '-97.7475'）。
query	string	"bike"Marketplace 商品的搜索关键词（例如 'bike'）。
availability	enum	按是否在售筛选：available（默认）、sold 或 all（例如 sold）。
condition	enum	只返回此成色的商品（例如 used_good）。
cursor	string	上一次响应返回的分页游标，用于获取下一页。
dateListed	enum	只返回在此时间窗口内发布的商品（例如 last_7_days）。
deliveryMethod	enum	只返回提供此配送方式的商品（例如 shipping）。
priceMax	integer	500商品最高价格，以整数货币单位计，例如 500 表示 $500。Facebook 可能会混入少量超出该范围的推荐商品。
priceMin	integer	100商品最低价格，以整数货币单位计，例如 100 表示 $100。Facebook 可能会混入少量超出该范围的推荐商品。
sort	enum	返回商品的排序方式（例如 price_ascend）。
响应
data	object
data.hasNextPage	boolean
data.listings	object[]
data.listings[].categoryId	string	Numeric Facebook Marketplace category id, as a string.
data.listings[].city	string	City the listing is located in.
data.listings[].cityPageId	string	Numeric Facebook id of the city page, as a string.
data.listings[].createdUtc	number	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.
data.listings[].deliveryTypes	string[]	Delivery options the seller offers, e.g. "IN_PERSON" or "SHIPPING".
data.listings[].id	string	Populated whenever the provider has data for the entity.
data.listings[].isHidden	boolean	Whether the listing is hidden.
data.listings[].isLive	boolean	Whether the listing is currently live.
data.listings[].isPending	boolean	Whether the listing is marked pending.
data.listings[].isSold	boolean
data.listings[].listingDateText	string	Human-readable listing age Facebook shows, e.g. "Listed 2 weeks ago".
data.listings[].locationName	string	Populated whenever the provider has data for the entity.
data.listings[].photoId	string	Numeric Facebook id of the listing's primary photo, as a string.
data.listings[].photoUrl	string	Populated whenever the provider has data for the entity.
data.listings[].priceAmount	number	Populated whenever the provider has data for the entity.
data.listings[].priceFormatted	string	Populated whenever the provider has data for the entity.
data.listings[].state	string	State or region the listing is located in.
data.listings[].title	string	Populated whenever the provider has data for the entity.
data.listings[].url	string	Populated whenever the provider has data for the entity.
data.nextCursor	string	Opaque cursor for the next page of listings, or null when this lane has no more. Pass it back as cursor to continue.
found	boolean
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.
价格
每次请求价格	USD	US$0.0012
价格（/千次请求）	USD	US$1.20

常见问题

关于 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% 成功，响应时间中位数为 1.9 秒，共测量 88 次调用。

费用：每千次请求 US$1.20 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

按关键词搜索某个地点附近的 Facebook Marketplace 商品，可按价格、成色、配送方式、发布时间和是否在售筛选，以标准化 JSON 返回标题、价格、地点和图片。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Facebook Marketplace API 调用中有 100.0% 成功，响应时间中位数为 1.9 秒，共测量 88 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。

更多接口

Facebook 的其他接口

一个密钥，一个钱包，
开始你的第一次 Facebook 调用。

领取 ~150 次免费请求

Facebook Marketplace API

按流量排序的服务商

发出你的第一个请求

请求、响应与价格

关于 Facebook Marketplace API

Facebook Marketplace API 怎么收费？

Facebook Marketplace API 返回什么？

Facebook Marketplace API 的可靠性如何？

Facebook 的其他接口

一个密钥，一个钱包，开始你的第一次 Facebook 调用。

一个密钥，一个钱包，
开始你的第一次 Facebook 调用。