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

# Buscar en LinkedIn

> Busca empresas o personas en 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} />

Busca empresas o personas en LinkedIn a partir de una consulta de búsqueda.
Este endpoint se usa comúnmente para autocompletado de menciones (typeahead) en publicaciones de redes sociales.

**La cuenta vinculada debe ser una página de empresa de LinkedIn para poder buscar.** Las cuentas personales de LinkedIn no pueden realizar búsquedas.

1. **Para menciones en publicaciones**: al implementar @menciones, usa este endpoint con funcionalidad de typeahead.
2. **Búsqueda de empresas**: se requiere el vanity name exacto de la empresa.
3. **Búsqueda de personas**: comienza con al menos 3 caracteres del nombre para obtener mejores resultados.
4. **Límites de tasa**: este endpoint sigue los rate limits estándar de la API.

<Note>
  **Limitaciones de búsqueda**

  <ul class="custom-bullets">
    <li>**Empresas**: puedes buscar cualquier página de empresa de LinkedIn</li>

    <li>
      **Personas**: solo puedes buscar personas que sean seguidoras de tu cuenta de LinkedIn y la
      cuenta vinculada a Ayrshare debe ser una página de empresa de LinkedIn para poder realizar la búsqueda. Si una persona tiene
      la visibilidad de su LinkedIn configurada como privada, no aparecerá en los resultados de búsqueda.
    </li>
  </ul>
</Note>

## Parámetros del header

<HeaderAPI />

## Parámetros de query

<ParamField query="search" type="string" required>
  Consulta de búsqueda para encontrar empresas o personas en LinkedIn.

  **Requisitos:**

  {" "}

  <ul class="custom-bullets">
    <li>Longitud mínima: 3 caracteres para personas y 1 carácter para empresas.</li>
    <li>Longitud máxima: 100 caracteres tanto para personas como para empresas.</li>
  </ul>

  **Comportamiento de la búsqueda:**

  <ul class="custom-bullets">
    <li>
      <strong>Para empresas</strong>: usa el vanity name de la empresa (que aparece en la URL de LinkedIn). Solo se devuelven **coincidencias exactas del vanity name**.

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

        <li>
          Buscar nombres parciales como "ayrsh" NO devolverá resultados.
        </li>
      </ul>
    </li>

    <li>
      <strong>Para personas</strong>: usa el nombre y/o el apellido. Se admiten coincidencias parciales de nombres.

      <ul class="custom-bullets">
        <li>
          Ejemplo: "John Smith" encontrará personas llamadas John Smith. Asegúrate de codificar el espacio en la URL.
        </li>

        <li>
          Las coincidencias parciales como "Joh" o "Smi" también devolverán resultados.
        </li>
      </ul>

      <ul class="custom-bullets">
        <li>
          Recuerda: solo se pueden encontrar tus seguidores de LinkedIn y la cuenta vinculada a Ayrshare debe ser una página de empresa de LinkedIn para realizar la búsqueda
        </li>
      </ul>
    </li>
  </ul>
</ParamField>

<ParamField query="personOnly" type="boolean" default={false}>
  Controla el alcance de la búsqueda: - `false` (por defecto): busca primero empresas y luego personas si no se
  encuentran empresas. - `true`: busca solo personas (omite por completo la búsqueda de empresas).
</ParamField>

## Ejemplos

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