Facebook API

Facebook Marketplace 商品 API

通过 ID 或 URL 获取单个 Facebook Marketplace 商品的完整详情(标题、价格、地点、照片和属性),以标准化 JSON 返回。

US$1.20/千次请求,按请求付费,无需订阅。

fTrek FX 2 Hybrid Bike - Size Medium | Facebook Marketplace
facebook.com/marketplace/item/1656586118821988/

$285

Trek FX 2 Hybrid Bike - Size Medium

Listed Listed 4 days ago in Austin, TX

Details

Austin, TX · In Bicycles

Selling my Trek FX 2 hybrid bike, size medium, frame is 17.5 inches. Ridden maybe 15 times, kept indoors. New tires and tune-up done in the spring. Comes with a rear rack and kickstand. Cash or Venmo, pickup only in East Austin.

API 返回的内容
{
"id": "1656586118821988",
"url": "https://www.facebook.com/marketplace/item/1656586118821988/",
"title": "Trek FX 2 Hybrid Bike - Size Medium",
"description": "Selling my Trek FX 2 hybrid bike, size medium, frame is 17.5 inches. Ridden maybe 15 times, kept indoors. New tires and tune-up done in the spring. Comes with a rear rack and kickstand. Cash or Venmo, pickup only in East Austin.",
"creationTime": "2026-09-20T14:32:00Z",
"locationText": "Austin, TX",
"priceFormatted": "$285",
"priceAmount": 285,
... 还有 18 个字段
}
可用率
99.85%
30d · 18,689 次调用
请求数
18,694
30d · 按周,近 12 周
响应时间
2.7s
中位数 · 30d

价格

Facebook Marketplace 商品 API 价格

你需支付
US$12.00
US$1.20/千次请求,只为实际用量付费。没有月度套餐。
有了 US$0.10 的初始余额,你的前 83 次请求免费。

试一试

一个请求获取 Facebook Marketplace 商品

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

这个示例展示了 43 个字段中的 25 个。查看全部字段

{
  "found": true,
  "data": {
    "id": "1656586118821988",
    "url": "https://www.facebook.com/marketplace/item/1656586118821988/",
    "title": "Trek FX 2 Hybrid Bike - Size Medium",
    "description": "Selling my Trek FX 2 hybrid bike, size medium, frame is 17.5 inches. Ridden maybe 15 times, kept indoors. New tires and tune-up done in the spring. Comes with a rear rack and kickstand. Cash or Venmo, pickup only in East Austin.",
    "creationTime": "2026-09-20T14:32:00Z",
    "locationText": "Austin, TX",
    "priceFormatted": "$285",
    "priceAmount": 285,
    "currency": "USD",
    "categoryId": "1020384756192837",
    "isSold": false,
    "isLive": true,
    "listingDateText": "Listed 4 days ago",
    "latitude": 30.2677,
    "longitude": -97.7475,
    "strikethroughPriceFormatted": "$350",
    "shareUrl": "https://www.facebook.com/marketplace/item/1656586118821988/",
    "deliveryTypes": [
      "IN_PERSON",
      "SHIPPING"
    ],
    "isHidden": false,
    "isPending": false,
    "isShippingOffered": true,
    "isBuyNowEnabled": false,
    "messagingEnabled": true
  }
}

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

参考

一个请求,一种响应结构。

你发送的每个字段和收到的每个字段,都附有真实示例。

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

请求体

JSON,POST 到这个接口。

  • idstring

    Facebook Marketplace 商品 ID。

  • urlstring

    https://www.facebook.com/marketplace/item/1656586118821988/

    Facebook Marketplace 商品 URL。

你发送。 一个简短的 JSON 请求体。显示的值只是示例,请换成你自己的。

响应

JSON,每个字段一个示例值。

each attributedata.attributes[]

Item specifics Facebook publishes for the listing.

  • labelstring

    Display label for the value, e.g. "Used - Good".

  • namestring

    Attribute name, e.g. "Condition".

  • valuestring

    Raw attribute value, e.g. "used_good".

datadata
  • categoryIdstring

    1020384756192837

    Populated whenever the provider has data for the entity.

  • creationTimestring

    2026-09-20T14:32:00Z

    Populated whenever the provider has data for the entity.

  • currencystring

    USD

    Populated whenever the provider has data for the entity.

  • deliveryTypesstring[]

    Delivery options the seller offers, e.g. "IN_PERSON" or "SHIPPING".

  • descriptionstring

    Selling my Trek FX 2 hybrid bike, size medium, frame is 17.5 inches. Ridden maybe 15 times, kept indoors. New tires and tune-up done in the spring. Comes with a rear rack and kickstand. Cash or Venmo, pickup only in East Austin.

    Populated whenever the provider has data for the entity.

  • idstring

    1656586118821988

    Populated whenever the provider has data for the entity.

  • isBuyNowEnabledboolean

    false

    Whether buy-now checkout is enabled on the listing.

  • isHiddenboolean

    false

    Whether the listing is hidden.

  • isLiveboolean

    true

  • isPendingboolean

    false

    Whether the listing is marked pending.

  • isShippingOfferedboolean

    true

    Whether the seller offers shipping.

  • isSoldboolean

    false

  • latitudenumber

    30.2677

    Latitude of the listing's location.

  • listingDateTextstring

    Listed 4 days ago

    Human-readable listing age Facebook shows, e.g. "Listed 4 months ago".

  • locationTextstring

    Austin, TX

    Populated whenever the provider has data for the entity.

  • longitudenumber

    -97.7475

    Longitude of the listing's location.

  • messagingEnabledboolean

    true

    Whether buyers can message the seller about the listing.

  • priceAmountnumber

    285

    Populated whenever the provider has data for the entity.

  • priceFormattedstring

    $285

    Populated whenever the provider has data for the entity.

  • shareUrlstring

    https://www.facebook.com/marketplace/item/1656586118821988/

    Canonical shareable Marketplace URL of the listing.

  • strikethroughPriceFormattedstring

    $350

    Previous price shown struck through, formatted for display.

  • titlestring

    Trek FX 2 Hybrid Bike - Size Medium

    Populated whenever the provider has data for the entity.

  • urlstring

    https://www.facebook.com/marketplace/item/1656586118821988/

    Populated whenever the provider has data for the entity.

each photodata.photos[]

Photos attached to the listing.

  • captionstring

    Accessibility caption Facebook generated for the photo.

  • heightinteger

    Pixel height of the photo.

  • idstring

    Numeric Facebook id of the photo, as a string.

  • urlstring

    Image URL of the photo.

  • widthinteger

    Pixel width of the photo.

sellerdata.seller

The person or business selling the item. Empty when Facebook does not show the seller on the listing.

  • idstring

    Facebook id of the seller, as a string.

  • imagestring

    URL of the seller's profile picture.

  • joinedUtcnumber

    UTC epoch timestamp in seconds (Unix time) the seller joined Facebook. Multiply by 1000 for a JS Date in milliseconds.

  • namestring

    The seller's display name.

  • ratingnumber

    The seller's average rating as a seller, out of 5. Absent when the seller has no ratings or keeps them private.

  • ratingCountinteger

    Number of ratings the seller has received as a seller. Absent when the seller has no ratings or keeps them private.

top level
  • 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_item,就以统一格式的 JSON 返回 Facebook 数据。通过 ID 或 URL 获取单个 Facebook Marketplace 商品的完整详情(标题、价格、地点、照片和属性),以标准化 JSON 返回。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Facebook Marketplace 商品 API 调用中有 99.9% 成功,响应时间中位数为 2.7 秒,共测量 18,689 次调用。

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

通过 ID 或 URL 获取单个 Facebook Marketplace 商品的完整详情(标题、价格、地点、照片和属性),以标准化 JSON 返回。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

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

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 83 次 Facebook Marketplace 商品,每次 US$0.0012。

向 https://api.getanyapi.com/v1/run/facebook.marketplace_item 发送 POST 请求,在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥,并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元,每个请求从中扣费。没有月度套餐,也没有最低消费,同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk,Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口,任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器,或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥,再通过 HTTP 调用这个接口。