Vai al contenuto

Riferimento dei tool

Facebook

Facebook. 8 tool, con i loro parametri ed esempi di chiamata.

Tool dell'agente Facebook: annunci di Marketplace e gruppi pubblici, letti in diretta.

Ogni chiamata è una richiesta POST con la chiave in Authorization: Bearer. Il corpo JSON è l'input del tool, e la risposta ha la forma { "tool": "nom", "output": … }. Gli esempi contengono solo i parametri obbligatori. Le descrizioni dei parametri sono quelle che leggono gli agenti.

findMarketplaceLocation#

Trasforma il nome di una città o di un'area in coordinate di Marketplace.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
querystringSì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#

Cerca gli annunci pubblici di Marketplace per parola chiave attorno a un luogo (città o coordinate), su 3 pagine al massimo.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
querystringSìSearch keyword(s)
locationstringNoCity or area name; ignored when lat and lng are both given
latnumberNo
lngnumberNo
radiusKmintegerNo
minPricenumberNo
maxPricenumberNo
countintegerNo
pagesintegerNoPages to chain in one call (1 credit each); dedupes listings
sortBysuggested | creation_time_descend | distance_ascend | price_ascend | price_descendNo
deliveryall | local_pickup | shippingNo
conditionnew | used_like_new | used_good | used_fairNo
dateListedall | last_24_hours | last_7_days | last_30_daysNo
availabilityavailable | sold | allNo
categoryIdstringNoNumeric Marketplace category id, as returned in listings
excludearray<string>NoDrop listings whose title contains any of these words (e.g. 'pièces', 'cadre seul')
includearray<string>NoKeep only listings whose title contains at least one of these words
cursorstringNoOpaque 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#

Dettaglio di un annuncio: descrizione, attributi, foto, consegna, data esatta quando Facebook la fornisce.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
listingstringSì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#

Dettaglio di 2-6 annunci insieme, come tabella di confronto.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
listingsarray<string>Sì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#

Profilo pubblico di un gruppo: privacy, dimensione, attività, categorie, regole.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
groupstringSì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#

Post di un gruppo pubblico, in pagine da 3 (al massimo 6 pagine).

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
groupstringSìGroup URL, numeric id, or vanity slug
sortByCHRONOLOGICAL | CHRONOLOGICAL_LISTINGS | TOP_POSTS | RECENT_ACTIVITYNo
pagesintegerNo
keywordsarray<string>NoKeep only posts containing at least one of these terms
sincestringNoISO date; posts older than this are dropped and chronological paging stops there
cursorstringNo
curl -s https://piqline.com/api/v1/tools/getFacebookGroupPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"texte"}'

getFacebookPost#

Dettaglio di un post o reel pubblico: testo, autore, data, reazioni, visualizzazioni.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
poststringSì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#

Commenti a un post pubblico, filtrabili per parole chiave (al massimo 3 pagine).

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
poststringSìPost or reel URL
pagesintegerNo
keywordsarray<string>No
cursorstringNo
curl -s https://piqline.com/api/v1/tools/getFacebookPostComments \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post":"texte"}'

Una domanda sull'API, o un errore in questa pagina? Scrivici.