Référence des outils
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ètre | Type | Requis | Description |
|---|---|---|---|
query | string | Oui | 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. |
datePosted | last-hour | last-day | last-week | last-month | last-year | Non | |
focus | all | people | hiring | signals | Non | people = only posts carrying a person pointer, hiring = hiring posts, signals = any signal |
moreQueries | array<string> | Non | Up to 3 other exact phrases searched together with query, same writing rule, e.g. ['"nous recrutons"', '"on recrute"']. They share depth. |
depth | integer | Non | Posts 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. |
intent | string | Non | What 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… |
relevance | wide | balanced | strict | Non | How close to intent a post must be: wide keeps more, strict keeps few. Ignored without intent. |
author | all | recruiter | founder | manager | Non | Keep only posts whose author's title reads as recruiter, founder or manager. Titles exist on hiring posts only. |
order | recent | closest | Non | recent = newest first; closest = closest in meaning to intent first. |
place | string | Non | Place the user cares about, e.g. 'France' or 'Lyon'. It weighs in the closeness score; it is not a hard filter. |
tuning | auto | manual | Non | auto = these values were chosen by you; the card sets manual when the user changed them. |
cursor | string | Non | nextCursor 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"}'const response = await fetch("https://piqline.com/api/v1/tools/searchLinkedinPosts", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"query": "levée de fonds"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/searchLinkedinPosts",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"query": "levée de fonds",
},
)
output = response.json()["output"]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ètre | Type | Requis | Description |
|---|---|---|---|
intent | string | Oui | User ask in natural language, e.g. « Suis les levées série A fintech chaque semaine » |
variants | array<object> | Oui | Candidate keyword formulations as the market writes them |
detectionEvent | hiring | funding | launch | expansion | reorg | open_to_work | leaving | interested_comment | … | Non | |
detectionRounds | array<pre_seed | seed | series_a | series_b | series_c | series_d | bridge | extension | …> | Non | |
detectionSectors | array<string> | Non | |
detectionGeos | array<string> | Non | |
detectionVocabulary | array<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"}]}'const response = await fetch("https://piqline.com/api/v1/tools/probeLinkedinWatch", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"intent": "texte",
"variants": [
{
"query": "levée de fonds"
}
]
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/probeLinkedinWatch",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"intent": "texte",
"variants": [
{
"query": "levée de fonds",
},
],
},
)
output = response.json()["output"]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ètre | Type | Requis | Description |
|---|---|---|---|
url | string | Oui | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinPost", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinPost",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]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ètre | Type | Requis | Description |
|---|---|---|---|
url | string | Oui | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinPostTranscript", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinPostTranscript",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]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ètre | Type | Requis | Description |
|---|---|---|---|
company | string | Oui | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinCompany", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"company": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinCompany",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"company": "texte",
},
)
output = response.json()["output"]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ètre | Type | Requis | Description |
|---|---|---|---|
company | string | Oui | URL linkedin.com/company/… ou handle |
page | integer | Non |
curl -s https://piqline.com/api/v1/tools/getLinkedinCompanyPosts \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"texte"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinCompanyPosts", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"company": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinCompanyPosts",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"company": "texte",
},
)
output = response.json()["output"]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ètre | Type | Requis | Description |
|---|---|---|---|
company | string | Non | Nom d’entreprise, ex. Shopify |
companyId | string | Non | Id numérique LinkedIn de l’entreprise |
keyword | string | Non | Mot-clé secteur |
countries | string | Non | Codes pays ISO séparés par des virgules, ex. FR,ES |
startDate | string | Non | |
endDate | string | Non | |
paginationToken | string | Non |
curl -s https://piqline.com/api/v1/tools/searchLinkedinAds \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/searchLinkedinAds", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/searchLinkedinAds",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]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ètre | Type | Requis | Description |
|---|---|---|---|
url | string | Oui | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinAd", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinAd",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]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ètre | Type | Requis | Description |
|---|---|---|---|
peopleQuery | string | Oui | |
opportunityQuery | string | Oui | |
datePosted | last-hour | last-day | last-week | last-month | last-year | Non | |
semantic | boolean | Non | Re-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"}'const response = await fetch("https://piqline.com/api/v1/tools/matchLinkedinPosts", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"peopleQuery": "texte",
"opportunityQuery": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/matchLinkedinPosts",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"peopleQuery": "texte",
"opportunityQuery": "texte",
},
)
output = response.json()["output"]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ètre | Type | Requis | Description |
|---|---|---|---|
url | string | Oui | linkedin.com/in/… URL from a pointer or pasted by the user |
basis | pointer | pasted | Oui | |
postUrl | string | Non | Required 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"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinProfile", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article",
"basis": "pointer"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinProfile",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
"basis": "pointer",
},
)
output = response.json()["output"]