도구 레퍼런스
Facebook. 도구 8개와 매개변수, 호출 예제.
Facebook 에이전트의 도구입니다. Marketplace 매물과 공개 그룹을 실시간으로 읽습니다.
각 호출은 Authorization: Bearer에 키를 넣은 POST 요청입니다. JSON 본문이 도구의 입력이며, 응답은 { "tool": "nom", "output": … } 형태입니다. 예제에는 필수 매개변수만 포함되어 있습니다. 매개변수 설명은 에이전트가 읽는 설명과 같습니다.
findMarketplaceLocation#
도시 또는 지역 이름을 Marketplace 좌표로 변환합니다.
POSThttps://piqline.com/api/v1/tools/findMarketplaceLocation
유형: 실시간 읽기. 스코프: explore.
| 매개변수 | 형식 | 필수 | 설명 |
|---|---|---|---|
query | string | 예 | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/findMarketplaceLocation", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"query": "levée de fonds"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/findMarketplaceLocation",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"query": "levée de fonds",
},
)
output = response.json()["output"]searchMarketplace#
장소(도시 또는 좌표) 주변의 공개 Marketplace 매물을 키워드로 검색합니다. 최대 3페이지.
POSThttps://piqline.com/api/v1/tools/searchMarketplace
유형: 실시간 읽기. 스코프: explore.
| 매개변수 | 형식 | 필수 | 설명 |
|---|---|---|---|
query | string | 예 | Search keyword(s) |
location | string | 아니요 | City or area name; ignored when lat and lng are both given |
lat | number | 아니요 | |
lng | number | 아니요 | |
radiusKm | integer | 아니요 | |
minPrice | number | 아니요 | |
maxPrice | number | 아니요 | |
count | integer | 아니요 | |
pages | integer | 아니요 | Pages to chain in one call (1 credit each); dedupes listings |
sortBy | suggested | creation_time_descend | distance_ascend | price_ascend | price_descend | 아니요 | |
delivery | all | local_pickup | shipping | 아니요 | |
condition | new | used_like_new | used_good | used_fair | 아니요 | |
dateListed | all | last_24_hours | last_7_days | last_30_days | 아니요 | |
availability | available | sold | all | 아니요 | |
categoryId | string | 아니요 | Numeric Marketplace category id, as returned in listings |
exclude | array<string> | 아니요 | Drop listings whose title contains any of these words (e.g. 'pièces', 'cadre seul') |
include | array<string> | 아니요 | Keep only listings whose title contains at least one of these words |
cursor | string | 아니요 | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/searchMarketplace", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"query": "levée de fonds"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/searchMarketplace",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"query": "levée de fonds",
},
)
output = response.json()["output"]getMarketplaceListing#
매물의 상세: 설명, 속성, 사진, 배송, Facebook이 제공하는 경우 정확한 날짜.
POSThttps://piqline.com/api/v1/tools/getMarketplaceListing
유형: 실시간 읽기. 스코프: explore.
| 매개변수 | 형식 | 필수 | 설명 |
|---|---|---|---|
listing | string | 예 | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/getMarketplaceListing", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"listing": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getMarketplaceListing",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"listing": "texte",
},
)
output = response.json()["output"]getMarketplaceListings#
매물 2~6개의 상세를 비교 표로 한 번에 가져옵니다.
POSThttps://piqline.com/api/v1/tools/getMarketplaceListings
유형: 실시간 읽기. 스코프: explore.
| 매개변수 | 형식 | 필수 | 설명 |
|---|---|---|---|
listings | array<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"]}'const response = await fetch("https://piqline.com/api/v1/tools/getMarketplaceListings", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"listings": [
"texte"
]
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getMarketplaceListings",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"listings": [
"texte",
],
},
)
output = response.json()["output"]getFacebookGroup#
그룹의 공개 프로필: 공개 범위, 규모, 활동, 카테고리, 규칙.
POSThttps://piqline.com/api/v1/tools/getFacebookGroup
유형: 실시간 읽기. 스코프: explore.
| 매개변수 | 형식 | 필수 | 설명 |
|---|---|---|---|
group | string | 예 | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/getFacebookGroup", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"group": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getFacebookGroup",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"group": "texte",
},
)
output = response.json()["output"]getFacebookGroupPosts#
공개 그룹의 게시물을 3개씩 페이지로 가져옵니다(최대 6페이지).
POSThttps://piqline.com/api/v1/tools/getFacebookGroupPosts
유형: 실시간 읽기. 스코프: explore.
| 매개변수 | 형식 | 필수 | 설명 |
|---|---|---|---|
group | string | 예 | Group URL, numeric id, or vanity slug |
sortBy | CHRONOLOGICAL | CHRONOLOGICAL_LISTINGS | TOP_POSTS | RECENT_ACTIVITY | 아니요 | |
pages | integer | 아니요 | |
keywords | array<string> | 아니요 | Keep only posts containing at least one of these terms |
since | string | 아니요 | ISO date; posts older than this are dropped and chronological paging stops there |
cursor | string | 아니요 |
curl -s https://piqline.com/api/v1/tools/getFacebookGroupPosts \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"group":"texte"}'const response = await fetch("https://piqline.com/api/v1/tools/getFacebookGroupPosts", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"group": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getFacebookGroupPosts",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"group": "texte",
},
)
output = response.json()["output"]getFacebookPost#
공개 게시물 또는 릴스의 상세: 텍스트, 작성자, 날짜, 반응, 조회수.
POSThttps://piqline.com/api/v1/tools/getFacebookPost
유형: 실시간 읽기. 스코프: explore.
| 매개변수 | 형식 | 필수 | 설명 |
|---|---|---|---|
post | string | 예 | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/getFacebookPost", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"post": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getFacebookPost",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"post": "texte",
},
)
output = response.json()["output"]getFacebookPostComments#
공개 게시물의 댓글을 키워드로 필터링할 수 있습니다(최대 3페이지).
POSThttps://piqline.com/api/v1/tools/getFacebookPostComments
유형: 실시간 읽기. 스코프: explore.
| 매개변수 | 형식 | 필수 | 설명 |
|---|---|---|---|
post | string | 예 | Post or reel URL |
pages | integer | 아니요 | |
keywords | array<string> | 아니요 | |
cursor | string | 아니요 |
curl -s https://piqline.com/api/v1/tools/getFacebookPostComments \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"post":"texte"}'const response = await fetch("https://piqline.com/api/v1/tools/getFacebookPostComments", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"post": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getFacebookPostComments",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"post": "texte",
},
)
output = response.json()["output"]