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

# Pesquisar no LinkedIn

> Pesquise empresas ou pessoas no 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} />

Pesquise empresas ou pessoas no LinkedIn com base em uma consulta de pesquisa.
Este endpoint é comumente usado para autocompletar menções (typeahead) em publicações de redes sociais.

**A conta vinculada deve ser uma página de empresa do LinkedIn para realizar a pesquisa.** Contas pessoais do LinkedIn não podem ser usadas para efetuar pesquisas.

1. **Para menções em publicações**: ao implementar @menções, use este endpoint com funcionalidade de typeahead.
2. **Pesquisa de empresas**: o vanity name exato da empresa é obrigatório.
3. **Pesquisa de pessoas**: comece com pelo menos 3 caracteres do nome para melhores resultados.
4. **Rate limiting**: este endpoint segue os limites de taxa padrão da API.

<Note>
  **Limitações da pesquisa**

  <ul class="custom-bullets">
    <li>**Empresas**: você pode pesquisar qualquer página de empresa do LinkedIn</li>

    <li>
      **Pessoas**: você só pode pesquisar pessoas que seguem sua conta do LinkedIn e a
      conta vinculada da Ayrshare deve ser uma página de empresa do LinkedIn para realizar a pesquisa. Se uma pessoa tiver
      a visibilidade do LinkedIn definida como privada, ela não será encontrada nos resultados da pesquisa.
    </li>
  </ul>
</Note>

## Parâmetros do header

<HeaderAPI />

## Parâmetros de query

<ParamField query="search" type="string" required>
  Consulta de pesquisa para encontrar empresas ou pessoas no LinkedIn.

  **Requisitos:**

  {" "}

  <ul class="custom-bullets">
    <li>Tamanho mínimo: 3 caracteres para pessoas e 1 caractere para empresas.</li>
    <li>Tamanho máximo: 100 caracteres tanto para pessoas quanto para empresas.</li>
  </ul>

  **Comportamento da pesquisa:**

  <ul class="custom-bullets">
    <li>
      <strong>Para empresas</strong>: use o vanity name da empresa (encontrado na URL do LinkedIn). Somente **correspondências exatas do vanity name** serão retornadas.

      <ul class="custom-bullets">
        <li>
          Exemplo: para `linkedin.com/company/ayrshare`, pesquise por "ayrshare".
        </li>

        <li>
          Pesquisar por nomes parciais como "ayrsh" NÃO retornará resultados.
        </li>
      </ul>
    </li>

    <li>
      <strong>Para pessoas</strong>: use o primeiro nome e/ou sobrenome. Correspondências parciais de nome são suportadas.

      <ul class="custom-bullets">
        <li>
          Exemplo: "John Smith" encontrará pessoas chamadas John Smith. Certifique-se de codificar o espaço em URL.
        </li>

        <li>
          Correspondências parciais como "Joh" ou "Smi" também retornarão resultados.
        </li>
      </ul>

      <ul class="custom-bullets">
        <li>
          Lembre-se: somente seus seguidores do LinkedIn podem ser encontrados e a conta vinculada da Ayrshare deve ser uma página de empresa do LinkedIn para realizar a pesquisa
        </li>
      </ul>
    </li>
  </ul>
</ParamField>

<ParamField query="personOnly" type="boolean" default={false}>
  Controla o escopo da pesquisa: - `false` (padrão): pesquisa empresas primeiro e, se nenhuma
  empresa for encontrada, pesquisa pessoas. - `true`: pesquisa apenas pessoas (ignora totalmente a pesquisa de empresas).
</ParamField>

## Exemplos

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