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

# Rechercher sur LinkedIn

> Rechercher des entreprises ou des personnes sur LinkedIn

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} />

Recherchez des entreprises ou des personnes sur LinkedIn en fonction d'une requête de recherche.
Ce point de terminaison est couramment utilisé pour l'auto-complétion des mentions dans les publications sur les réseaux sociaux.

**Le compte lié doit être une page d'entreprise LinkedIn pour effectuer la recherche.** Les comptes LinkedIn personnels ne peuvent pas être utilisés pour effectuer des recherches.

1. **Pour les mentions dans les publications** : lors de l'implémentation des @mentions, utilisez ce point de terminaison avec la fonctionnalité de saisie semi-automatique.
2. **Recherche d'entreprise** : le vanity name exact de l'entreprise est requis.
3. **Recherche de personne** : commencez avec au moins 3 caractères d'un nom pour de meilleurs résultats.
4. **Limitation de débit** : ce point de terminaison suit les limites de débit standard de l'API.

<Note>
  **Limitations de recherche**

  <ul class="custom-bullets">
    <li>**Entreprises** : vous pouvez rechercher n'importe quelle page d'entreprise LinkedIn</li>

    <li>
      **Personnes** : vous ne pouvez rechercher que les personnes qui sont abonnées à votre compte LinkedIn et le
      compte lié Ayrshare doit être une page d'entreprise LinkedIn pour effectuer la recherche. Si une personne a
      configuré sa visibilité LinkedIn en privé, elle ne sera pas trouvée dans les résultats de recherche.
    </li>
  </ul>
</Note>

## Paramètres d'en-tête

<HeaderAPI />

## Paramètres de requête

<ParamField query="search" type="string" required>
  Requête de recherche pour trouver des entreprises ou des personnes sur LinkedIn.

  **Exigences :**

  {" "}

  <ul class="custom-bullets">
    <li>Longueur minimale : 3 caractères pour les personnes et 1 caractère pour les entreprises.</li>
    <li>Longueur maximale : 100 caractères pour les personnes comme pour les entreprises.</li>
  </ul>

  **Comportement de la recherche :**

  <ul class="custom-bullets">
    <li>
      <strong>Pour les entreprises</strong> : utilisez le vanity name de l'entreprise (que l'on trouve dans l'URL LinkedIn). Seules les **correspondances exactes du vanity name** seront renvoyées.

      <ul class="custom-bullets">
        <li>
          Exemple : pour `linkedin.com/company/ayrshare`, recherchez "ayrshare".
        </li>

        <li>
          Une recherche sur des noms partiels comme "ayrsh" ne retournera PAS de résultats.
        </li>
      </ul>
    </li>

    <li>
      <strong>Pour les personnes</strong> : utilisez le prénom et/ou le nom de famille. Les correspondances partielles sont prises en charge.

      <ul class="custom-bullets">
        <li>
          Exemple : "John Smith" trouvera les personnes nommées John Smith. Veillez à encoder l'espace en URL.
        </li>

        <li>
          Les correspondances partielles telles que "Joh" ou "Smi" retourneront également des résultats.
        </li>
      </ul>

      <ul class="custom-bullets">
        <li>
          Rappel : seuls vos abonnés LinkedIn peuvent être trouvés et le compte lié Ayrshare doit être une page d'entreprise LinkedIn pour effectuer la recherche
        </li>
      </ul>
    </li>
  </ul>
</ParamField>

<ParamField query="personOnly" type="boolean" default={false}>
  Contrôle la portée de la recherche : - `false` (par défaut) : recherche d'abord les entreprises, puis les personnes si aucune
  entreprise n'est trouvée. - `true` : recherche uniquement les personnes (ignore complètement la recherche d'entreprise).
</ParamField>

## Exemples

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