Anúncios do LinkedIn

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

Atualizado em .

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. 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 fazPreço por chamadaRota
linkedin-anuncios-buscarBuscar anúnciosR$ 0,02POST /v1/call/linkedin-anuncios-buscar
linkedin-anuncios-do-anuncianteAnúncios de um anuncianteR$ 0,15POST /v1/call/linkedin-anuncios-do-anunciante
linkedin-anuncio-detalheDetalhe de um anúncioR$ 0,02POST /v1/call/linkedin-anuncio-detalhe
linkedin-anuncios-por-palavraAnúncios por palavra-chave (alternativa)R$ 0,10POST /v1/call/linkedin-anuncios-por-palavra
linkedin-anuncios-por-empresaAnúncios por empresa (alternativa)R$ 0,10POST /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.

Schema de entrada de linkedin-anuncios-buscar

{
  "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.

Schema de entrada de linkedin-anuncios-do-anunciante

{
  "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.

Schema de entrada de linkedin-anuncio-detalhe

{
  "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.

Schema de entrada de linkedin-anuncios-por-palavra

{
  "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.

Schema de entrada de linkedin-anuncios-por-empresa

{
  "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:

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

Exemplo de chamada HTTP

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. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

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