> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn API

> Optionen zum Posten mit der LinkedIn API

Die LinkedIn API hat die folgenden Anforderungen und Einschränkungen:

<ul class="custom-bullets">
  <li>Das Feld `post` akzeptiert bis zu 3.000 Zeichen.</li>

  <li>
    LinkedIn zeigt automatisch eine Vorschau des Links im Beitrag an, sofern kein Bild oder Video
    enthalten ist. Im obigen Beispiel wird das Bild angezeigt. Wenn Sie das Bild entfernen, wird die
    Link-Vorschau angezeigt. Kann die Link-Vorschau nicht abgerufen werden, wird der Beitrag dennoch veröffentlicht und
    im /post-Response wird das Feld `linkPreviewFailed: true` zurückgegeben.
  </li>

  <li>Hashtags sind auf LinkedIn anklickbar. Verwenden Sie das Symbol #, um einen LinkedIn-Hashtag anzugeben.</li>

  <li>
    Wenn Sie ein Video veröffentlichen, das nicht mit einer bekannten Videoendung wie mp4 endet, verwenden Sie
    den Parameter `isVideo`. Weitere Informationen finden Sie unter [/post-Endpunkt](/apis/post/post).
  </li>

  <li>
    Die LinkedIn-Videoverarbeitung dauert einige Minuten. Warten Sie bitte, bevor Sie die Share-URL
    ausprobieren oder Videoanalysen abrufen.
  </li>

  <li>LinkedIn begrenzt Beiträge auf 150 pro Tag und LinkedIn-Konto.</li>
  <li>Das Posten in LinkedIn-Gruppen wird nicht unterstützt.</li>

  <li>
    LinkedIn unterstützt auch das Senden von Medien ohne Beitragstext. Wenn Sie keinen Beitragstext einfügen möchten,
    senden Sie einen leeren String `post: ""`.
  </li>

  <li>Sie können entweder eine Unternehmensseite oder ein persönliches LinkedIn-Konto verknüpfen.</li>

  <li>
    Weitere Informationen finden Sie unter [LinkedIn-Medienrichtlinien](/media-guidelines/linkedin) und [LinkedIn-Autorisierung](/dashboard/connect-social-accounts/linkedin).
  </li>
</ul>

<Warning>
  Sie müssen ein „Super Admin" oder ein „Content Admin" sein, um eine LinkedIn-Unternehmensseite zu verbinden.{" "}
</Warning>

## Posten auf LinkedIn

JSON für einen einfachen Beitrag mit Link und Bild auf LinkedIn:

```json LinkedIn Post theme={"system"}
{
  "post": "The best LinkedIn post ever #best https://www.linkedin.com", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["linkedin"]
}
```

## LinkedIn-Optionen

Sie können zusätzliche Optionen für einen Beitrag über den Parameter `linkedInOptions` festlegen.

```json LinkedIn Options theme={"system"}
{
  "linkedInOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"],
    "disableShare": true,
    "targeting": {
      "countries": ["US", "IN", "DE", "GB"],
      "seniorities": ["Senior", "VP"],
      "degrees": ["Master of Digital Design", "Bachelor of Engineering"],
      "fieldsOfStudy": ["Consumer Economics", "Computer Games and Programming Skills"],
      "industries": ["Telecommunications Carriers", "Banking"],
      "jobFunctions": ["Information Technology", "Entrepreneurship"],
      "staffCountRanges": ["size_51_to_200", "size_5001_to_10000"]
    },
    "thumbNail": "https://example.com/thumbnail.jpg",
    "title": "Sample PPTX",
    "titles": ["This is an amazing video", "😃 here is the next one"],
    "visibility": "public"
  }
}
```

LinkedIn-Optionen sind optionale Felder, mit denen sich der Beitrag steuern lässt.

<ParamField body="altText" type="array of strings">
  Der Alternativtext für Bilder zur Barrierefreiheit und für Screenreader.

  Weitere Informationen finden Sie unter [LinkedIn-Alternativtext](/apis/post/social-networks/linkedin#alternative-text).
</ParamField>

<ParamField body="disableShare" type="boolean" default={false}>
  Deaktiviert die Möglichkeit für Nutzer, den LinkedIn-Beitrag erneut zu teilen.

  Weitere Informationen finden Sie unter [LinkedIn-Teilen deaktivieren](/apis/post/social-networks/linkedin#disable-share).
</ParamField>

<ParamField body="targeting" type="object">
  Richten Sie Ihre organischen Beiträge an bestimmte Gruppen nach Ländern, Branche, Berufsbezeichnung und mehr aus.

  Erfordert mindestens 300 Follower in der Zielgruppe.

  Weitere Informationen finden Sie unter [LinkedIn-Zielgruppen-Targeting](/apis/post/social-networks/linkedin#audience-targeting).
</ParamField>

<ParamField body="thumbNail" type="string">
  Das Thumbnail eines Videos. Muss PNG oder JPG sein, dieselben Abmessungen wie das Video haben und unter 10 MB liegen. Die URL sollte auf .png oder .jpg enden.

  Weitere Informationen finden Sie unter [LinkedIn-Video-Thumbnail](/apis/post/social-networks/linkedin#video-thumbnail).
</ParamField>

<ParamField body="title" type="string">
  Der Titel eines Dokuments beim Posten von PPT-, PPTX-, DOC-, DOCX- oder PDF-Dateien. Maximale Länge: 400 Zeichen.

  Wenn nicht angegeben, wird der Dateiname verwendet.

  Weitere Informationen finden Sie unter [LinkedIn-Dokumente](/apis/post/social-networks/linkedin#documents).
</ParamField>

<ParamField body="titles" type="array of strings">
  Titel- oder Medienbeschriftungen für LinkedIn-Bilder oder -Videos.

  Jeder Titel entspricht in Reihenfolge einer Medien-URL.

  Weitere Informationen finden Sie unter [LinkedIn-Medientitel](/apis/post/social-networks/linkedin#media-titles).
</ParamField>

<ParamField body="visibility" type="string" default="public">
  Die Sichtbarkeit des Beitrags.

  Werte: `public`, `connections` oder `loggedin`.

  Weitere Informationen finden Sie unter [LinkedIn-Beitragssichtbarkeit](/apis/post/social-networks/linkedin#post-visibility).
</ParamField>

## Alternativtext

Fügen Sie einem LinkedIn-Bild einen LinkedIn-Alternativtext (LinkedIn-Alt-Text) hinzu. Der LinkedIn-Alt-Text ist eine Barrierefreiheitsfunktion für zusätzliche Nutzerinformationen und Screenreader. LinkedIn unterstützt kein altText auf Videos oder Dokumenten.

Verwenden Sie `altText` im Objekt `linkedInOptions`.

```json LinkedIn Alt Text theme={"system"}
{
  "linkedInOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts
  }
}
```

Jeder Alt-Text muss einem Bild im Array `mediaUrls` entsprechen. Der Alt-Text wird in der angegebenen Reihenfolge auf jedes Bild angewendet.

## Zielgruppen-Targeting

LinkedIn ermöglicht es Ihnen, Ihre organischen Beiträge an bestimmte Nutzergruppen auszurichten. Sie können nach Ländern, Branche, Berufsbezeichnung und mehr ausrichten.

<Warning>
  LinkedIn-Targeting erfordert mindestens **300 Follower in der Zielgruppe**. Wenn Sie beispielsweise
  400 Follower haben und nur Nutzer im Land US ansprechen, aber nur 200 Ihrer Follower in den USA sind,
  schlägt das Targeting fehl, da die Zielgruppe zu klein ist.
</Warning>

Verwenden Sie das Objekt `targeting` im Objekt `linkedInOptions`:

```json LinkedIn Audience Targeting theme={"system"}
{
  "linkedInOptions": {
    "targeting": {
      "countries": ["US", "IN", "DE", "GB"],
      "seniorities": ["Senior", "VP"],
      "degrees": ["Master of Digital Design", "Bachelor of Engineering"],
      "fieldsOfStudy": ["Consumer Economics", "Computer Games and Programming Skills"],
      "industries": ["Telecommunications Carriers", "Banking"],
      "jobFunctions": ["Information Technology", "Entrepreneurship"],
      "staffCountRanges": ["size_51_to_200", "size_5001_to_10000"]
    }
  }
}
```

Die verfügbaren Targeting-Optionen sind in den folgenden JSON-Dateien aufgeführt:

<ul class="custom-bullets">
  <li>[LinkedIn Countries](https://logo.ayrshare.com/data/linkedin/countries.json)</li>
  <li>[LinkedIn Seniorities](https://logo.ayrshare.com/data/linkedin/seniorities.json)</li>
  <li>[LinkedIn Degrees](https://logo.ayrshare.com/data/linkedin/degrees.json)</li>
  <li>[LinkedIn Fields of Study](https://logo.ayrshare.com/data/linkedin/fieldsOfStudy.json)</li>
  <li>[LinkedIn Industries](https://logo.ayrshare.com/data/linkedin/industries.json)</li>
  <li>[LinkedIn Job Functions](https://logo.ayrshare.com/data/linkedin/jobFunctions.json)</li>

  <li>
    [LinkedIn Staff Count Ranges](https://logo.ayrshare.com/data/linkedin/staffCountRanges.json)
  </li>
</ul>

## Autorisierungs-Refresh

LinkedIn muss *jedes Jahr* über die Seite „Social Accounts" neu autorisiert werden.

<ul class="custom-bullets">
  <li>
    Eine E-Mail- und Webhook-Social-Action-Benachrichtigung wird 15 Tage vor dem Ablauf der Autorisierung
    gesendet.
  </li>

  <li>
    Das Refresh-Fälligkeitsdatum und die verbleibenden Tage können über den Endpunkt
    [/user](/apis/user/overview) abgerufen werden.
  </li>

  <li>
    Der Nutzer sieht auf der Seite mit den Social-Account-Verknüpfungen 30 Tage vor Ablauf einen Hinweis
    und eine Refresh-Schaltfläche.
  </li>
</ul>

## Zeichenbeschränkungen

Weitere Informationen finden Sie unter [LinkedIn-Zeichenbeschränkungen](/help-center/technical-support/character_limits#linkedin-character-limits).

## Teilen deaktivieren

Sie können die Möglichkeit für Nutzer, den LinkedIn-Beitrag erneut zu teilen, deaktivieren, indem Sie im Objekt `linkedInOptions` das Feld `disableShare` auf `true` setzen:

```json LinkedIn Disable Share theme={"system"}
{
  "linkedInOptions": {
    "disableShare": true
  }
}
```

## Dokumente

Verwenden Sie die API, um ein Dokument auf LinkedIn zu posten. Unterstützte Dateiformate sind: PPT, PPTX, DOC, DOCX und PDF. Stellen Sie sicher, dass das Dokument kleiner als 100 MB ist und 300 Seiten nicht überschreitet.

Unten sehen Sie ein Codebeispiel, das zeigt, wie ein PPTX-Dokument mit Titel gepostet wird:

```json LinkedIn Document Post theme={"system"}
{
  "post": "What a great document",
  "platforms": ["linkedin"],
  "linkedInOptions": {
    "title": "Sample PPTX" // optional. If not specified, the file name used.
  },
  "mediaUrls": ["https://scholar.harvard.edu/files/torman_personal/files/samplepptx.pptx"]
}
```

Die angegebene Medien-URL muss mit einer bekannten Dokumentendung enden: ppt, pptx, doc, docx oder pdf.

## LinkedIn-Erwähnungen

Sie können in Ihren Beiträgen andere LinkedIn-Organisationen (z. B. Unternehmensseiten) oder Mitgliedsprofile (z. B. persönliche Profilseiten) erwähnen.

Ayrshare versucht, die @Erwähnung durch einen Lookup des Handles aufzulösen.
Wird die @Erwähnung nicht gefunden, wird das @ aus dem Beitrag entfernt, da LinkedIn Beiträge mit ungelösten Erwähnungen nicht akzeptiert.
Einzelne LinkedIn-Profile können nicht erwähnt werden.

<Warning>
  Wenn eine Erwähnung in einem LinkedIn-Beitrag nicht aufgelöst werden kann (aufgrund von Datenschutzeinstellungen,
  Kontobeschränkungen oder anderen Plattform-Einschränkungen), rendert LinkedIn möglicherweise alle
  Erwähnungen in diesem Beitrag nicht als anklickbare Links. Dies ist ein Verhalten der LinkedIn-Plattform
  und kein API-Problem. Um dies zu vermeiden, stellen Sie sicher, dass alle erwähnten Nutzer und
  Organisationen Erwähnungen durch Ihre Organisation zulassen, oder erwägen Sie, Erwähnungen
  einzeln zu posten, um problematische Erwähnungen zu isolieren.
</Warning>

Bitte lesen Sie die [wichtigen Regeln](/testing/post-verification#mentions) zu Erwähnungen.

### Organisationsprofile

Erwähnen Sie einen anderen LinkedIn-Organisations-Handle, indem Sie `@handle` im Beitragstext hinzufügen. Der `@handle` ist der Name des Unternehmens oder der Organisation.
Sie können in Beiträgen, Kommentaren und Antworten auf Kommentare erwähnen.

Zum Beispiel:

<ul class="custom-bullets">
  <li>
    Ayrshares LinkedIn-Unternehmensprofil ist
    [https://www.linkedin.com/company/ayrshare](https://www.linkedin.com/company/ayrshare), und der
    zu verwendende Handle wäre *@ayrshare*.
  </li>

  <li>
    Zaras LinkedIn-Unternehmensprofil ist
    [https://www.linkedin.com/company/zara-sa/](https://www.linkedin.com/company/zara-sa/), und der
    zu verwendende Handle wäre *@zara-sa*.
  </li>
</ul>

```json LinkedIn Mention theme={"system"}
{
  "post": "The best social media API @ayrshare ever!",
  "platforms": ["linkedin"]
}
```

### Mitgliedsprofile

Erwähnen Sie ein anderes LinkedIn-Mitgliedsprofil, indem Sie `@vanity_name` oder `@[John Smith]` im Beitragstext hinzufügen.

1. `@vanity_name` ist der Vanity-Name des Mitgliedsprofils. In der Profil-URL des Mitglieds `https://www.linkedin.com/in/vanity_name/` ist der Vanity-Name `vanity_name`.
2. `@[John Smith]` ist der vollständige Name der Person. Ist der vollständige Name beispielsweise `John Smith`, lautet die Erwähnung `@[John Smith]`.

Sie können in Beiträgen, Kommentaren und Antworten auf Kommentare erwähnen.

```json LinkedIn Mention theme={"system"}
{
  "post": "The best social media API @[John Smith] and @ava_smith ever!",
  "platforms": ["linkedin"]
}
```

Im obigen Beispiel werden John Smith und Ava Smith im Beitrag erwähnt – die erste Person mit ihrem vollständigen Namen und die zweite mit ihrem Vanity-Namen.

**Wichtige Hinweise:**

1. Sie müssen eine LinkedIn-Unternehmensseite mit Ihrem Ayrshare-Konto verbunden haben, um Mitgliedsprofile zu
   erwähnen. Wenn Sie Ihr eigenes persönliches LinkedIn-Konto verbinden, können Sie keine Profile
   anderer Personen erwähnen.
2. LinkedIn erlaubt nur die Erwähnung von Personen, die Ihrer Organisation/Unternehmensseite folgen.

## Medientitel

Fügen Sie LinkedIn-Bildern oder -Videos Titel oder Medienbeschriftungen hinzu.

Verwenden Sie `titles` im Objekt `linkedInOptions`.

```json LinkedIn Media Titles theme={"system"}
{
  "linkedInOptions": {
    "titles": ["This is an amazing video", "😃 here is the next one"] // Array of Alt Texts
  }
}
```

Jeder Titel muss einem Bild oder Video im Array `mediaUrls` entsprechen. Der Titel wird in der angegebenen Reihenfolge auf jedes Bild oder Video angewendet.

## Beiträge mit mehreren Bildern

Sie können bis zu *9 Bild-URLs* im Feld `mediaUrls` an LinkedIn posten.

```json LinkedIn Multi Image Post theme={"system"}
{
  "mediaUrls": ["https://url1", ..., "https://url9"]
}
```

LinkedIn unterstützt noch keine Karussell-Bilder für organische Beiträge.

## Beitragssichtbarkeit

LinkedIn ermöglicht es Ihnen, die Sichtbarkeit Ihrer Beiträge zu steuern.
Sie können die Sichtbarkeit auf öffentlich, nur Verbindungen oder nur angemeldete Nutzer einstellen.
Wird keine Sichtbarkeit angegeben, ist der Beitrag „public" und für alle LinkedIn-Nutzer sichtbar.

<ul class="custom-bullets">
  <li>
    `public`: Der Beitrag ist für alle LinkedIn-Nutzer sichtbar. Verfügbar sowohl für Unternehmensseiten als auch
    für persönlich verbundene LinkedIn-Konten. Standard, wenn keine Sichtbarkeit angegeben ist.
  </li>

  <li>
    `connections`: Der Beitrag ist für das Netzwerk 1. Grades des Eigentümers (Nutzerprofil) sichtbar.
    Nur für persönlich verbundene LinkedIn-Konten verfügbar.
  </li>

  <li>
    `loggedin`: Der Beitrag ist nur für angemeldete LinkedIn-Nutzer sichtbar. Verfügbar sowohl für
    Unternehmensseiten als auch für persönlich verbundene LinkedIn-Konten.
  </li>
</ul>

Verwenden Sie das Feld `visibility` im Objekt `linkedInOptions`:

```json LinkedIn Post Visibility theme={"system"}
{
  "linkedInOptions": {
    "visibility": "public" // "public", "connections", or "loggedin"
  }
}
```

## Berechtigungen zur Videoveröffentlichung

Auf LinkedIn können nur Nutzer mit bestimmten Berechtigungen Videos auf Unternehmensseiten veröffentlichen:

1. Nutzer mit Admin-Berechtigungen.
2. Nutzer mit Direct-Sponsored-Content-Berechtigungen (DSC).

Content Administrators können keine Videos auf LinkedIn-Unternehmensseiten veröffentlichen.

## Video-Thumbnail

Legen Sie ein LinkedIn-Thumbnail für ein Video fest. Senden Sie eine Remote-URL einer PNG- oder JPG-Datei, die dieselben Abmessungen wie das Video hat und kleiner als 10 MB ist. Die URL sollte auf .png oder .jpg enden.

Verwenden Sie `thumbNail` im Objekt `linkedInOptions`.

```json LinkedIn Video Thumbnail theme={"system"}
{
  "linkedInOptions": {
    "thumbNail": "https://octodex.github.com/images/Fintechtocat.png"
  }
}
```

Weitere [Beispiele zur Nutzung der LinkedIn API](https://www.ayrshare.com/how-to-post-and-get-analytics-with-the-linkedin-api#linkedin-api-examples) finden Sie hier.
