> ## 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 Bibliothèque publicitaire de LinkedIn

> Analysez les publicités de vos concurrents depuis la Bibliothèque publicitaire de LinkedIn en JSON : recherchez les publicités par mot-clé, annonceur ou payeur, et ouvrez une publicité pour voir qui a payé, les impressions et les pays touchés, là où la bibliothèque les publie.

Lisez la Bibliothèque publicitaire de LinkedIn en JSON via l’API asynchrone de tâches pour voir ce que vos concurrents diffusent auprès des professionnels. ADS est un moteur à part entière : envoyez `taskType` `ADS` avec `platform` `linkedin_ad_library`, et `action` choisit ce qu’il faut lire. Pour choisir entre les bibliothèques publicitaires, voir [Bibliothèques publicitaires comparées](https://docs.querying.ai/fr/engines/ad-libraries.md).

* `search` (par défaut) liste les publicités par un mot-clé dans `query`, par le nom d’un annonceur dans `advertiserName`, par qui a payé dans `payer`, ou par une combinaison. Chaque publicité indique son annonceur, son format, son titre, son texte et ses médias, et la réponse se termine par un `summary` des publicités renvoyées.
* `ad` ouvre une publicité : l’annonceur, qui a payé, la page de destination et, là où la bibliothèque les publie, les dates de diffusion, les impressions, les pays touchés et son ciblage.

La bibliothèque n’a pas de recherche d’annonceur, donc `action` `advertisers` est rejetée avec `400 VALIDATION_ERROR`. Trouvez un concurrent avec `advertiserName` dans une recherche.

Une recherche coûte **0.5 crédit pour 30 publicités** renvoyées. `ad` coûte 0.5 crédit.

## Requête

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

Soumettez la tâche, puis interrogez `GET /v1/async/task/{id}` ou recevez son webhook. Voir [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md). La bibliothèque limite sa vitesse de lecture, donc une recherche de 120 publicités prend environ une demi-minute.

## Analyser les publicités d’un concurrent

Trois requêtes couvrent une analyse de la concurrence :

1. `search` avec le nom du concurrent dans `advertiserName` liste ses publicités. `advertiserName` correspond à une partie d’un nom, donc vérifiez `advertiserName` sur chaque publicité. Ajoutez `query` pour restreindre les publicités à un sujet, et `sortBy` `oldest` pour commencer par les plus anciennes.
2. `ad` avec le `libraryId` d’une publicité renvoie qui a payé, la page de destination et, pour les publicités diffusées dans l’UE, les dates de diffusion, les impressions et le ciblage.
3. `search` avec `payer` liste les publicités payées par une agence ou une entreprise, quelle que soit la page qui les diffuse.

## Paramètres

* `action` : `search` (par défaut) ou `ad`.
* `query` : un mot-clé dans le texte de la publicité. `search` exige `query`, `advertiserName` ou `payer`.
* `advertiserName` : un nom, recherché comme partie du nom de l’annonceur, comme `samsung`.
* `payer` : le nom de celui qui a payé la publicité, recherché comme partie du nom, comme `Starcom`.
* `libraryId` : l’ID numérique d’une publicité, comme `1638962914`. `ad` l’exige.
* `country` : où les publicités ont été diffusées, sous forme de code pays à deux lettres, ou `ALL` pour tous les pays (par défaut).
* `startDate`, `endDate` : `YYYY-MM-DD`, envoyés ensemble, dans la dernière année. Conserve les publicités diffusées entre les deux jours.
* `sortBy` : `newest` (par défaut) ou `oldest`.
* `limit` : de 1 à 120 publicités. Par défaut 30.
* `cursor` : le `nextCursor` d’une réponse précédente, pour lire les publicités suivantes.

`search` lit tous les champs ci-dessus sauf `libraryId`, et `ad` lit uniquement `libraryId`. Un filtre de la Bibliothèque publicitaire de Meta (`pageId`, `pageIds`, `activeStatus`, `searchType`, `adType`, `mediaType`, `publisherPlatforms` ou `contentLanguages`), une valeur que la bibliothèque ne peut pas rechercher ou un champ que l’action ne lit pas est rejeté avec `400 VALIDATION_ERROR`, et `details` nomme le champ.

## Lire plus de publicités

Une réponse qui a encore des publicités à lire contient `nextCursor`. Envoyez-le comme `cursor` avec la même recherche pour recevoir les publicités suivantes, là encore jusqu’à `limit`. `nextCursor` vaut `null` lorsque la bibliothèque n’en a plus. Un curseur ne fonctionne qu’avec la recherche qui l’a renvoyé : un `query`, `advertiserName`, `payer`, `country`, une plage de dates ou un `sortBy` différents sont rejetés avec `400 VALIDATION_ERROR`, tandis que `limit` peut changer.

## Réponse de recherche

```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 réponse reprend `platform`, `action`, `country`, `query`, `advertiserName`, `payer`, `sortBy` et les dates reçues. `returnedCount` compte les publicités dans `ads`, `hasMore` vaut `true` lorsque la bibliothèque en a davantage, ce que `nextCursor` lit, et `libraryUrl` ouvre la même recherche dans la Bibliothèque publicitaire. `totalCount` vaut `null`, car la bibliothèque ne donne aucun compte.
* Chaque publicité est une carte : `position`, `libraryId`, `libraryUrl`, `advertiserName`, `advertiserLogoUrl`, `creativeType` (comme `SPONSORED_STATUS_UPDATE` ou `SPONSORED_VIDEO`), `format`, `title`, `body`, `images` et `videos` (l’affiche de la vidéo dans `previewUrl`), et `platforms` (`LINKEDIN`). `format` vaut `IMAGE`, `VIDEO`, `CAROUSEL`, `DOCUMENT`, `ARTICLE`, `MESSAGE`, `JOB`, `SPOTLIGHT` ou `FOLLOW_COMPANY`.
* Les publicités de message et les publicités Thought Leader comportent `member`, l’expéditeur du message ou le membre dont la publication est promue, avec `name` et `url` ; `ad` le renvoie sous la même forme. Sur les autres publicités, `member` vaut `null`.
* Une carte contient les 120 premiers caractères du texte, et `bodyTruncated` vaut `true` lorsque le texte est plus long. `ad` renvoie le texte complet.
* `advertiserId`, `payer`, `startDate`, `endDate`, `activeDays`, `linkUrl`, `landingDomain`, `impressions`, `targeting`, `ctaText` et `utm` valent `null` sur une carte. `ad` les remplit lorsque la bibliothèque les a. `isActive` vaut `null`, car la bibliothèque n’indique pas si une publicité est toujours diffusée.
* `summary` compte les publicités de cette réponse : `ads`, `advertisers` (les 10 qui ont le plus de publicités : `advertiserName`, `ads`), `formats` et `platforms`. Ses champs de date (`oldestStartDate`, `newestStartDate`, `medianActiveDays`, `launchesByWeek` et `longestRunning`) restent vides ou valent `null`, car les cartes ne portent aucune date.
* Une recherche sans publicité correspondante se termine avec `ads` vide et un `summary` de `0` publicité.

## Ce que la bibliothèque conserve

* La création, l’annonceur et le payeur de chaque publicité sont disponibles pour tous les pays.
* Les dates de diffusion, la fourchette d’impressions, la part des impressions par pays et le ciblage ne sont disponibles que pour les publicités diffusées dans l’UE.
* La bibliothèque conserve les publicités environ 12 mois, et son filtre de dates n’accepte que la dernière année.

## Ouvrir une publicité

`action` `ad` ouvre la publicité avec le `libraryId` que vous envoyez, issu d’une recherche ou de l’adresse de la Bibliothèque publicitaire `/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` contient les champs d’une carte de recherche avec le texte complet, plus `advertiserId`, `advertiserUrl`, `advertiserType` (`company` ou `person`), `payer` (qui a payé la publicité), `linkUrl`, `landingDomain`, `ctaText`, `startDate`, `endDate`, `activeDays`, `impressions`, `targeting` et `reachedCountries`.
* `impressions` est la fourchette que publie la bibliothèque (`min`, `max`). `targeting` liste les langues et les lieux que l’annonceur a inclus ou exclus (`language`, `location`) et les paramètres de ciblage (`parameters` : `parameter`, `targeted`, `excluded`). Les dates, `impressions`, `targeting` et `reachedCountries` valent `null` pour une publicité qui n’a pas été diffusée dans l’UE, comme la publicité Adobe `1698237666`. Le payeur et l’annonceur figurent pour toutes les publicités.
* `videos` liste chaque vidéo avec `url` (le fichier au débit le plus élevé), `files` (chaque mp4 : `url`, `type`, `bitrate`) et `previewUrl`. Une publicité en carrousel ajoute `cards` (`title`, `imageUrl`) et une publicité de type document ajoute `document` (son titre, son nombre de pages et les couvertures des pages).
* `advertiser` est la page derrière la publicité : `advertiserId`, `advertiserName`, `url`, `type` et `logoUrl`.
* `transparency` vaut `null` pour une publicité non diffusée dans l’UE. Pour une publicité diffusée dans l’UE, il contient `impressions`, `impressionsText` (le texte de la bibliothèque, comme `50k-100k`) et `reachByCountry`, la part des impressions dans chaque pays (`country`, `countryCode`, `share`, `shareText`), y compris hors de l’UE.
* `variants` liste les autres versions de la publicité lorsque la bibliothèque en montre plus d’une, et vaut `null` sinon.
* Les URL des médias des créations restent ouvertes pendant des années. Les URL des cartes d’un carrousel expirent après environ une semaine, et les logos des annonceurs après environ deux semaines et demie. Enregistrez les fichiers dont vous avez besoin.
* Un `libraryId` pour lequel la bibliothèque n’a aucune publicité échoue avec `PAGE_UNAVAILABLE`.

## Tarif

Une recherche réserve 0.5 crédit pour 30 publicités que demande son `limit`, et facture 0.5 crédit pour 30 publicités renvoyées, avec un minimum de 0.5 crédit. La recherche par défaut de 30 publicités coûte 0.5 crédit, et une recherche avec `limit` 120 réserve 2 crédits. `ad` coûte 0.5 crédit. Seules les requêtes terminées sont facturées.

## Voir aussi

* [Bibliothèques publicitaires comparées](https://docs.querying.ai/fr/engines/ad-libraries.md)
* [Bibliothèque publicitaire de Meta](https://docs.querying.ai/fr/engines/meta-ad-library.md)
* [Vue d’ensemble des moteurs](https://docs.querying.ai/fr/engines/overview.md)
* [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md)


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