# LinkedIn

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

Source: https://piqline.com/fr/docs/api/reference/linkedin

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.

`POST https://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 |

```bash tab="curl"
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"}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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.

`POST https://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 |  |

```bash tab="curl"
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"}]}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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.

`POST https://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/… |

```bash tab="curl"
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"}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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.

`POST https://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 |

```bash tab="curl"
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"}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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.

`POST https://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) |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/getLinkedinCompany \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"texte"}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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).

`POST https://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 |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/getLinkedinCompanyPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"texte"}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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.

`POST https://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 |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/searchLinkedinAds \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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.

`POST https://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 |

```bash tab="curl"
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"}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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).

`POST https://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 |

```bash tab="curl"
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"}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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.

`POST https://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 |

```bash tab="curl"
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"}'
```
```javascript tab="JavaScript"
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();
```
```python tab="Python"
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"]
```
