Ir para o conteúdo

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âmetroTipoObrigatórioDescrição
urlstringSim
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#

Pesquisa na web pública para encontrar URLs candidatas.

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

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
querystringSim
limitintegerNã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"}'

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âmetroTipoObrigatórioDescrição
urlstringSim
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#

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âmetroTipoObrigatórioDescrição
urlstringSim
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#

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âmetroTipoObrigatórioDescrição
registrysirene | edgar | companies_house | opencorporatesSim
querystringSim
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#

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âmetroTipoObrigatórioDescrição
platformstringNão
curl -s https://piqline.com/api/v1/tools/socialCatalog \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

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âmetroTipoObrigatórioDescrição
endpointIdstringSim
paramsobjectSim
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#

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âmetroTipoObrigatórioDescrição
platforminstagram | tiktok | youtube | twitter | x | threads | linkedin | reddit | …Sim
targetstringSim
kindpage | group | marketplace | profile | live | company | searchNã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"}'

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âmetroTipoObrigatórioDescrição
querystringNão
itemIdstringNão
curl -s https://piqline.com/api/v1/tools/whoSaidItFirst \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Uma dúvida sobre a API, ou um erro nesta página? Escreva para nós.