# Run LinkedIn retargeting from your terminal.

Adwarp is an open-source MCP server and CLI that points your LinkedIn campaigns at the website, video and engagement audiences you already have. Ask once to swap in fresh creative or keep converted accounts out, and new ads land as drafts.

## What you can ask.

Real requests, answered from your terminal.

### Swap fresh creative into the retargeting campaign.

```text
> Swap fresh creative into the retargeting campaign.
adwarp.performance_trend retargeting ads, weekly: fatigue
adwarp.create_image_ad new image and copy, same landing page: DRAFT
New ad drafted beside the tired ones. Switch it on and pause the old ones?
```

### Add our website visitors to the retargeting ad group.

```text
> Add our website visitors to the retargeting ad group.
adwarp.search_targeting "website visitors": 1 match
adwarp.update_campaign + website visitors, dry run: preview
adwarp.update_campaign + website visitors: updated
Website visitors added. Your standing exclusions stay in place.
```

### Keep accounts that already converted out of retargeting.

```text
> Keep accounts that already converted out of retargeting.
adwarp.search_targeting audienceMatchingSegments "customers": 1 match
adwarp.update_campaign exclude customers, dry run: preview
Ready to exclude your customer list. Apply it?
```

### Add the event attendees to retargeting the morning after the event.

```text
> Add the event attendees to retargeting the morning after the event.
adwarp.update_campaign + event attendees, dry run: preview
One-time job set for 9:00 the day after. It applies this same change then.
```

## How it works.

1. Find your audiences. Search the website, video and engagement audiences you built in Campaign Manager by name.
2. Target or exclude. Add them to an ad group's targeting, or keep converted accounts out, with a preview first.
3. Refresh the creative. Draft new ads beside the tired ones, and switch over when you're ready.

## Why it gets better results.

### Fresh creative

Swapping creative is 1 ask, so it happens before the same people tire of the same ad.

### No spend on converts

Exclusions keep budget off accounts that already converted.

### Audiences on time

A scheduled job adds a new audience on the day it's ready, without anyone remembering to.

## Questions, answered.

### Do I need the Insight Tag?

For website visitors, yes. LinkedIn builds that audience from the Insight Tag on your site. Video, lead form, company page and event audiences don't need it.

### How big does a retargeting audience need to be?

About 300 members, or LinkedIn won't serve it. Check the size in Campaign Manager, since estimates for retargeting audiences can read 0.

### Can I exclude people who already converted?

Yes. Upload your customers as a matched audience, or build one from Salesforce, and exclude it from the retargeting ad group. Your standing exclusions stay in place whenever Adwarp changes targeting.

### Which retargeting audiences can I use?

The 5 kinds LinkedIn offers. You build them in Campaign Manager, then target or exclude them from your terminal.

| Audience | Who is in it |
| --- | --- |
| Website visitors | People who visited your site, tracked by the Insight Tag |
| Video viewers | People who watched your video ads |
| Lead form openers | People who opened your lead gen form |
| Company page visitors | People who visited your LinkedIn Page |
| Event attendees | People who signed up for your LinkedIn event |

### Which tools and commands does it use?

6 MCP tools and 3 CLI commands, with what each one does.

| Tool | What it does |
| --- | --- |
| `search_targeting` | Find your retargeting audiences by name |
| `list_facet_entities` | Browse the values of a targeting facet |
| `update_campaign` | Target or exclude an audience, with a dry run first |
| `create_image_ad` | Draft fresh creative for the same ad group |
| `update_ad` | Pause the tired ads once the new ones are on |
| `performance_trend` | Spot tired creative in the weekly trend |

CLI:

```bash
npx adwarp campaigns get <campaignId>
npx adwarp campaigns update <campaignId> --targeting '<json>'
npx adwarp report trend campaign <campaignId> -b weekly
```

### What are the limits?

3 things to know before you start.

- You build the retargeting audiences themselves in Campaign Manager.
- Each needs about 300 members before LinkedIn serves it.
- Audience estimates can read 0 for retargeting audiences, so check their real size in Campaign Manager.

## Related

- [Audiences](https://adwarp.dev/linkedin-ads/audiences): Upload the lists you exclude
- [Optimization](https://adwarp.dev/linkedin-ads/optimization): Pause rules, pacing and lift
- [Reporting](https://adwarp.dev/linkedin-ads/reporting): How did retargeting do last month?

Unofficial. Not affiliated with or endorsed by LinkedIn or Google.

Canonical page: https://adwarp.dev/linkedin-ads/retargeting
Last updated: 2026-10-18
