# LinkedIn

> LinkedIn. 10 Tools, mit ihren Parametern und Aufrufbeispielen.

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

Tools des LinkedIn-Agenten: öffentliche Beiträge, Unternehmensseiten und Anzeigen, live gelesen. Kontaktdaten werden nie gelesen.

Jeder Aufruf ist eine `POST`-Anfrage mit dem Schlüssel in `Authorization: Bearer`. Der JSON-Body ist die Eingabe des Tools, und die Antwort hat die Form `{ "tool": "nom", "output": … }`. Die Beispiele enthalten nur die erforderlichen Parameter. Die Parameterbeschreibungen sind die, die die Agenten lesen.

### `searchLinkedinPosts`

Durchsucht öffentliche Beiträge nach Stichwörtern in Echtzeit, neueste zuerst (ein partieller Lesevorgang wird im Ergebnis markiert), mit Titel und Rolle des Autors, wenn der Beitrag eine Stelle ausschreibt, und vom Code berechneten Signalen: Einstellung, Finanzierung, Launch, Expansion, Reorganisation, Verfügbarkeit, Abgang.

`POST https://piqline.com/api/v1/tools/searchLinkedinPosts`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `query` | `string` | Ja | 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` | Nein |  |
| `focus` | `all \| people \| hiring \| signals` | Nein | people = only posts carrying a person pointer, hiring = hiring posts, signals = any signal |
| `moreQueries` | `array<string>` | Nein | Up to 3 other exact phrases searched together with `query`, same writing rule, e.g. ['"nous recrutons"', '"on recrute"']. They share `depth`. |
| `depth` | `integer` | Nein | 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` | Nein | 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` | Nein | How close to `intent` a post must be: wide keeps more, strict keeps few. Ignored without `intent`. |
| `author` | `all \| recruiter \| founder \| manager` | Nein | Keep only posts whose author's title reads as recruiter, founder or manager. Titles exist on hiring posts only. |
| `order` | `recent \| closest` | Nein | recent = newest first; closest = closest in meaning to `intent` first. |
| `place` | `string` | Nein | 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` | Nein | auto = these values were chosen by you; the card sets manual when the user changed them. |
| `cursor` | `string` | Nein | 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`

Prüft 1 bis 3 Suchvarianten, bevor Sie eine LinkedIn-Beobachtung abonnieren, und liefert das Recherche-Ticket, das dem Abonnement beizufügen ist.

`POST https://piqline.com/api/v1/tools/probeLinkedinWatch`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `intent` | `string` | Ja | User ask in natural language, e.g. « Suis les levées série A fintech chaque semaine » |
| `variants` | `array<object>` | Ja | Candidate keyword formulations as the market writes them |
| `detectionEvent` | `hiring \| funding \| launch \| expansion \| reorg \| open_to_work \| leaving \| interested_comment \| …` | Nein |  |
| `detectionRounds` | `array<pre_seed \| seed \| series_a \| series_b \| series_c \| series_d \| bridge \| extension \| …>` | Nein |  |
| `detectionSectors` | `array<string>` | Nein |  |
| `detectionGeos` | `array<string>` | Nein |  |
| `detectionVocabulary` | `array<string>` | Nein |  |

```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`

Liest einen öffentlichen Beitrag oder Artikel: Text, Autor, Datum, Reaktionen, Kommentare mit ihren Signalen.

`POST https://piqline.com/api/v1/tools/getLinkedinPost`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `url` | `string` | Ja | 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`

Transkript des Videos eines öffentlichen Beitrags, nur berechnet, wenn es existiert.

`POST https://piqline.com/api/v1/tools/getLinkedinPostTranscript`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `url` | `string` | Ja | 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`

Öffentliche Unternehmensseite: Beschreibung, Mitarbeiterzahl, Branche, Finanzierung, neueste Beiträge mit ihren Signalen.

`POST https://piqline.com/api/v1/tools/getLinkedinCompany`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `company` | `string` | Ja | 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`

Ältere Beiträge einer Unternehmensseite, mit einer Zusammenfassung der Signale (Einstellung, Finanzierung, Launches).

`POST https://piqline.com/api/v1/tools/getLinkedinCompanyPosts`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `company` | `string` | Ja | URL linkedin.com/company/… ou handle |
| `page` | `integer` | Nein |  |

```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`

Durchsucht die Anzeigenbibliothek: Werbetreibender, Format, Daten, Impressionen.

`POST https://piqline.com/api/v1/tools/searchLinkedinAds`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `company` | `string` | Nein | Nom d’entreprise, ex. Shopify |
| `companyId` | `string` | Nein | Id numérique LinkedIn de l’entreprise |
| `keyword` | `string` | Nein | Mot-clé secteur |
| `countries` | `string` | Nein | Codes pays ISO séparés par des virgules, ex. FR,ES |
| `startDate` | `string` | Nein |  |
| `endDate` | `string` | Nein |  |
| `paginationToken` | `string` | Nein |  |

```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`

Detail einer Anzeige aus der Bibliothek: Targeting, Impressionen pro Land, Dauer.

`POST https://piqline.com/api/v1/tools/getLinkedinAd`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `url` | `string` | Ja | 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`

Bringt verfügbare Personen mit Gelegenheiten aus öffentlichen Beiträgen zusammen (zwei Suchen).

`POST https://piqline.com/api/v1/tools/matchLinkedinPosts`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `peopleQuery` | `string` | Ja |  |
| `opportunityQuery` | `string` | Ja |  |
| `datePosted` | `last-hour \| last-day \| last-week \| last-month \| last-year` | Nein |  |
| `semantic` | `boolean` | Nein | 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`

Begrenzter Lesevorgang eines öffentlichen `/in/`-Profils, nur ausgehend von einem öffentlichen Beitrag, der die Person nennt. Workspaces vorbehalten, die diese Option aktiviert haben.

`POST https://piqline.com/api/v1/tools/getLinkedinProfile`

Typ: Live-Lesen. Scopes: `explore`.

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `url` | `string` | Ja | linkedin.com/in/… URL from a pointer or pasted by the user |
| `basis` | `pointer \| pasted` | Ja |  |
| `postUrl` | `string` | Nein | 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"]
```
