본문으로 건너뛰기

도구 레퍼런스

Facebook

Facebook. 도구 8개와 매개변수, 호출 예제.

Facebook 에이전트의 도구입니다. Marketplace 매물과 공개 그룹을 실시간으로 읽습니다.

각 호출은 Authorization: Bearer에 키를 넣은 POST 요청입니다. 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에 대한 질문이 있거나 이 페이지에 오류가 있나요? 문의하기.