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

# API de LinkedIn

> Opciones para publicar usando la API de LinkedIn

La API de LinkedIn tiene los siguientes requisitos y restricciones:

<ul class="custom-bullets">
  <li>El campo `post` acepta hasta 3000 caracteres.</li>

  <li>
    LinkedIn generará automáticamente una previsualización del enlace en la publicación a menos que se incluya una imagen o
    un video. En el ejemplo anterior se mostrará la imagen. Al quitar la imagen aparecerá la previsualización del enlace.
    Si no se puede obtener la previsualización del enlace, la publicación se seguirá publicando y se devolverá un campo
    `linkPreviewFailed: true` en la respuesta de /post.
  </li>

  <li>Los hashtags son clicables en LinkedIn. Usa el símbolo # para especificar un hashtag de LinkedIn.</li>

  <li>
    Si publicas un video y no termina con una extensión de video conocida como mp4, usa el
    parámetro `isVideo`. Consulta el [endpoint /post](/apis/post/post) para más detalles.
  </li>

  <li>
    El procesamiento de video de LinkedIn tarda varios minutos en completarse. Espera antes de probar la URL
    para compartir o obtener las analíticas del video.
  </li>

  <li>LinkedIn limita a 150 publicaciones por día por cuenta de LinkedIn.</li>
  <li>No se admite publicar en grupos de LinkedIn.</li>

  <li>
    LinkedIn también admite el envío de medios sin texto de publicación. Si no quieres incluir texto en la publicación,
    envía una cadena vacía `post: ""`.
  </li>

  <li>Puedes vincular una página de empresa o una cuenta personal de LinkedIn.</li>

  <li>
    Consulta las [Directrices de medios de LinkedIn](/media-guidelines/linkedin) y la [Autorización de LinkedIn](/dashboard/connect-social-accounts/linkedin) para más información.
  </li>
</ul>

<Warning>
  Debes ser "Super Admin" o "Content Admin" para conectar una página de empresa de LinkedIn.{" "}
</Warning>

## Publicar en LinkedIn

JSON para una publicación básica con un enlace y una imagen en 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"]
}
```

## Opciones de LinkedIn

Puedes establecer opciones adicionales para una publicación usando el parámetro `linkedInOptions`.

```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"
  }
}
```

Las opciones de LinkedIn son campos opcionales que se pueden usar para controlar la publicación.

<ParamField body="altText" type="array of strings">
  Texto alternativo de las imágenes para accesibilidad y lectores de pantalla.

  Consulta [Texto alternativo de LinkedIn](/apis/post/social-networks/linkedin#alternative-text) para más información.
</ParamField>

<ParamField body="disableShare" type="boolean" default={false}>
  Deshabilita la capacidad de que los usuarios recompartan la publicación de LinkedIn.

  Consulta [Deshabilitar compartir en LinkedIn](/apis/post/social-networks/linkedin#disable-share) para más información.
</ParamField>

<ParamField body="targeting" type="object">
  Orienta tus publicaciones orgánicas a grupos específicos por países, industria, cargo y más.

  Requiere al menos 300 seguidores en la audiencia objetivo.

  Consulta [Segmentación de audiencia en LinkedIn](/apis/post/social-networks/linkedin#audience-targeting) para más información.
</ParamField>

<ParamField body="thumbNail" type="string">
  La miniatura de un video. Debe ser PNG o JPG, con las mismas dimensiones que el video y menos de 10 MB. La URL debe terminar en .png o .jpg.

  Consulta [Miniatura de video de LinkedIn](/apis/post/social-networks/linkedin#video-thumbnail) para más información.
</ParamField>

<ParamField body="title" type="string">
  El título de un documento al publicar archivos PPT, PPTX, DOC, DOCX o PDF. Longitud máxima: 400 caracteres.

  Si no se especifica, se usa el nombre del archivo.

  Consulta [Documentos en LinkedIn](/apis/post/social-networks/linkedin#documents) para más información.
</ParamField>

<ParamField body="titles" type="array of strings">
  Título o subtítulos de medios para imágenes o videos de LinkedIn.

  Cada título corresponde a una URL de medio en orden.

  Consulta [Títulos de medios en LinkedIn](/apis/post/social-networks/linkedin#media-titles) para más información.
</ParamField>

<ParamField body="visibility" type="string" default="public">
  La visibilidad de la publicación.

  Valores: `public`, `connections` o `loggedin`.

  Consulta [Visibilidad de publicaciones en LinkedIn](/apis/post/social-networks/linkedin#post-visibility) para más información.
</ParamField>

## Texto alternativo

Añade texto alternativo de LinkedIn, también conocido como alt text de LinkedIn, a una imagen de LinkedIn. El alt text de LinkedIn es una función de accesibilidad utilizada para brindar información adicional al usuario y para lectores de pantalla. LinkedIn no admite altText en videos o documentos.

Usa `altText` dentro del objeto `linkedInOptions`.

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

Cada alt text debe corresponder a una imagen del arreglo `mediaUrls`. El alt text se aplicará a cada imagen en orden.

## Segmentación de audiencia

LinkedIn te permite orientar tus publicaciones orgánicas a grupos específicos de usuarios. Puedes segmentar por países, industria, cargo y más.

<Warning>
  La segmentación de LinkedIn requiere al menos **300 seguidores en la audiencia objetivo**. Por ejemplo, si
  tienes 400 seguidores y segmentas solo a usuarios del país US, pero solo 200 de tus seguidores están
  en US, la segmentación fallará porque la audiencia es demasiado pequeña.
</Warning>

Usa el objeto `targeting` dentro del objeto `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"]
    }
  }
}
```

Las opciones de segmentación disponibles están listadas en los siguientes archivos JSON:

<ul class="custom-bullets">
  <li>[Países de LinkedIn](https://logo.ayrshare.com/data/linkedin/countries.json)</li>
  <li>[Antigüedades de LinkedIn](https://logo.ayrshare.com/data/linkedin/seniorities.json)</li>
  <li>[Títulos académicos de LinkedIn](https://logo.ayrshare.com/data/linkedin/degrees.json)</li>
  <li>[Campos de estudio de LinkedIn](https://logo.ayrshare.com/data/linkedin/fieldsOfStudy.json)</li>
  <li>[Industrias de LinkedIn](https://logo.ayrshare.com/data/linkedin/industries.json)</li>
  <li>[Funciones laborales de LinkedIn](https://logo.ayrshare.com/data/linkedin/jobFunctions.json)</li>

  <li>
    [Rangos de plantilla de LinkedIn](https://logo.ayrshare.com/data/linkedin/staffCountRanges.json)
  </li>
</ul>

## Renovación de la autorización

LinkedIn debe reautorizarse *cada año* a través de la página Social Accounts.

<ul class="custom-bullets">
  <li>
    Se enviará una notificación por correo electrónico y por webhook social action con 15 días de anticipación al vencimiento
    de la autorización.
  </li>

  <li>
    La fecha en la que se requiere la renovación y los días restantes se pueden obtener desde el
    endpoint [/user](/apis/user/overview).
  </li>

  <li>
    El usuario verá en su página de vinculación de cuentas sociales una alerta y un botón de renovación 30 días
    antes del vencimiento.
  </li>
</ul>

## Límites de caracteres

Consulta [Límites de caracteres de LinkedIn](/help-center/technical-support/character_limits#linkedin-character-limits) para más información.

## Deshabilitar compartir

Puedes deshabilitar la capacidad de que los usuarios recompartan la publicación de LinkedIn estableciendo el campo `disableShare` en `true` dentro del objeto `linkedInOptions`:

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

## Documentos

Usa la API para publicar un documento en LinkedIn. Los formatos de archivo admitidos incluyen: PPT, PPTX, DOC, DOCX y PDF. Asegúrate de que el documento pese menos de 100 MB y no supere las 300 páginas.

A continuación se muestra un ejemplo de código que demuestra cómo publicar un documento PPTX con un título:

```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"]
}
```

La URL de medio proporcionada debe terminar con una extensión de documento conocida: ppt, pptx, doc, docx o pdf.

## Menciones en LinkedIn

Puedes mencionar otras organizaciones de LinkedIn, es decir, páginas de empresa, o perfiles de miembros, es decir, páginas de perfil individuales, en tus publicaciones.

Ayrshare intenta resolver la @mención haciendo una búsqueda del handle.
Si la @mención no se encuentra, se eliminará el @ de la publicación porque LinkedIn no acepta publicaciones con menciones no resueltas.
No se pueden mencionar perfiles individuales de LinkedIn.

<Warning>
  Si alguna mención en una publicación de LinkedIn no se puede resolver (debido a configuraciones de privacidad,
  restricciones de cuenta u otras limitaciones de la plataforma), LinkedIn puede fallar en
  renderizar todas las menciones de esa publicación como enlaces clicables. Este es el comportamiento de la plataforma
  LinkedIn y no un problema de la API. Para evitarlo, asegúrate de que todos los usuarios y
  organizaciones mencionados permitan menciones desde tu organización, o considera publicar las menciones
  por separado para aislar cualquier mención problemática.
</Warning>

Consulta las [reglas importantes](/testing/post-verification#mentions) sobre menciones.

### Perfiles de organización

Menciona otro handle de organización de LinkedIn añadiendo `@handle` en el texto de la publicación. El `@handle` es el nombre de la empresa u organización.
Puedes mencionar en publicaciones, comentarios y respuestas a comentarios.

Por ejemplo,

<ul class="custom-bullets">
  <li>
    El perfil de empresa de LinkedIn de Ayrshare es
    [https://www.linkedin.com/company/ayrshare](https://www.linkedin.com/company/ayrshare) y el
    handle que se usaría sería *@ayrshare*.
  </li>

  <li>
    El perfil de empresa de LinkedIn de Zara es
    [https://www.linkedin.com/company/zara-sa/](https://www.linkedin.com/company/zara-sa/) y el
    handle que se usaría sería *@zara-sa*.
  </li>
</ul>

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

### Perfiles de miembros

Menciona otro perfil de miembro de LinkedIn añadiendo `@vanity_name` o `@[John Smith]` en el texto de la publicación.

1. `@vanity_name` es el vanity name del perfil del miembro. Por ejemplo, en la URL de perfil del miembro `https://www.linkedin.com/in/vanity_name/`, el vanity name es `vanity_name`.
2. `@[John Smith]` es el nombre completo de la persona. Por ejemplo, si el nombre completo de la persona es `John Smith`, la mención sería `@[John Smith]`.

Puedes mencionar en publicaciones, comentarios y respuestas a comentarios.

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

En el ejemplo anterior, John Smith y Ava Smith serán mencionados en la publicación: el primero usando su nombre completo y el segundo usando su vanity name.

**Notas importantes:**

1. Debes tener una página de empresa de LinkedIn conectada a tu cuenta de Ayrshare para poder mencionar perfiles
   de miembros. Si conectas tu cuenta personal de LinkedIn, no podrás mencionar los perfiles de otras
   personas.
2. LinkedIn solo permite mencionar personas que siguen a tu página de organización/empresa.

## Títulos de medios

Añade título o subtítulos de medios a imágenes o videos de LinkedIn.

Usa `titles` dentro del objeto `linkedInOptions`.

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

Cada título debe corresponder a una imagen o video del arreglo `mediaUrls`. El título se aplicará a cada imagen o video en orden.

## Publicaciones con múltiples imágenes

Puedes publicar hasta *9 URLs de imagen* en `mediaUrls` en LinkedIn.

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

LinkedIn aún no admite imágenes en carrusel para publicaciones orgánicas.

## Visibilidad de la publicación

LinkedIn te permite controlar la visibilidad de tus publicaciones.
Puedes establecer la visibilidad como pública, solo para conexiones o solo para usuarios con sesión iniciada.
Si no se especifica una visibilidad, la publicación será "public" y visible para todos los usuarios de LinkedIn.

<ul class="custom-bullets">
  <li>
    `public`: la publicación será visible para todos los usuarios de LinkedIn. Disponible tanto para páginas de empresa como para
    cuentas personales de LinkedIn conectadas. Valor por defecto si no se especifica visibilidad.
  </li>

  <li>
    `connections`: la publicación será visible para la red de primer grado del propietario (User Profile).
    Disponible solo para cuentas personales de LinkedIn conectadas.
  </li>

  <li>
    `loggedin`: la publicación será visible solo para usuarios de LinkedIn con sesión iniciada. Disponible tanto para
    páginas de empresa como para cuentas personales de LinkedIn conectadas.
  </li>
</ul>

Usa el campo `visibility` dentro del objeto `linkedInOptions`:

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

## Permisos de publicación de video

En LinkedIn, solo los usuarios con permisos específicos pueden publicar videos en páginas de empresa:

1. Usuarios con permisos de Admin.
2. Usuarios con permisos de Direct Sponsored Content (DSC).

Los Content Administrators no tienen la capacidad de publicar videos en páginas de empresa de LinkedIn.

## Miniatura del video

Establece una miniatura de LinkedIn para un video. Envía una URL remota de un archivo PNG o JPG con las mismas dimensiones que el video y menos de 10 MB. La URL debe terminar en .png o .jpg.

Usa `thumbNail` dentro del objeto `linkedInOptions`.

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

Consulta aquí más [ejemplos de uso de la API de LinkedIn](https://www.ayrshare.com/how-to-post-and-get-analytics-with-the-linkedin-api#linkedin-api-examples).
