跳到正文

工具参考

Facebook

Facebook。8 个工具,附参数和调用示例。

Facebook 智能体的工具:实时读取 Marketplace 商品和公开群组。

每次调用都是一个 POST 请求,密钥放在 Authorization: Bearer 中。JSON 请求体是工具的输入,响应形如 { "tool": "nom", "output": … }。示例中只包含必填参数。参数说明与智能体读到的相同。

findMarketplaceLocation#

把城市或区域名称转换为 Marketplace 坐标。

POSThttps://piqline.com/api/v1/tools/findMarketplaceLocation

类型:实时读取。Scope:explore。

参数类型必填说明
querystring是City or area name, e.g. 'Lyon' or 'Austin, Texas'
curl -s https://piqline.com/api/v1/tools/findMarketplaceLocation \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"levée de fonds"}'

searchMarketplace#

按关键词搜索某地(城市或坐标)周边的 Marketplace 公开商品,最多 3 页。

POSThttps://piqline.com/api/v1/tools/searchMarketplace

类型:实时读取。Scope:explore。

参数类型必填说明
querystring是Search keyword(s)
locationstring否City or area name; ignored when lat and lng are both given
latnumber否
lngnumber否
radiusKminteger否
minPricenumber否
maxPricenumber否
countinteger否
pagesinteger否Pages to chain in one call (1 credit each); dedupes listings
sortBysuggested | creation_time_descend | distance_ascend | price_ascend | price_descend否
deliveryall | local_pickup | shipping否
conditionnew | used_like_new | used_good | used_fair否
dateListedall | last_24_hours | last_7_days | last_30_days否
availabilityavailable | sold | all否
categoryIdstring否Numeric Marketplace category id, as returned in listings
excludearray<string>否Drop listings whose title contains any of these words (e.g. 'pièces', 'cadre seul')
includearray<string>否Keep only listings whose title contains at least one of these words
cursorstring否Opaque cursor from a previous page
curl -s https://piqline.com/api/v1/tools/searchMarketplace \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"levée de fonds"}'

getMarketplaceListing#

商品详情:描述、属性、照片、配送,以及 Facebook 提供时的确切日期。

POSThttps://piqline.com/api/v1/tools/getMarketplaceListing

类型:实时读取。Scope:explore。

参数类型必填说明
listingstring是Listing id or Marketplace item URL
curl -s https://piqline.com/api/v1/tools/getMarketplaceListing \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing":"texte"}'

getMarketplaceListings#

一次获取 2 到 6 个商品的详情,以对比表格形式返回。

POSThttps://piqline.com/api/v1/tools/getMarketplaceListings

类型:实时读取。Scope:explore。

参数类型必填说明
listingsarray<string>是Listing ids or Marketplace item URLs
curl -s https://piqline.com/api/v1/tools/getMarketplaceListings \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listings":["texte"]}'

getFacebookGroup#

群组的公开资料:隐私设置、规模、活跃度、分类、规则。

POSThttps://piqline.com/api/v1/tools/getFacebookGroup

类型:实时读取。Scope:explore。

参数类型必填说明
groupstring是Group URL, numeric id, or vanity slug
curl -s https://piqline.com/api/v1/tools/getFacebookGroup \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"texte"}'

getFacebookGroupPosts#

公开群组的帖子,每页 3 条(最多 6 页)。

POSThttps://piqline.com/api/v1/tools/getFacebookGroupPosts

类型:实时读取。Scope:explore。

参数类型必填说明
groupstring是Group URL, numeric id, or vanity slug
sortByCHRONOLOGICAL | CHRONOLOGICAL_LISTINGS | TOP_POSTS | RECENT_ACTIVITY否
pagesinteger否
keywordsarray<string>否Keep only posts containing at least one of these terms
sincestring否ISO date; posts older than this are dropped and chronological paging stops there
cursorstring否
curl -s https://piqline.com/api/v1/tools/getFacebookGroupPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"texte"}'

getFacebookPost#

公开帖子或 Reel 的详情:文本、作者、日期、互动、观看数。

POSThttps://piqline.com/api/v1/tools/getFacebookPost

类型:实时读取。Scope:explore。

参数类型必填说明
poststring是Post or reel URL
curl -s https://piqline.com/api/v1/tools/getFacebookPost \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post":"texte"}'

getFacebookPostComments#

公开帖子的评论,可按关键词筛选(最多 3 页)。

POSThttps://piqline.com/api/v1/tools/getFacebookPostComments

类型:实时读取。Scope:explore。

参数类型必填说明
poststring是Post or reel URL
pagesinteger否
keywordsarray<string>否
cursorstring否
curl -s https://piqline.com/api/v1/tools/getFacebookPostComments \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post":"texte"}'

对 API 有疑问,或发现本页有误? 联系我们.