本文へスキップ

ツールリファレンス

Facebook

Facebook。8 個のツールを、パラメーターと呼び出し例とともに掲載しています。

Facebook エージェントのツールです。Marketplace の出品と公開グループをライブで読み取ります。

各呼び出しは POST リクエストで、キーは Authorization: Bearer に入れます。JSON の本文がツールの入力で、レスポンスは { "tool": "nom", "output": … } の形式です。例には必須パラメーターだけを入れています。パラメーターの説明は、エージェントが読むものと同じです。

findMarketplaceLocation#

都市または地域の名前を、Marketplace の座標に変換します。

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

種類: ライブ読み取り。スコープ: 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

種類: ライブ読み取り。スコープ: 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

種類: ライブ読み取り。スコープ: 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

種類: ライブ読み取り。スコープ: 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

種類: ライブ読み取り。スコープ: 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

種類: ライブ読み取り。スコープ: 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#

公開投稿またはリールの詳細。テキスト、投稿者、日付、リアクション、再生数。

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

種類: ライブ読み取り。スコープ: 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

種類: ライブ読み取り。スコープ: 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 についてのご質問や、このページの誤りはありませんか。 お問い合わせ.