[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [LinkedIn ad details](https://spiral.ai/integrations/codex/linkedin-ad-details)

# How to Use LinkedIn ad details in Codex

Fetch a specific LinkedIn ad’s text, format, advertiser, and available media from its Ad Library detail URL. Use it to inspect a known creative, with targeting and impression details where LinkedIn discloses them.

|  |  |
| --- | --- |
| Model | LinkedIn ad details |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with LinkedIn ad details in Codex

- Use LinkedIn ad details for https://www.linkedin.com/ad-library/detail/1629532086 and add its advertiser, format, and creative text to this project’s comparison view.
- Use LinkedIn ad details for CodeAnt AI ad 1629532086 and save the returned creative text and available media links as a JSON fixture in this project.
- Use LinkedIn ad details for https://www.linkedin.com/ad-library/detail/1629532086 and build a component that displays the returned media without assuming multiple resolutions.
- Use LinkedIn ad details for CodeAnt AI ad 1629532086 and add a table of disclosed country impression shares to the existing report page.
- Use LinkedIn ad details for https://www.linkedin.com/ad-library/detail/1629532086 and write an internal creative review from the returned text in this repository’s report format.

## How to set up LinkedIn ad details in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run LinkedIn ad details**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "scrapecreators",
    "model": "scrapecreators/linkedin-ad",
    "input": {
      "url": "https://www.linkedin.com/ad-library/detail/666281156"
    }
  }'
```

Then paste one of the prompts above: Codex finds LinkedIn ad details on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## LinkedIn ad details tools and prices

- [LinkedIn Ad Library · Ad Details](https://spiral.ai/tools/scrapecreators/scrapecreators/linkedin-ad) (ScrapeCreators): Up to $0.0013 per run.

## What can you do with LinkedIn ad details in Codex?

Build an ad comparison view from LinkedIn creative text, advertiser names, formats, and available media. A coding agent can fit the returned data into your project and show disclosed EU targeting and impression figures alongside each creative.

### Compare competitor messaging

Retrieve known business ad URLs and compare their text, offers, and formats to prepare a competitive messaging brief.

### Prepare a creative review

Turn an ad’s returned text and available media into a review of its main claim, supporting evidence, and intended business audience.

### Check geographic delivery

For EU-targeted ads with disclosures, compare country impression shares with the advertiser’s stated geographic targeting.

### Review audience targeting

Summarize disclosed targeting criteria for selected business ads to compare the audiences advertisers intend to reach.

### Monitor selected creatives

Revisit known ad detail URLs on a daily schedule and report changes in returned text or disclosed impression figures.

### Build an internal ad comparison tool

Populate a project’s comparison view with ad text, advertiser names, formats, and links to available media.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Codex guides](https://spiral.ai/integrations/codex)

## LinkedIn ad details in other agents

- [Amp](https://spiral.ai/integrations/amp/linkedin-ad-details)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/linkedin-ad-details)
- [Claude](https://spiral.ai/integrations/claude-desktop/linkedin-ad-details)
- [Claude Code](https://spiral.ai/integrations/claude-code/linkedin-ad-details)
- [Cline](https://spiral.ai/integrations/cline/linkedin-ad-details)
- [Cursor](https://spiral.ai/integrations/cursor/linkedin-ad-details)
- [Devin](https://spiral.ai/integrations/devin/linkedin-ad-details)
- [dots](https://spiral.ai/integrations/dots/linkedin-ad-details)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/linkedin-ad-details)
- [Gemini](https://spiral.ai/integrations/gemini/linkedin-ad-details)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/linkedin-ad-details)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/linkedin-ad-details)
- [goose](https://spiral.ai/integrations/goose/linkedin-ad-details)
- [Grok](https://spiral.ai/integrations/grok/linkedin-ad-details)
- [Grok Build](https://spiral.ai/integrations/grok-build/linkedin-ad-details)
- [Hermes](https://spiral.ai/integrations/hermes/linkedin-ad-details)
- [Instinct](https://spiral.ai/integrations/instinct/linkedin-ad-details)
- [Manus](https://spiral.ai/integrations/manus/linkedin-ad-details)
- [Muse](https://spiral.ai/integrations/muse/linkedin-ad-details)
- [Muse Code](https://spiral.ai/integrations/muse-code/linkedin-ad-details)
- [n8n](https://spiral.ai/integrations/n8n/linkedin-ad-details)
- [Notion](https://spiral.ai/integrations/notion/linkedin-ad-details)
- [OpenClaw](https://spiral.ai/integrations/openclaw/linkedin-ad-details)
- [opencode](https://spiral.ai/integrations/opencode/linkedin-ad-details)
- [Perplexity](https://spiral.ai/integrations/perplexity/linkedin-ad-details)
- [Raycast](https://spiral.ai/integrations/raycast/linkedin-ad-details)
- [VS Code](https://spiral.ai/integrations/vscode/linkedin-ad-details)
- [Windsurf](https://spiral.ai/integrations/windsurf/linkedin-ad-details)
- [Zapier](https://spiral.ai/integrations/zapier/linkedin-ad-details)

## More Codex guides

- [LinkedIn Web Get post comments](https://spiral.ai/integrations/codex/linkedin-web-get-post-comments)
- [LinkedIn ad search](https://spiral.ai/integrations/codex/linkedin-ad-search)
- [LinkedIn Web Get company's posts](https://spiral.ai/integrations/codex/linkedin-web-get-company-s-posts)
- [LinkedIn comment reactions](https://spiral.ai/integrations/codex/linkedin-comment-reactions)
- [LinkedIn Search Posts](https://spiral.ai/integrations/codex/linkedin-search-posts)
- [LinkedIn comment replies](https://spiral.ai/integrations/codex/linkedin-comment-replies)

## Questions about LinkedIn ad details in Codex

**Can Codex use LinkedIn ad details?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run LinkedIn ad details like any built-in tool.

**How much does LinkedIn ad details cost in Codex?**

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need a ScrapeCreators account to use LinkedIn ad details in Codex?**

No. Spiral runs LinkedIn ad details on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up LinkedIn ad details in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while LinkedIn ad details runs?**

LinkedIn ad details runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**How far back does LinkedIn’s Ad Library go?**

Ads remain available for one year after their last impression. That makes retention depend on when an ad last received delivery, rather than when it was created.

**How fresh are the impression figures?**

LinkedIn calculates Ad Library analytics daily after the upstream data becomes available. Impression figures therefore follow a daily processing cycle.

**Does every ad disclose targeting and impressions?**

LinkedIn specifies additional targeting and impression disclosures for ads targeted in the European Union. Those disclosures include estimated total impressions and a breakdown by country.

**How precise are the country impression percentages?**

LinkedIn rounds country impression shares to the nearest whole percent. Use those figures for broad geographic comparisons rather than fractional-percentage analysis.

**Can I get every image or thumbnail resolution?**

The endpoint returns available media, but LinkedIn may expose only one image or thumbnail size. Multiple resolutions are not guaranteed.

