> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API de la Biblioteca de anuncios de LinkedIn

> Analiza los anuncios de la competencia desde la Biblioteca de anuncios de LinkedIn en JSON: busca los anuncios por palabra clave, anunciante o pagador, y abre un anuncio para ver quién pagó, las impresiones y los países que alcanzó, cuando la biblioteca los publica.

Lee la Biblioteca de anuncios de LinkedIn como JSON a través de la API asíncrona de tareas para ver qué anuncia tu competencia a los profesionales. ADS es un motor propio: envía `taskType` `ADS` con `platform` `linkedin_ad_library`, y `action` elige qué leer. Para elegir entre las bibliotecas de anuncios, consulta [Bibliotecas de anuncios comparadas](https://docs.querying.ai/es/engines/ad-libraries.md).

* `search` (por defecto) lista anuncios por una palabra clave en `query`, por el nombre de un anunciante en `advertiserName`, por quién pagó en `payer`, o por una combinación. Cada anuncio incluye su anunciante, formato, título, texto y contenido multimedia, y la respuesta termina con un `summary` de los anuncios devueltos.
* `ad` abre un anuncio: el anunciante, quién pagó, la página de destino y, donde la biblioteca lo publica, las fechas de emisión, las impresiones, los países que alcanzó y su segmentación.

La biblioteca no tiene búsqueda de anunciantes, así que `action` `advertisers` se rechaza con `400 VALIDATION_ERROR`. Encuentra a un competidor con `advertiserName` en una búsqueda.

Una búsqueda cuesta **0.5 créditos por cada 30 anuncios** que devuelve. `ad` cuesta 0.5 créditos.

## Solicitud

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "linkedin_ad_library", "query": "webinar", "country": "ALL", "limit": 30 } }'
```

Envía la tarea y consulta `GET /v1/async/task/{id}` o recibe su webhook. Consulta [Tareas asíncronas](https://docs.querying.ai/es/concepts/async-tasks.md). La biblioteca limita la velocidad de lectura, así que una búsqueda de 120 anuncios tarda unos treinta segundos.

## Analiza los anuncios de un competidor

Tres solicitudes cubren un análisis de la competencia:

1. `search` con el nombre del competidor en `advertiserName` lista sus anuncios. `advertiserName` coincide con parte de un nombre, así que revisa `advertiserName` en cada anuncio. Añade `query` para acotar los anuncios a un tema, y `sortBy` `oldest` para empezar por los anuncios más antiguos.
2. `ad` con el `libraryId` de un anuncio devuelve quién pagó, la página de destino y, en los anuncios mostrados en la UE, las fechas de emisión, las impresiones y la segmentación.
3. `search` con `payer` lista los anuncios que pagó una agencia o empresa, sea cual sea la página que los publica.

## Parámetros

* `action`: `search` (por defecto) o `ad`.
* `query`: Una palabra clave en el texto del anuncio. `search` necesita `query`, `advertiserName` o `payer`.
* `advertiserName`: Un nombre, que coincide con parte del nombre del anunciante, como `samsung`.
* `payer`: El nombre de quien pagó el anuncio, que coincide con parte del nombre, como `Starcom`.
* `libraryId`: El ID numérico de un anuncio, como `1638962914`. `ad` lo requiere.
* `country`: Dónde se mostraron los anuncios, como código de país de dos letras, o `ALL` para todos los países (por defecto).
* `startDate`, `endDate`: `YYYY-MM-DD`, enviados juntos, dentro del último año. Conserva los anuncios mostrados entre los dos días.
* `sortBy`: `newest` (por defecto) o `oldest`.
* `limit`: De 1 a 120 anuncios. Por defecto 30.
* `cursor`: El `nextCursor` de una respuesta anterior, para leer los anuncios siguientes.

`search` lee todos los campos anteriores excepto `libraryId`, y `ad` lee solo `libraryId`. Un filtro de la Biblioteca de anuncios de Meta (`pageId`, `pageIds`, `activeStatus`, `searchType`, `adType`, `mediaType`, `publisherPlatforms` o `contentLanguages`), un valor que la biblioteca no puede buscar o un campo que la acción no lee se rechaza con `400 VALIDATION_ERROR`, y `details` indica el campo.

## Leer más anuncios

Una respuesta con más anuncios por leer incluye `nextCursor`. Envíalo como `cursor` con la misma búsqueda para recibir los anuncios siguientes, de nuevo hasta `limit`. `nextCursor` es `null` cuando la biblioteca no tiene más. Un cursor solo funciona con la búsqueda que lo devolvió: un `query`, `advertiserName`, `payer`, `country`, rango de fechas o `sortBy` distinto se rechaza con `400 VALIDATION_ERROR`, mientras que `limit` puede cambiar.

## Respuesta de búsqueda

```json theme={"theme":"css-variables"}
{
  "platform": "linkedin_ad_library",
  "action": "search",
  "country": "ALL",
  "query": "webinar",
  "totalCount": null,
  "returnedCount": 30,
  "hasMore": true,
  "nextCursor": "eyJ2IjoxLCJoIjoielVmY24wUlRHU0hSWHYwYSIsImMiOiIxNjk4Mjc2MTc2LTE3OTUyMTAzMTIxMzkiLCJzIjo2LCJwIjozMH0",
  "libraryUrl": "https://www.linkedin.com/ad-library/search?keyword=webinar&countries=ALL",
  "ads": [
    {
      "position": 1,
      "libraryId": "1698500736",
      "libraryUrl": "https://www.linkedin.com/ad-library/detail/1698500736",
      "advertiserId": null,
      "advertiserName": "Rescale",
      "isActive": null,
      "startDate": null,
      "endDate": null,
      "activeDays": null,
      "platforms": ["LINKEDIN"],
      "format": "IMAGE",
      "title": "How engineering teams get AI agents past the pilot",
      "body": "Most engineering teams have tried AI agents. Far fewer have moved them past the pilot. Watch Kairos Power and Oak Ridge …",
      "ctaText": null,
      "ctaType": null,
      "linkUrl": null,
      "landingDomain": null,
      "utm": null,
      "payer": null,
      "impressions": null,
      "targeting": null,
      "reachedCountries": null,
      "images": [
        "https://media.licdn.com/dms/image/v2/D5610AQFdah1Z0xeBuQ/image-shrink_1280/B56aH7HH6kH4AY-/0/1795214311284/Fall2026-Showcase_LinkedIn_6A_Webinar-on-demand_1200x1200png"
      ],
      "videos": [],
      "advertiserLogoUrl": "https://media.licdn.com/dms/image/v2/D560BAQFsh4MOa0Ohiw/company-logo_100_100/B56Z4dQLnEIQAQ-/0/1778607242071/rescale_logo",
      "advertiserType": null,
      "advertiserUrl": null,
      "bodyTruncated": true,
      "creativeType": "SPONSORED_STATUS_UPDATE"
    }
  ],
  "summary": {
    "ads": 30,
    "activeAds": 0,
    "advertisers": [
      { "advertiserName": "Rescale", "ads": 5 }
    ],
    "formats": { "ARTICLE": 1, "CAROUSEL": 1, "IMAGE": 24, "SPOTLIGHT": 2, "VIDEO": 2 },
    "platforms": { "LINKEDIN": 30 },
    "ctaTypes": {},
    "landingDomains": [],
    "utmCampaigns": [],
    "launchesByWeek": [],
    "longestRunning": [],
    "oldestStartDate": null,
    "newestStartDate": null,
    "medianActiveDays": null
  }
}
```

* La respuesta devuelve `platform`, `action`, `country`, `query`, `advertiserName`, `payer`, `sortBy` y las fechas recibidas. `returnedCount` cuenta los anuncios de `ads`, `hasMore` es `true` cuando la biblioteca tiene más, que `nextCursor` lee, y `libraryUrl` abre la misma búsqueda en la Biblioteca de anuncios. `totalCount` es `null`, porque la biblioteca no da un recuento.
* Cada anuncio es una tarjeta: `position`, `libraryId`, `libraryUrl`, `advertiserName`, `advertiserLogoUrl`, `creativeType` (como `SPONSORED_STATUS_UPDATE` o `SPONSORED_VIDEO`), `format`, `title`, `body`, `images` y `videos` (el póster del vídeo en `previewUrl`), y `platforms` (`LINKEDIN`). `format` es `IMAGE`, `VIDEO`, `CAROUSEL`, `DOCUMENT`, `ARTICLE`, `MESSAGE`, `JOB`, `SPOTLIGHT` o `FOLLOW_COMPANY`.
* Los anuncios de mensaje y los anuncios Thought Leader incluyen `member`, el remitente del mensaje o el miembro cuya publicación promueve el anuncio, con `name` y `url`; `ad` lo devuelve con la misma forma. En los demás anuncios, `member` es `null`.
* Una tarjeta incluye los primeros 120 caracteres del texto, y `bodyTruncated` es `true` cuando el texto es más largo. `ad` devuelve el texto completo.
* `advertiserId`, `payer`, `startDate`, `endDate`, `activeDays`, `linkUrl`, `landingDomain`, `impressions`, `targeting`, `ctaText` y `utm` son `null` en una tarjeta. `ad` los rellena cuando la biblioteca los tiene. `isActive` es `null`, porque la biblioteca no indica si un anuncio sigue en emisión.
* `summary` cuenta los anuncios de esta respuesta: `ads`, `advertisers` (los 10 con más anuncios: `advertiserName`, `ads`), `formats` y `platforms`. Sus campos de fecha (`oldestStartDate`, `newestStartDate`, `medianActiveDays`, `launchesByWeek` y `longestRunning`) quedan vacíos o en `null`, porque las tarjetas no incluyen fechas.
* Una búsqueda sin anuncios coincidentes se completa con `ads` vacío y un `summary` de `0` anuncios.

## Qué conserva la biblioteca

* El creativo, el anunciante y el pagador de cada anuncio están disponibles para todos los países.
* Las fechas de emisión, el rango de impresiones, el porcentaje de impresiones por país y la segmentación solo están disponibles para los anuncios mostrados en la UE.
* La biblioteca conserva los anuncios durante unos 12 meses, y su filtro de fechas solo acepta el último año.

## Abrir un anuncio

`action` `ad` abre el anuncio con el `libraryId` que envíes, obtenido de una búsqueda o de la dirección de la Biblioteca de anuncios `/ad-library/detail/<libraryId>`.

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "linkedin_ad_library", "action": "ad", "libraryId": "1638962914" } }'
```

```json theme={"theme":"css-variables"}
{
  "platform": "linkedin_ad_library",
  "action": "ad",
  "libraryId": "1638962914",
  "ad": {
    "libraryId": "1638962914",
    "libraryUrl": "https://www.linkedin.com/ad-library/detail/1638962914",
    "advertiserId": "85881048",
    "advertiserName": "Samsung Germany",
    "isActive": null,
    "startDate": "2026-11-11",
    "endDate": "2026-11-22",
    "activeDays": 12,
    "platforms": ["LINKEDIN"],
    "format": "VIDEO",
    "title": "Smart arbeiten mit der Galaxy Z-Serie",
    "body": "Mails mobil checken, aber für die eigentliche Arbeit genervt an den Laptop wechseln? Das bremst den Workflow.\n\nSpar dir den Medienbruch mit der neuen Galaxy Z-Serie und nutze die maximale Flexibilität unserer faltbaren Smartphones:\n\n📱 Z Fold8 Ultra: 8-Zoll-…",
    "ctaText": "Learn more",
    "ctaType": null,
    "linkUrl": "https://www.samsung.com/de/smartphones/galaxy-z-fold8/",
    "landingDomain": "samsung.com",
    "utm": null,
    "payer": "Starcom Germany GmbH",
    "impressions": { "min": 50000, "max": 100000 },
    "targeting": {
      "language": { "exclude": null, "include": ["English"] },
      "location": { "exclude": null, "include": ["Germany"] },
      "parameters": [
        { "excluded": false, "parameter": "Audience", "targeted": false }
      ]
    },
    "reachedCountries": ["DE"],
    "images": [],
    "videos": [
      {
        "bitrate": 12005128,
        "files": [
          {
            "bitrate": 12005128,
            "type": "video/mp4",
            "url": "https://dms.licdn.com/playlist/vid/v2/D4E10AQHs0oH-zSWScA/progressive-servable-video/B4EaHKwT54IoAg-/0/1794403027272"
          }
        ],
        "previewUrl": "https://media.licdn.com/dms/image/v2/D4E10AQHs0oH-zSWScA/videocover-high/B4EaHKwT54IoBQ-/0/1794403028674",
        "url": "https://dms.licdn.com/playlist/vid/v2/D4E10AQHs0oH-zSWScA/progressive-servable-video/B4EaHKwT54IoAg-/0/1794403027272"
      }
    ],
    "advertiserLogoUrl": "https://media.licdn.com/dms/image/v2/D4E0BAQEL38Z5ttMZXw/company-logo_100_100/company-logo_100_100/0/1692353831724/samsung_germany_logo",
    "advertiserType": "company",
    "advertiserUrl": "https://www.linkedin.com/company/85881048",
    "bodyTruncated": false,
    "creativeType": "SPONSORED_VIDEO"
  },
  "advertiser": {
    "advertiserId": "85881048",
    "advertiserName": "Samsung Germany",
    "logoUrl": "https://media.licdn.com/dms/image/v2/D4E0BAQEL38Z5ttMZXw/company-logo_100_100/company-logo_100_100/0/1692353831724/samsung_germany_logo",
    "type": "company",
    "url": "https://www.linkedin.com/company/85881048"
  },
  "transparency": {
    "impressions": { "min": 50000, "max": 100000 },
    "impressionsText": "50k-100k",
    "reachByCountry": [
      { "country": "Germany", "countryCode": "DE", "share": 100, "shareText": "100%" }
    ]
  },
  "variants": null
}
```

* `ad` tiene los campos de una tarjeta de búsqueda con el texto completo, más `advertiserId`, `advertiserUrl`, `advertiserType` (`company` o `person`), `payer` (quién pagó el anuncio), `linkUrl`, `landingDomain`, `ctaText`, `startDate`, `endDate`, `activeDays`, `impressions`, `targeting` y `reachedCountries`.
* `impressions` es el rango que publica la biblioteca (`min`, `max`). `targeting` lista los idiomas y ubicaciones que el anunciante incluyó o excluyó (`language`, `location`) y los parámetros de segmentación (`parameters`: `parameter`, `targeted`, `excluded`). Las fechas, `impressions`, `targeting` y `reachedCountries` son `null` en un anuncio que no se mostró en la UE, como el anuncio de Adobe `1698237666`. El pagador y el anunciante aparecen en todos los anuncios.
* `videos` lista cada vídeo con `url` (el archivo con la tasa de bits más alta), `files` (cada mp4: `url`, `type`, `bitrate`) y `previewUrl`. Un anuncio de carrusel añade `cards` (`title`, `imageUrl`) y un anuncio de documento añade `document` (su título, número de páginas y portadas de las páginas).
* `advertiser` es la página que hay detrás del anuncio: `advertiserId`, `advertiserName`, `url`, `type` y `logoUrl`.
* `transparency` es `null` en un anuncio no mostrado en la UE. En un anuncio mostrado en la UE contiene `impressions`, `impressionsText` (el texto de la biblioteca, como `50k-100k`) y `reachByCountry`, el porcentaje de las impresiones en cada país (`country`, `countryCode`, `share`, `shareText`), también fuera de la UE.
* `variants` lista las otras versiones del anuncio cuando la biblioteca muestra más de una, y es `null` en caso contrario.
* Las URL del contenido multimedia de los creativos siguen abiertas durante años. Las URL de las tarjetas de un carrusel caducan tras una semana aproximadamente, y los logotipos de los anunciantes tras unas dos semanas y media. Guarda los archivos que necesites.
* Un `libraryId` para el que la biblioteca no tiene ningún anuncio falla con `PAGE_UNAVAILABLE`.

## Precio

Una búsqueda reserva 0.5 créditos por cada 30 anuncios que pide su `limit`, y cobra 0.5 créditos por cada 30 anuncios que devuelve, con un mínimo de 0.5 créditos. La búsqueda predeterminada de 30 anuncios cuesta 0.5 créditos, y una búsqueda con `limit` 120 reserva 2 créditos. `ad` cuesta 0.5 créditos. Solo se cobran las solicitudes completadas.

## Relacionado

* [Bibliotecas de anuncios comparadas](https://docs.querying.ai/es/engines/ad-libraries.md)
* [Biblioteca de anuncios de Meta](https://docs.querying.ai/es/engines/meta-ad-library.md)
* [Resumen de motores](https://docs.querying.ai/es/engines/overview.md)
* [Créditos y límites](https://docs.querying.ai/es/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.