Ir para o conteúdo

Referência das ferramentas

LinkedIn

LinkedIn. 10 ferramentas, com seus parâmetros e exemplos de chamada.

Ferramentas do agente LinkedIn: posts públicos, páginas de empresas e anúncios, lidos ao vivo. Os dados de contato nunca são lidos.

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.

searchLinkedinPosts#

Pesquisa posts públicos por palavras-chave, em tempo real, dos mais novos aos mais antigos (uma leitura parcial é sinalizada no resultado), com o cargo e o papel do autor quando o post é de contratação, e sinais calculados pelo código: contratação, captação de recursos, lançamento, expansão, reorganização, disponibilidade, saída.

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

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
querystringSimOne 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-yearNão
focusall | people | hiring | signalsNãopeople = only posts carrying a person pointer, hiring = hiring posts, signals = any signal
moreQueriesarray<string>NãoUp to 3 other exact phrases searched together with query, same writing rule, e.g. ['"nous recrutons"', '"on recrute"']. They share depth.
depthintegerNãoPosts 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.
intentstringNãoWhat 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 | strictNãoHow close to intent a post must be: wide keeps more, strict keeps few. Ignored without intent.
authorall | recruiter | founder | managerNãoKeep only posts whose author's title reads as recruiter, founder or manager. Titles exist on hiring posts only.
orderrecent | closestNãorecent = newest first; closest = closest in meaning to intent first.
placestringNãoPlace the user cares about, e.g. 'France' or 'Lyon'. It weighs in the closeness score; it is not a hard filter.
tuningauto | manualNãoauto = these values were chosen by you; the card sets manual when the user changed them.
cursorstringNãonextCursor 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#

Testa de 1 a 3 variantes de consulta antes de assinar um monitoramento do LinkedIn e devolve o ticket de investigação a anexar à assinatura.

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

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
intentstringSimUser ask in natural language, e.g. « Suis les levées série A fintech chaque semaine »
variantsarray<object>SimCandidate keyword formulations as the market writes them
detectionEventhiring | funding | launch | expansion | reorg | open_to_work | leaving | interested_comment | …Não
detectionRoundsarray<pre_seed | seed | series_a | series_b | series_c | series_d | bridge | extension | …>Não
detectionSectorsarray<string>Não
detectionGeosarray<string>Não
detectionVocabularyarray<string>Não
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#

Lê um post ou artigo público: texto, autor, data, reações, comentários com seus sinais.

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

Tipo: Leitura ao vivo. Scopes: explore.

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

Transcrição do vídeo de um post público, cobrada apenas se existir.

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

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
urlstringSimURL 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 uma empresa: descrição, número de funcionários, setor, financiamento, últimos posts com seus sinais.

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

Tipo: Leitura ao vivo. Scopes: explore.

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

Posts mais antigos da página de uma empresa, com um resumo dos sinais (contratação, financiamento, lançamentos).

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

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
companystringSimURL linkedin.com/company/… ou handle
pageintegerNão
curl -s https://piqline.com/api/v1/tools/getLinkedinCompanyPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"texte"}'

searchLinkedinAds#

Pesquisa a biblioteca de anúncios: anunciante, formato, datas, impressões.

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

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
companystringNãoNom d’entreprise, ex. Shopify
companyIdstringNãoId numérique LinkedIn de l’entreprise
keywordstringNãoMot-clé secteur
countriesstringNãoCodes pays ISO séparés par des virgules, ex. FR,ES
startDatestringNão
endDatestringNão
paginationTokenstringNão
curl -s https://piqline.com/api/v1/tools/searchLinkedinAds \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

getLinkedinAd#

Detalhe de um anúncio da biblioteca: segmentação, impressões por país, duração.

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

Tipo: Leitura ao vivo. Scopes: explore.

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

Cruza pessoas disponíveis com oportunidades vindas de posts públicos (duas pesquisas).

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

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
peopleQuerystringSim
opportunityQuerystringSim
datePostedlast-hour | last-day | last-week | last-month | last-yearNão
semanticbooleanNãoRe-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#

Leitura limitada de um perfil público /in/, somente a partir de um post público que nomeia a pessoa. Reservada aos workspaces que ativaram esta opção.

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

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
urlstringSimlinkedin.com/in/… URL from a pointer or pasted by the user
basispointer | pastedSim
postUrlstringNãoRequired 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"}'

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