Saltar al contenido

Referencia de herramientas

Lecturas en directo

Explorar la web y los registros en directo. 9 herramientas, con sus parámetros y ejemplos de llamada.

Lecturas en directo de la web y de las redes públicas. Consumen créditos; no se guarda nada en el workspace.

Cada llamada es una petición POST con la clave en Authorization: Bearer. El cuerpo JSON es la entrada de la herramienta, y la respuesta tiene la forma { "tool": "nom", "output": … }. Los ejemplos solo incluyen los parámetros obligatorios. Las descripciones de los parámetros son las que leen los agentes.

readPage#

Lee una página web pública: título, texto principal (6000 caracteres), feeds descubiertos y 30 enlaces.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
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#

Busca en la web pública para encontrar URL candidatas.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
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#

Lee una página dinámica o protegida con un navegador forzado. Misma forma que readPage.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
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#

Capturas de Wayback Machine de una URL: primera captura y capturas recientes.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
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#

Busca una empresa en un registro público: Sirene (Francia), EDGAR (Estados Unidos), Companies House (Reino Unido) u OpenCorporates.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
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#

Lista los endpoints de lectura de redes sociales (40 como máximo), filtrables por plataforma.

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

Tipo: Lectura en directo. Scopes: explore.

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

socialCall#

Llama a un endpoint de lectura de una red social y devuelve hasta 20 elementos compactos.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
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#

Muestra en directo (5 a 10 elementos) de una fuente, antes de suscribirse a ella.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
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#

Quién publicó primero una información en la web, página por página, y cuándo la vieron tus fuentes. Parte de un tema o de un elemento; se conserva como línea de tiempo privada del workspace.

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

Tipo: Lectura en directo. Scopes: explore.

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

¿Tienes una pregunta sobre la API o has encontrado un error en esta página? Escríbenos.