Saltar al contenido

Referencia de herramientas

LinkedIn

LinkedIn. 10 herramientas, con sus parámetros y ejemplos de llamada.

Herramientas del agente de LinkedIn: publicaciones públicas, páginas de empresa y anuncios, leídos en directo. Los datos de contacto nunca se leen.

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.

searchLinkedinPosts#

Busca publicaciones públicas por palabras clave, en tiempo real, de más reciente a más antigua (una lectura parcial se señala en el resultado), con el cargo y el rol del autor cuando la publicación es una oferta de empleo, y señales calculadas por código: contratación, captación de fondos, lanzamiento, expansión, reorganización, disponibilidad, salida.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
querystringSíOne exact phrase in double quotes as the post would say it, plus at most one or two plain words, e.g. '"je recrute" développeur'. No OR, no parentheses.
datePostedlast-hour | last-day | last-week | last-month | last-yearNo
focusall | people | hiring | signalsNopeople = only posts carrying a person pointer, hiring = hiring posts, signals = any signal
moreQueriesarray<string>NoUp to 3 other exact phrases searched together with query, same writing rule, e.g. ['"nous recrutons"', '"on recrute"']. They share depth.
depthintegerNoPosts read at most, all formulas together: 15, 50, 100 or 200. One credit per post read. 15 for a quick look; 100 is the Auto value of a broad search.
intentstringNoWhat sets the wanted posts apart, in the user's language: the job families or the topic, with a few concrete words, e.g. 'Métiers de la tech, de l'IT et de la vente : développeur, data, devops, produit, commercial, account executive, SDR'. Do NOT write what…
relevancewide | balanced | strictNoHow close to intent a post must be: wide keeps more, strict keeps few. Ignored without intent.
authorall | recruiter | founder | managerNoKeep only posts whose author's title reads as recruiter, founder or manager. Titles exist on hiring posts only.
orderrecent | closestNorecent = newest first; closest = closest in meaning to intent first.
placestringNoPlace the user cares about, e.g. 'France' or 'Lyon'. It weighs in the closeness score; it is not a hard filter.
tuningauto | manualNoauto = these values were chosen by you; the card sets manual when the user changed them.
cursorstringNonextCursor from a previous call
curl -s https://piqline.com/api/v1/tools/searchLinkedinPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"levée de fonds"}'

probeLinkedinWatch#

Prueba de 1 a 3 variantes de consulta antes de suscribirse a una vigilancia de LinkedIn, y devuelve el ticket de investigación que se adjunta a la suscripción.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
intentstringSíUser ask in natural language, e.g. « Suis les levées série A fintech chaque semaine »
variantsarray<object>SíCandidate keyword formulations as the market writes them
detectionEventhiring | funding | launch | expansion | reorg | open_to_work | leaving | interested_comment | …No
detectionRoundsarray<pre_seed | seed | series_a | series_b | series_c | series_d | bridge | extension | …>No
detectionSectorsarray<string>No
detectionGeosarray<string>No
detectionVocabularyarray<string>No
curl -s https://piqline.com/api/v1/tools/probeLinkedinWatch \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"intent":"texte","variants":[{"query":"levée de fonds"}]}'

getLinkedinPost#

Lee una publicación o artículo público: texto, autor, fecha, reacciones, comentarios con sus señales.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
urlstringSílinkedin.com/posts/…, /feed/update/… or /pulse/…
curl -s https://piqline.com/api/v1/tools/getLinkedinPost \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'

getLinkedinPostTranscript#

Transcripción del vídeo de una publicación pública, facturada solo si existe.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
urlstringSíURL of the LinkedIn video post
curl -s https://piqline.com/api/v1/tools/getLinkedinPostTranscript \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'

getLinkedinCompany#

Página pública de empresa: descripción, plantilla, sector, financiación, últimas publicaciones con sus señales.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
companystringSíURL linkedin.com/company/… ou handle (ex. shopify)
curl -s https://piqline.com/api/v1/tools/getLinkedinCompany \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"texte"}'

getLinkedinCompanyPosts#

Publicaciones anteriores de una página de empresa, con un resumen de las señales (contratación, financiación, lanzamientos).

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
companystringSíURL linkedin.com/company/… ou handle
pageintegerNo
curl -s https://piqline.com/api/v1/tools/getLinkedinCompanyPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"texte"}'

searchLinkedinAds#

Busca en la biblioteca de anuncios: anunciante, formato, fechas, impresiones.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
companystringNoNom d’entreprise, ex. Shopify
companyIdstringNoId numérique LinkedIn de l’entreprise
keywordstringNoMot-clé secteur
countriesstringNoCodes pays ISO séparés par des virgules, ex. FR,ES
startDatestringNo
endDatestringNo
paginationTokenstringNo
curl -s https://piqline.com/api/v1/tools/searchLinkedinAds \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

getLinkedinAd#

Detalle de un anuncio de la biblioteca: segmentación, impresiones por país, duración.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
urlstringSílinkedin.com/ad-library/detail/… URL
curl -s https://piqline.com/api/v1/tools/getLinkedinAd \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'

matchLinkedinPosts#

Empareja personas disponibles con oportunidades a partir de publicaciones públicas (dos búsquedas).

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
peopleQuerystringSí
opportunityQuerystringSí
datePostedlast-hour | last-day | last-week | last-month | last-yearNo
semanticbooleanNoRe-rank by closeness in meaning when available
curl -s https://piqline.com/api/v1/tools/matchLinkedinPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"peopleQuery":"texte","opportunityQuery":"texte"}'

getLinkedinProfile#

Lectura acotada de un perfil público /in/, solo a partir de una publicación pública que nombra a la persona. Reservada a los workspaces que han activado esta opción.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
urlstringSílinkedin.com/in/… URL from a pointer or pasted by the user
basispointer | pastedSí
postUrlstringNoRequired with basis='pointer': the public post carrying the signal
curl -s https://piqline.com/api/v1/tools/getLinkedinProfile \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article","basis":"pointer"}'

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