Referência das ferramentas
Leituras ao vivo
Explorar a web e os registros ao vivo. 9 ferramentas, com seus parâmetros e exemplos de chamada.
Leituras ao vivo na web e em redes públicas. Consomem créditos; nada é armazenado no workspace.
Cada chamada é uma requisição POST com a chave em Authorization: Bearer. O corpo JSON é a entrada da ferramenta, e a resposta tem o formato { "tool": "nom", "output": … }. Os exemplos trazem apenas os parâmetros obrigatórios. As descrições dos parâmetros são as que os agentes leem.
readPage#
Lê uma página web pública: título, texto principal (6.000 caracteres), feeds descobertos e 30 links.
POSThttps://piqline.com/api/v1/tools/readPage
Tipo: Leitura ao vivo. Scopes: explore.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
url | string | Sim |
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"}'const response = await fetch("https://piqline.com/api/v1/tools/readPage", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/readPage",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]searchWeb#
Pesquisa na web pública para encontrar URLs candidatas.
POSThttps://piqline.com/api/v1/tools/searchWeb
Tipo: Leitura ao vivo. Scopes: explore.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | |
limit | integer | Não |
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"}'const response = await fetch("https://piqline.com/api/v1/tools/searchWeb", {
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/searchWeb",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"query": "levée de fonds",
},
)
output = response.json()["output"]browserRead#
Lê uma página dinâmica ou protegida com um navegador forçado. Mesma forma que readPage.
POSThttps://piqline.com/api/v1/tools/browserRead
Tipo: Leitura ao vivo. Scopes: explore.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
url | string | Sim |
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"}'const response = await fetch("https://piqline.com/api/v1/tools/browserRead", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/browserRead",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]waybackHistory#
Capturas da Wayback Machine de uma URL: primeira captura e capturas recentes.
POSThttps://piqline.com/api/v1/tools/waybackHistory
Tipo: Leitura ao vivo. Scopes: explore.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
url | string | Sim |
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"}'const response = await fetch("https://piqline.com/api/v1/tools/waybackHistory", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/waybackHistory",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]registryLookup#
Consulta uma empresa em um registro público: Sirene (França), EDGAR (Estados Unidos), Companies House (Reino Unido) ou OpenCorporates.
POSThttps://piqline.com/api/v1/tools/registryLookup
Tipo: Leitura ao vivo. Scopes: explore.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
registry | sirene | edgar | companies_house | opencorporates | Sim | |
query | string | Sim |
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"}'const response = await fetch("https://piqline.com/api/v1/tools/registryLookup", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"registry": "sirene",
"query": "levée de fonds"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/registryLookup",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"registry": "sirene",
"query": "levée de fonds",
},
)
output = response.json()["output"]socialCatalog#
Lista os endpoints de leitura das redes sociais (40 no máximo), filtráveis por plataforma.
POSThttps://piqline.com/api/v1/tools/socialCatalog
Tipo: Leitura ao vivo. Scopes: explore.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
platform | string | Não |
curl -s https://piqline.com/api/v1/tools/socialCatalog \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/socialCatalog", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/socialCatalog",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]socialCall#
Chama um endpoint de leitura de rede social e devolve até 20 itens compactos.
POSThttps://piqline.com/api/v1/tools/socialCall
Tipo: Leitura ao vivo. Scopes: explore.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
endpointId | string | Sim | |
params | object | Sim |
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":{}}'const response = await fetch("https://piqline.com/api/v1/tools/socialCall", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"endpointId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
"params": {}
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/socialCall",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"endpointId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
"params": {},
},
)
output = response.json()["output"]previewSource#
Amostra ao vivo (5 a 10 itens) de uma fonte, antes de assiná-la.
POSThttps://piqline.com/api/v1/tools/previewSource
Tipo: Leitura ao vivo. Scopes: explore.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
platform | instagram | tiktok | youtube | twitter | x | threads | linkedin | reddit | … | Sim | |
target | string | Sim | |
kind | page | group | marketplace | profile | live | company | search | Não |
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"}'const response = await fetch("https://piqline.com/api/v1/tools/previewSource", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"platform": "instagram",
"target": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/previewSource",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"platform": "instagram",
"target": "texte",
},
)
output = response.json()["output"]whoSaidItFirst#
Quem publicou uma informação primeiro na web, página por página, e quando as suas fontes a viram. Parte de um assunto ou de um item; mantida como linha do tempo privada do workspace.
POSThttps://piqline.com/api/v1/tools/whoSaidItFirst
Tipo: Leitura ao vivo. Scopes: explore.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Não | |
itemId | string | Não |
curl -s https://piqline.com/api/v1/tools/whoSaidItFirst \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/whoSaidItFirst", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/whoSaidItFirst",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]