探索覆盖 Instagram、TikTok、YouTube 和 Facebook 的公开社交数据 API
SocQSocQ
返回 API 目录
独立的 Facebook Marketplace 数据

Facebook Marketplace API

将地点解析为搜索坐标，按关键词和位置发现公开 Marketplace 商品，或通过已知商品 URL 获取详细价格、卖家、媒体、属性和可用状态数据。

可用的 Facebook Marketplace API

解析地点时使用 Location Search，在坐标附近发现商品时使用 Search，通过已知 Marketplace 商品 URL 获取详细记录时使用 Item。

facebook-marketplace/location-search

搜索每条结果 0.3 积分

facebook-marketplace/search

搜索每条结果 0.7 积分

facebook-marketplace/item

帖子每条结果 0.6 积分

可以获取哪些 Facebook Marketplace 数据？

SocQ 返回标准化公开位置候选、商品搜索结果和商品详情，可用于本地市场研究、价格分析、库存监测和商品数据补全。

Marketplace 位置候选

将城市、地区、街区或地点名称解析为 Facebook 位置 ID、标签、地址信息、纬度和经度。

公开商品身份

在字段可用时获取商品 ID、标题、说明、来源 URL、分类、上架时间说明和采集时间。

价格与币种

为每条标准化商品记录保留可用的价格数值、币种代码、格式化价格和划线价。

位置与配送数据

获取可用的地点标签、城市、州、坐标、配送类型、邮寄状态和自提信息。

媒体、属性与卖家信息

在公开来源提供时采集商品图片、商品属性、成色和卖家身份字段。

可用状态与商品状态

保留 available、sold、pending、hidden、live、messaging 和 buy-now 等采集时状态。

SocQ 与 Meta Graph API 对比

SocQ 专注于受支持的公开 Marketplace 数据采集；Meta Graph API 面向已授权的 Meta 资产，不提供通用的公开 Marketplace 搜索 API。

能力SocQMeta Graph API
主要用途采集公开 Marketplace 位置、搜索结果和商品详情管理用户或企业已授权的受支持资产
客户 OAuth使用 SocQ API key，无需客户 Facebook OAuth需要 Meta app、权限和 access token
公开商品搜索支持按关键词和已解析位置搜索没有通用的公开 Marketplace 商品搜索 endpoint
创建或编辑商品不支持没有面向普通 Marketplace 商品的通用发布 endpoint
返回格式标准化 SocQ 记录受支持产品的 Graph API 原生对象

Facebook Marketplace API 如何工作

需要时先解析搜索中心，再提交商品搜索或已知商品 URL，并通过共享异步任务流程读取标准化记录。

  1. 1. 准备起始输入

    将地点名称解析为坐标，使用已有坐标，或直接从一个公开 Marketplace 商品 URL 开始。

  2. 2. 提交并跟踪任务

    发送对应的 POST 请求，保存返回的 task_id，并轮询 /v1/tasks/{task_id} 直到处理结束。

  3. 3. 读取标准化结果

    处理 data.results.items，并在 has_more 为 true 时继续使用 next_cursor。

解析位置并搜索商品

先解析地点名称，再使用所选位置候选的坐标搜索公开 Marketplace 商品。

# 解析地点名称
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/location-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Austin"}'

# 围绕所选坐标搜索商品
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"bike","latitude":30.2677,"longitude":-97.7475,"results_limit":100}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor

常见 Facebook Marketplace API 使用场景

本地商品发现

解析目标市场，并按关键词、坐标、半径、价格、成色、配送方式、上架日期或可用状态搜索公开商品。

本地价格对比

对比相似公开商品的标准化报价、币种、标题、分类、成色和位置。

区域库存监测

采集指定市场内数量受控的商品快照，对比不同时间的公开库存、配送方式和可用状态。

已知商品数据补全

将已知商品 URL 转换为包含说明、卖家、价格、位置、媒体、属性和状态字段的详细记录。

限制与公开数据边界

Marketplace 结果是采集时的公开记录。这些 API 不复刻消费者 Marketplace 界面，也不管理商品或账号。

  • Location Search 要求一个非空地点名称 query，不支持 results_limit，并可能返回多个名称相近的候选。
  • 将位置候选作为商品搜索中心前，需要核对地址信息和坐标。
  • Search 要求非空关键词、latitude 和 longitude；results_limit 默认为 100，可设置为 1 到 2,000 的整数。
  • Search 结果可能缺少说明、卖家详情、精确坐标、属性和创建时间，重复商品 ID 只保存一次。
  • Item 要求受支持的 /marketplace/item/{numeric_id} URL；每个有效 URL 最多返回一条记录，不可用商品可能被跳过。
  • 空结果可能来自没有公开匹配、筛选条件过严、地区可用性、商品不可用或公开来源边界。

Facebook Marketplace API 常见问题

Facebook Marketplace API 是什么？

Facebook Marketplace API 是 SocQ 提供的一组 API，用于解析 Marketplace 位置、搜索公开商品，以及通过已知商品 URL 获取详细记录。

应该使用哪个 Facebook Marketplace API？

解析地点时使用 Location Search，在坐标附近发现商品时使用 Search，已有公开 Marketplace 商品 URL 时使用 Item。

如何按位置搜索 Facebook Marketplace？

向 Location Search 提交城市、地区、街区或地点名称，选择正确的位置候选，再将其 latitude 和 longitude 传给 Search。

Facebook Marketplace Search 返回什么？

Search 可返回商品身份、标题、说明、价格、位置、图片、卖家信息、分类、配送方式、状态字段、来源 URL 和采集时间。

什么时候应该使用 Facebook Marketplace Item？

已有公开商品 URL，并需要详细说明、卖家、价格、位置、媒体、属性、配送和可用状态字段时使用 Item。

为什么结果数量可能低于 results_limit？

results_limit 是请求上限。没有更多公开页面、筛选条件排除记录或去除重复商品 ID 时，实际结果可能更少。

Facebook Marketplace 结果如何计费？

位置候选每条消耗 0.3 积分，Search 商品每条消耗 0.7 积分，Item 记录每条消耗 0.6 积分；空结果不产生结果费用。