# Anúncios do LinkedIn

> Anúncios do LinkedIn: Busca na biblioteca de anúncios do LinkedIn por anunciante ou palavra-chave.

URL: https://apicultura.app/ferramentas/linkedin-biblioteca-anuncios/
Atualizado em 05/11/2026 (2026-11-05).

## O que é Anúncios do LinkedIn na APIcultura

Acesse Anúncios do LinkedIn pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Busca na biblioteca de anúncios do LinkedIn por anunciante ou palavra-chave. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Anúncios](/catalogo/?cat=anuncios). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `linkedin-anuncios-buscar` | Buscar anúncios | R$ 0,02 | `POST /v1/call/linkedin-anuncios-buscar` |
| `linkedin-anuncios-do-anunciante` | Anúncios de um anunciante | R$ 0,15 | `POST /v1/call/linkedin-anuncios-do-anunciante` |
| `linkedin-anuncio-detalhe` | Detalhe de um anúncio | R$ 0,02 | `POST /v1/call/linkedin-anuncio-detalhe` |
| `linkedin-anuncios-por-palavra` | Anúncios por palavra-chave (alternativa) | R$ 0,10 | `POST /v1/call/linkedin-anuncios-por-palavra` |
| `linkedin-anuncios-por-empresa` | Anúncios por empresa (alternativa) | R$ 0,10 | `POST /v1/call/linkedin-anuncios-por-empresa` |

### Buscar anúncios (`linkedin-anuncios-buscar`)

Busca anúncios do LinkedIn por palavra-chave. Preço: R$ 0,02 por chamada.

- `company` (string, opcional), ex.: `microsoft`
- `companyId` (string, opcional)
- `countries` (string, opcional)
- `endDate` (string, opcional)
- `keyword` (string, opcional)
- `paginationToken` (string, opcional)
- `startDate` (string, opcional)

### Schema de entrada de linkedin-anuncios-buscar

```json
{
  "required": [],
  "properties": {
    "company": {
      "type": "string",
      "maxLength": 2000
    },
    "companyId": {
      "type": "string",
      "maxLength": 2000
    },
    "countries": {
      "type": "string",
      "maxLength": 2000
    },
    "endDate": {
      "type": "string",
      "maxLength": 2000
    },
    "keyword": {
      "type": "string",
      "maxLength": 2000
    },
    "paginationToken": {
      "type": "string",
      "maxLength": 2000
    },
    "startDate": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Anúncios de um anunciante (`linkedin-anuncios-do-anunciante`)

Biblioteca de anúncios de uma empresa no LinkedIn. Preço: R$ 0,15 por chamada.

- `limit` (integer, opcional, mín. 1, máx. 20), ex.: `3`
- `url` (string, obrigatório), ex.: `https://www.linkedin.com/company/stripe`

### Schema de entrada de linkedin-anuncios-do-anunciante

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Detalhe de um anúncio (`linkedin-anuncio-detalhe`)

Detalhes de um anúncio do LinkedIn. Preço: R$ 0,02 por chamada.

- `url` (string, obrigatório), ex.: `https://www.linkedin.com/ad-library/detail/1487405616`

### Schema de entrada de linkedin-anuncio-detalhe

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Anúncios por palavra-chave (alternativa) (`linkedin-anuncios-por-palavra`)

Busca anúncios do LinkedIn por palavra-chave. Preço: R$ 0,10 por chamada.

- `keyword` (string, obrigatório), ex.: `webinar`
- `country` (string, opcional), ex.: `US`
- `dateOption` (string, opcional)
- `continuation_token` (string, opcional)

### Schema de entrada de linkedin-anuncios-por-palavra

```json
{
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 2000
    },
    "country": {
      "type": "string",
      "maxLength": 2000
    },
    "dateOption": {
      "type": "string",
      "maxLength": 2000
    },
    "continuation_token": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Anúncios por empresa (alternativa) (`linkedin-anuncios-por-empresa`)

Anúncios do LinkedIn de uma empresa. Preço: R$ 0,10 por chamada.

- `company_domain` (string, obrigatório), ex.: `hubspot.com`
- `linkedin_page_id` (string, opcional)
- `continuation_token` (string, opcional)
- `extract` (string, opcional)
- `live_ads` (boolean, opcional, padrão false)

### Schema de entrada de linkedin-anuncios-por-empresa

```json
{
  "required": [
    "company_domain"
  ],
  "properties": {
    "company_domain": {
      "type": "string",
      "maxLength": 2000
    },
    "linkedin_page_id": {
      "type": "string",
      "maxLength": 2000
    },
    "continuation_token": {
      "type": "string",
      "maxLength": 2000
    },
    "extract": {
      "type": "string",
      "maxLength": 2000
    },
    "live_ads": {
      "type": "boolean"
    }
  }
}
```

## Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta `call` com o slug do endpoint e a entrada:

```json
{ "name": "call", "arguments": { "slug": "linkedin-anuncios-buscar", "input": {"company":"microsoft"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/linkedin-anuncios-buscar \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company":"microsoft"}'
```

## Formato da resposta, preço e limites

A resposta é JSON com `data` (o resultado do endpoint) e `meta` (inclui `cost_brl`, o valor cobrado). Preço deste endpoint: R$ 0,02 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use `max_cost_brl` para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

## Experimente

Teste no playground interativo: [Anúncios do LinkedIn no playground](/ferramentas/ferramenta.html?slug=linkedin-biblioteca-anuncios). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Anúncios do LinkedIn é marca de seus respectivos donos, citada apenas para identificar a integração.