Vai al contenuto

Riferimento dei tool

Letture in diretta

Esplorare il web e i registri in diretta. 9 tool, con i loro parametri ed esempi di chiamata.

Letture in diretta sul web e sulle reti pubbliche. Consumano crediti; nulla viene salvato nel workspace.

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.

readPage#

Legge una pagina web pubblica: titolo, testo principale (6.000 caratteri), feed individuati e 30 link.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
urlstringSì
curl -s https://piqline.com/api/v1/tools/readPage \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'

searchWeb#

Cerca nel web pubblico per trovare URL candidati.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
querystringSì
limitintegerNo
curl -s https://piqline.com/api/v1/tools/searchWeb \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"levée de fonds"}'

browserRead#

Legge una pagina dinamica o protetta con un browser forzato. Stessa forma di readPage.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
urlstringSì
curl -s https://piqline.com/api/v1/tools/browserRead \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'

waybackHistory#

Catture della Wayback Machine di un URL: prima cattura e catture recenti.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
urlstringSì
curl -s https://piqline.com/api/v1/tools/waybackHistory \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'

registryLookup#

Cerca un'azienda in un registro pubblico: Sirene (Francia), EDGAR (Stati Uniti), Companies House (Regno Unito) oppure OpenCorporates.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
registrysirene | edgar | companies_house | opencorporatesSì
querystringSì
curl -s https://piqline.com/api/v1/tools/registryLookup \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"registry":"sirene","query":"levée de fonds"}'

socialCatalog#

Elenca gli endpoint di lettura dei social network (al massimo 40), filtrabili per piattaforma.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
platformstringNo
curl -s https://piqline.com/api/v1/tools/socialCatalog \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

socialCall#

Chiama un endpoint di lettura di un social network e restituisce fino a 20 elementi compatti.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
endpointIdstringSì
paramsobjectSì
curl -s https://piqline.com/api/v1/tools/socialCall \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpointId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","params":{}}'

previewSource#

Campione in diretta (da 5 a 10 elementi) di una fonte, prima di iscriversi.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
platforminstagram | tiktok | youtube | twitter | x | threads | linkedin | reddit | …Sì
targetstringSì
kindpage | group | marketplace | profile | live | company | searchNo
curl -s https://piqline.com/api/v1/tools/previewSource \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"instagram","target":"texte"}'

whoSaidItFirst#

Chi ha pubblicato per primo un'informazione sul web, pagina per pagina, e quando le tue fonti l'hanno vista. Parte da un argomento o da un elemento; conservato come timeline privata del workspace.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
querystringNo
itemIdstringNo
curl -s https://piqline.com/api/v1/tools/whoSaidItFirst \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

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