LinkedIn · API Piqline

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 via Scrape Creators. 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 (index Google, pas en temps réel), avec 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	Keywords as a person would type them in a post, e.g. 'on recrute développeur React Lyon'
`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
`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 with embeddings 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"]

searchLinkedinPosts#

probeLinkedinWatch#

getLinkedinPost#

getLinkedinPostTranscript#

getLinkedinCompany#

getLinkedinCompanyPosts#

searchLinkedinAds#

getLinkedinAd#

matchLinkedinPosts#

getLinkedinProfile#

`searchLinkedinPosts`#

`probeLinkedinWatch`#

`getLinkedinPost`#

`getLinkedinPostTranscript`#

`getLinkedinCompany`#

`getLinkedinCompanyPosts`#

`searchLinkedinAds`#

`getLinkedinAd`#

`matchLinkedinPosts`#

`getLinkedinProfile`#