Aller au contenu

Référence des outils

LinkedIn

LinkedIn. 10 outils, avec leurs paramètres et des exemples d’appel.

Outils de l’agent LinkedIn : posts, pages entreprise et publicités publics, lus en direct. Aucune coordonnée n’est jamais lue.

Chaque appel est une requête POST avec la clé en Authorization: Bearer. Le corps JSON est l’entrée de l’outil, et la réponse a la forme { "tool": "nom", "output": … }. Les exemples ne portent que les paramètres requis. Les descriptions des paramètres sont celles que lisent les agents, en anglais.

searchLinkedinPosts#

Recherche de posts publics par mots-clés, en temps réel, du plus récent au plus ancien (une lecture partielle est signalée dans le résultat), avec le titre et le rôle de l’auteur quand le post recrute, et des signaux calculés par le code : recrutement, levée, lancement, expansion, réorganisation, disponibilité, départ.

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
querystringOuiOne 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-yearNon
focusall | people | hiring | signalsNonpeople = only posts carrying a person pointer, hiring = hiring posts, signals = any signal
moreQueriesarray<string>NonUp to 3 other exact phrases searched together with query, same writing rule, e.g. ['"nous recrutons"', '"on recrute"']. They share depth.
depthintegerNonPosts 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.
intentstringNonWhat 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 | strictNonHow close to intent a post must be: wide keeps more, strict keeps few. Ignored without intent.
authorall | recruiter | founder | managerNonKeep only posts whose author's title reads as recruiter, founder or manager. Titles exist on hiring posts only.
orderrecent | closestNonrecent = newest first; closest = closest in meaning to intent first.
placestringNonPlace the user cares about, e.g. 'France' or 'Lyon'. It weighs in the closeness score; it is not a hard filter.
tuningauto | manualNonauto = these values were chosen by you; the card sets manual when the user changed them.
cursorstringNonnextCursor 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#

Sonde 1 à 3 variantes de requête avant de s’abonner à une veille LinkedIn, et renvoie le ticket d’enquête à joindre à l’abonnement.

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
intentstringOuiUser ask in natural language, e.g. « Suis les levées série A fintech chaque semaine »
variantsarray<object>OuiCandidate keyword formulations as the market writes them
detectionEventhiring | funding | launch | expansion | reorg | open_to_work | leaving | interested_comment | …Non
detectionRoundsarray<pre_seed | seed | series_a | series_b | series_c | series_d | bridge | extension | …>Non
detectionSectorsarray<string>Non
detectionGeosarray<string>Non
detectionVocabularyarray<string>Non
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#

Lit un post ou un article public : texte, auteur, date, réactions, commentaires avec leurs signaux.

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
urlstringOuilinkedin.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#

Transcription de la vidéo d’un post public, facturée seulement si elle existe.

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
urlstringOuiURL 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#

Page entreprise publique : description, effectif, secteur, financement, derniers posts avec leurs signaux.

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
companystringOuiURL 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 plus anciens d’une page entreprise, avec un résumé des signaux (recrutement, financement, lancements).

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
companystringOuiURL linkedin.com/company/… ou handle
pageintegerNon
curl -s https://piqline.com/api/v1/tools/getLinkedinCompanyPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"texte"}'

searchLinkedinAds#

Recherche dans la bibliothèque publicitaire : annonceur, format, dates, impressions.

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
companystringNonNom d’entreprise, ex. Shopify
companyIdstringNonId numérique LinkedIn de l’entreprise
keywordstringNonMot-clé secteur
countriesstringNonCodes pays ISO séparés par des virgules, ex. FR,ES
startDatestringNon
endDatestringNon
paginationTokenstringNon
curl -s https://piqline.com/api/v1/tools/searchLinkedinAds \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

getLinkedinAd#

Détail d’une publicité de la bibliothèque : ciblage, impressions par pays, durée.

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
urlstringOuilinkedin.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#

Rapproche des personnes disponibles et des opportunités à partir de posts publics (deux recherches).

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
peopleQuerystringOui
opportunityQuerystringOui
datePostedlast-hour | last-day | last-week | last-month | last-yearNon
semanticbooleanNonRe-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#

Lecture bornée d’un profil /in/ public, uniquement à partir d’un post public qui désigne la personne. Réservé aux workspaces qui ont activé cette option.

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

Type : Lecture en direct. Scopes : explore.

ParamètreTypeRequisDescription
urlstringOuilinkedin.com/in/… URL from a pointer or pasted by the user
basispointer | pastedOui
postUrlstringNonRequired 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"}'

Une question sur l’API, ou une erreur dans cette page ? Écrivez-nous.