> ## 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 durchsuchen

> Nach LinkedIn-Unternehmen oder Personen suchen

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
    <ParamField header="Authorization" type="string" required>
      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
      <br />
      <br />
      Format: <code>Authorization: Bearer API_KEY</code>
    </ParamField>
    {!noProfileKey && (profileKeyRequired ? <ParamField header="Profile-Key" type="string" required>
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField> : <ParamField header="Profile-Key" type="string">
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField>)}
  </>;

<PlansAvailable plans={["business"]} maxPackRequired={false} />

Suchen Sie nach LinkedIn-Unternehmen oder Personen anhand einer Suchanfrage.
Dieser Endpunkt wird häufig für die Typeahead-Vervollständigung von Erwähnungen in Social-Media-Beiträgen verwendet.

**Das verknüpfte Konto muss eine LinkedIn-Unternehmensseite sein, um die Suche durchführen zu können.** Persönliche LinkedIn-Konten können nicht für Suchen verwendet werden.

1. **Für Erwähnungen in Beiträgen**: Verwenden Sie diesen Endpunkt in Kombination mit einer Typeahead-Funktion, wenn Sie @-Erwähnungen implementieren.
2. **Unternehmenssuche**: Der exakte Vanity-Name des Unternehmens ist erforderlich.
3. **Personensuche**: Beginnen Sie für die besten Ergebnisse mit mindestens 3 Zeichen eines Namens.
4. **Rate Limiting**: Für diesen Endpunkt gelten die Standard-API-Ratenlimits.

<Note>
  **Sucheinschränkungen**

  <ul class="custom-bullets">
    <li>**Unternehmen**: Sie können nach jeder LinkedIn-Unternehmensseite suchen</li>

    <li>
      **Personen**: Sie können nur nach Personen suchen, die Follower Ihres LinkedIn-Kontos sind, und das
      mit Ayrshare verknüpfte Konto muss eine LinkedIn-Unternehmensseite sein, um die Suche durchzuführen. Wenn die
      LinkedIn-Sichtbarkeit einer Person auf privat gestellt ist, wird sie in den Suchergebnissen nicht gefunden.
    </li>
  </ul>
</Note>

## Header-Parameter

<HeaderAPI />

## Query-Parameter

<ParamField query="search" type="string" required>
  Suchanfrage, um LinkedIn-Unternehmen oder Personen zu finden.

  **Anforderungen:**

  {" "}

  <ul class="custom-bullets">
    <li>Mindestlänge: 3 Zeichen für Personen und 1 Zeichen für Unternehmen.</li>
    <li>Maximale Länge: 100 Zeichen für Personen und Unternehmen.</li>
  </ul>

  **Suchverhalten:**

  <ul class="custom-bullets">
    <li>
      <strong>Für Unternehmen</strong>: Verwenden Sie den Vanity-Namen des Unternehmens (zu finden in der LinkedIn-URL). Es werden nur **exakte Übereinstimmungen mit dem Vanity-Namen** zurückgegeben.

      <ul class="custom-bullets">
        <li>
          Beispiel: Für `linkedin.com/company/ayrshare` suchen Sie nach "ayrshare".
        </li>

        <li>
          Die Suche nach Teilnamen wie "ayrsh" liefert KEINE Ergebnisse.
        </li>
      </ul>
    </li>

    <li>
      <strong>Für Personen</strong>: Verwenden Sie Vor- und/oder Nachname. Teilweise Namensübereinstimmungen werden unterstützt.

      <ul class="custom-bullets">
        <li>
          Beispiel: "John Smith" findet Personen mit dem Namen John Smith. Achten Sie darauf, das Leerzeichen URL-zu-kodieren.
        </li>

        <li>
          Teilweise Übereinstimmungen wie "Joh" oder "Smi" liefern ebenfalls Ergebnisse.
        </li>
      </ul>

      <ul class="custom-bullets">
        <li>
          Denken Sie daran: Nur Ihre LinkedIn-Follower können gefunden werden, und das mit Ayrshare verknüpfte Konto muss eine LinkedIn-Unternehmensseite sein, um die Suche durchführen zu können.
        </li>
      </ul>
    </li>
  </ul>
</ParamField>

<ParamField query="personOnly" type="boolean" default={false}>
  Steuert den Suchbereich: - `false` (Standard): Sucht zuerst nach Unternehmen, dann nach Personen, wenn keine
  Unternehmen gefunden werden. - `true`: Sucht nur nach Personen (überspringt die Unternehmenssuche vollständig).
</ParamField>

## Beispiele

<RequestExample>
  ```bash Company Search theme={"system"}
  curl \
    -H "Authorization: Bearer API_KEY" \
    -X GET "https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare"
  ```

  ```bash Person Search Only theme={"system"}
  curl \
    -H "Authorization: Bearer API_KEY" \
    -X GET "https://api.ayrshare.com/api/brand/search/linkedin?search=John%20Smith&personOnly=true"
  ```

  ```javascript JavaScript theme={"system"}
  const API_KEY = "API_KEY";

  // Search for company or person
  fetch("https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare", {
    method: "GET",
    headers: {
      Authorization: `Bearer ${API_KEY}`
    }
  })
    .then((res) => res.json())
    .then((json) => console.log(json))
    .catch(console.error);

  // Search for person only
  fetch("https://api.ayrshare.com/api/brand/search/linkedin?search=John%20Smith&personOnly=true", {
    method: "GET",
    headers: {
      Authorization: `Bearer ${API_KEY}`
    }
  })
    .then((res) => res.json())
    .then((json) => console.log(json))
    .catch(console.error);
  ```

  ```python Python theme={"system"}
  import requests

  headers = {'Authorization': 'Bearer API_KEY'}

  # Search for company or person
  r = requests.get('https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare', headers=headers)
  print(r.json())

  # Search for person only
  r = requests.get('https://api.ayrshare.com/api/brand/search/linkedin?search=john&personOnly=true', headers=headers)
  print(r.json())
  ```
</RequestExample>

<ResponseExample>
  ```json Company Search Result theme={"system"}
  {
    "linkedin": [
      {
        "vanityName": "ayrshare",
        "website": "https://www.ayrshare.com",
        "groups": [],
        "description": "Ayrshare's APIs provide the core infrastructure for social media posting, management, and analytics.\n\nThe Ayrshare API takes care of the social media infrastructure so you don't have to. Your team can focus on building your product instead of stitching together and maintaining multiple social media platforms.\n\nPost to Facebook, Twitter, Instagram, LinkedIn, Reddit, Telegram, TikTok, Google My Business, and YouTube.\n",
        "defaultLocale": {
          "country": "US",
          "language": "en"
        },
        "organizationType": "PARTNERSHIP",
        "alternativeNames": [],
        "specialties": [
          "social media",
          "api",
          "saas",
          "social networks",
          "tiktok",
          "facebook",
          "instagram"
        ],
        "staffCountRange": "SIZE_10_TO_100",
        "name": "Ayrshare",
        "primaryOrganizationType": "NONE",
        "locations": [
          {
            "description": {
              "localized": {
                "en_US": "Headquarters"
              },
              "preferredLocale": {
                "country": "US",
                "language": "en"
              }
            },
            "locationType": "HEADQUARTERS",
            "address": {
              "geographicArea": "New York",
              "country": "US",
              "city": "New York",
              "line1": "142 W 57th St",
              "postalCode": "10019"
            },
            "localizedDescription": "Headquarters",
            "streetAddressFieldState": "UNSET_OPT_OUT",
            "geoLocation": "urn:li:geo:103963738"
          }
        ],
        "id": 66755333
      }
    ]
  }
  ```

  ```json Person Search Result theme={"system"}
  {
    "linkedin": [
      {
        "lastName": "Smith",
        "firstName": "John",
        "headline": "CTO at Ayrshare",
        "id": "urn:li:person:WBwF1C23L"
      }
    ]
  }
  ```

  ```json 400: Search query too short theme={"system"}
  {
    "linkedin": {
      "action": "request",
      "status": "error",
      "code": 101,
      "message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
      "details": "The search must be a string between 3 and 100 characters."
    }
  }
  ```

  ```json 404: No results found theme={"system"}
  {
    "linkedin": []
  }
  ```
</ResponseExample>