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

# LinkedIn Ads

> Extract LinkedIn ad details, ad copy, media URL, and call-to-action buttons from Ad Library URLs

`$1 / 1k ads`

Extract LinkedIn ad details, ad copy, media URL, and call-to-action buttons from Ad Library URLs

## Endpoint

`POST /api/v1/agents/linkedin/ads-library/run`

## Parameters

<ParamField body="urls" type="array" required>
  **List** · LinkedIn Ad Library URLs (or company URLs). One per line.
</ParamField>

<ParamField body="maxResults" type="integer" default={50}>
  **Number** · Ads per input URL. Use 0 for all.
</ParamField>

## Response columns

| Field            | Display name    | Type |
| ---------------- | --------------- | ---- |
| `advertiserUrl`  | Advertiser URL  | url  |
| `adUrl`          | Ad URL          | url  |
| `advertiser`     | Advertiser      | text |
| `advertiserLogo` | Advertiser Logo | url  |
| `adBody`         | Ad Body         | text |
| `headline`       | Headline        | text |
| `format`         | Format          | text |
| `images`         | Images          | text |
| `video`          | Video           | url  |
| `document`       | Document        | url  |
| `slideImage`     | Slide Image     | url  |
| `clickUrl`       | Click URL       | url  |
| `ctas`           | CTAs            | text |
| `paidBy`         | Paid By         | text |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/linkedin/ads-library/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "urls": [
        {
          "url": "https://www.linkedin.com/ad-library/search?accountOwner=nvidia&countries=BR&dateOption=last-30-days"
        }
      ],
      "maxResults": 10
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/linkedin/ads-library/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "urls": [
          {
              "url": "https://www.linkedin.com/ad-library/search?accountOwner=nvidia&countries=BR&dateOption=last-30-days"
          }
      ],
      "maxResults": 10
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "advertiserUrl": "https://www.linkedin.com/company/40981439",
      "adUrl": "https://www.linkedin.com/ad-library/detail/1211407483",
      "advertiser": "NVIDIA Brasil",
      "advertiserLogo": "https://media.licdn.com/dms/image/v2/D560BAQEQxQYINJmKww/company-logo_100_100/company-logo_100_100/0/1724882363637/nvidiabrasil_logo?e=1779321600&v=beta&t=GQhxysv2YqEDNHl1x98LHwJdzAgArKjJBUXgesLfojo",
      "adBody": "Neste webinar, voc\u00ea ter\u00e1 uma vis\u00e3o geral dos NVIDIA\u00a0NIMs\u00a0e de como eles simplificam a implanta\u00e7\u00e3o, o\u00a0serving\u00a0e o escalonamento de modelos de linguagem em ambientes\u00a0on-premises\u00a0e em nuvem. Tamb\u00e9m ser\u00e1 abordado como funciona o licenciamento da tecnologia e os principais cen\u00e1rios de uso.\n\nO evento tamb\u00e9m apresenta alguns dos principais modelos da NVIDIA, como o NVIDIA Llama Nemotron, destacando como esses LLMs open source, combinados com NIMs, permitem infer\u00eancia de baixa lat\u00eancia, observabilidade e uso otimizado de GPUs para solu\u00e7\u00f5es de IA generativa em n\u00edvel corporativo.\n\n\ud83d\udcc5 28 de abril \u00e0s 17h (hor\u00e1rio de Bras\u00edlia).\n\nInscreva-se aqui: https://lnkd.in/dckqHuyA   \n\n\n#nvidia #llm #generativeai #ia #machinelearning #datascience",
      "headline": null,
      "format": "SINGLE_IMAGE",
      "images": "https://media.licdn.com/dms/image/v2/D4D22AQGZb-07XPAGlg/feedshare-shrink_2048_1536/B4DZ0.tFRbIcAg-/0/1774873499072?e=2147483647&v=beta&t=HuY9qA11vGF0F_m2x6AeG82gdH5MQ5dg0kAqmRXgpE8",
      "video": null,
      "document": null,
      "slideImage": null,
      "clickUrl": null,
      "ctas": [],
      "paidBy": "NA\u00c7\u00c3O DIGITALSOLUTIONS LTDA"
    }
  ]
}
```