Facebook API

Facebook Marketplace 商品 API

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

POST/v1/run/facebook.marketplace_item
可用率
100.00%
30d · 343 次调用
请求数
343
30d · 按周,近 12 周
响应时间
2.2s
中位数 · 30d

价格

一个价格,以美元计

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "attributes": [
      {
        "label": "Example title",
        "name": "Example title",
        "value": "19.99"
      }
    ],
    "categoryId": "general",
    "creationTime": "2024-01-15T09:30:00Z",
    "currency": "USD",
    "deliveryTypes": [
      "general"
    ],
    "description": "A short example description of this item.",
    "id": "a1b2c3d4",
    "isBuyNowEnabled": true,
    "isHidden": false,
    "isLive": true,
    "isPending": true,
    "isShippingOffered": true,
    "isSold": true,
    "latitude": 37.7749,
    "listingDateText": "A short example description of this item.",
    "locationText": "A short example description of this item.",
    "longitude": -122.4194,
    "messagingEnabled": true,
    "photos": [
      {
        "caption": "A short example description of this item.",
        "height": 42,
        "id": "a1b2c3d4",
        "url": "https://example.com/page",
        "width": 1024
      }
    ],
    "priceAmount": 19.99,
    "priceFormatted": "19.99",
    "shareUrl": "https://example.com/page",
    "strikethroughPriceFormatted": "19.99",
    "title": "Example title",
    "url": "https://example.com/page"
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface FacebookMarketplaceItemResponse {
  data: {
    attributes?: {
      label?: string;
      name?: string;
      value?: string;
    }[];
    categoryId: string;
    creationTime: string;
    currency: string;
    deliveryTypes?: string[];
    description: string;
    id: string;
    isBuyNowEnabled?: boolean;
    isHidden?: boolean;
    isLive: boolean;
    isPending?: boolean;
    isShippingOffered?: boolean;
    isSold: boolean;
    latitude?: number;
    listingDateText?: string;
    locationText: string;
    longitude?: number;
    messagingEnabled?: boolean;
    photos?: {
      caption?: string;
      height?: number;
      id?: string;
      url?: string;
      width?: number;
    }[];
    priceAmount: number;
    priceFormatted: string;
    shareUrl?: string;
    strikethroughPriceFormatted?: string;
    title: string;
    url: string;
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/facebook.marketplace_item
curl -X POST https://api.getanyapi.com/v1/run/facebook.marketplace_item \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.facebook.com/marketplace/item/1656586118821988/"}'
字段类型示例值
请求体
idstringFacebook Marketplace 商品 ID。
urlstring"https://www.facebook.com/marketplace/item/1656586118821988/"Facebook Marketplace 商品 URL。
响应
dataobject
data.attributesobject[]Item specifics Facebook publishes for the listing.
data.attributes[].labelstringDisplay label for the value, e.g. "Used - Good".
data.attributes[].namestringAttribute name, e.g. "Condition".
data.attributes[].valuestringRaw attribute value, e.g. "used_good".
data.categoryIdstringPopulated whenever the provider has data for the entity.
data.creationTimestringPopulated whenever the provider has data for the entity.
data.currencystringPopulated whenever the provider has data for the entity.
data.deliveryTypesstring[]Delivery options the seller offers, e.g. "IN_PERSON" or "SHIPPING".
data.descriptionstringPopulated whenever the provider has data for the entity.
data.idstringPopulated whenever the provider has data for the entity.
data.isBuyNowEnabledbooleanWhether buy-now checkout is enabled on the listing.
data.isHiddenbooleanWhether the listing is hidden.
data.isLiveboolean
data.isPendingbooleanWhether the listing is marked pending.
data.isShippingOfferedbooleanWhether the seller offers shipping.
data.isSoldboolean
data.latitudenumberLatitude of the listing's location.
data.listingDateTextstringHuman-readable listing age Facebook shows, e.g. "Listed 4 months ago".
data.locationTextstringPopulated whenever the provider has data for the entity.
data.longitudenumberLongitude of the listing's location.
data.messagingEnabledbooleanWhether buyers can message the seller about the listing.
data.photosobject[]Photos attached to the listing.
data.photos[].captionstringAccessibility caption Facebook generated for the photo.
data.photos[].heightintegerPixel height of the photo.
data.photos[].idstringNumeric Facebook id of the photo, as a string.
data.photos[].urlstringImage URL of the photo.
data.photos[].widthintegerPixel width of the photo.
data.priceAmountnumberPopulated whenever the provider has data for the entity.
data.priceFormattedstringPopulated whenever the provider has data for the entity.
data.shareUrlstringCanonical shareable Marketplace URL of the listing.
data.strikethroughPriceFormattedstringPrevious price shown struck through, formatted for display.
data.titlestringPopulated whenever the provider has data for the entity.
data.urlstringPopulated whenever the provider has data for the entity.
foundboolean
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.
价格
每次请求价格USDUS$0.0012
价格(/千次请求)USDUS$1.20

常见问题

关于 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 调用中有 100.0% 成功,响应时间中位数为 2.2 秒,共测量 343 次调用。

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

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

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