[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [LinkedIn ad search](https://spiral.ai/integrations/windsurf/linkedin-ad-search)

# How to Use LinkedIn ad search in Windsurf

Find LinkedIn ads with their copy, format, advertiser, media links, and available targeting and impression details. Use it to compare company messaging, research offers, or collect examples around a topic.

|  |  |
| --- | --- |
| Model | LinkedIn ad search |
| 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 search in Windsurf

- Use LinkedIn ad search to collect Salesforce ads for the United States from the last 30 completed days. Follow all result pages and add an internal report to this project with ad IDs, headlines, formats, and source links.
- Use LinkedIn ad search to find Microsoft ads mentioning AI. Build a table in this project that groups the returned headlines by theme and links each row to its ad.
- Use LinkedIn ad search to collect HubSpot ads and add a report to this project grouping available destination URLs by domain and path.
- Use LinkedIn ad search to retrieve Adobe ads and build a project view that filters the results by advertiser and ad format, with links to the original ads.
- Use LinkedIn ad search to retrieve SAP ads for Germany from the last 30 completed days. Add a table to this project showing available targeting disclosures and estimated impressions.

## How to set up LinkedIn ad search in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 search**: 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-ads-search",
    "input": {
      "company": "microsoft"
    }
  }'
```

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

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

## LinkedIn ad search tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| company |  | — | The company name to search for. 'Microsoft' for example |
| endDate |  | — | End date in YYYY-MM-DD format. Must be used with startDate and cannot be today or a future date. |
| keyword |  | — | The keyword to search for |
| companyId |  | — | The company id to search for |
| countries |  | — | Comma separated list of countries. Example: US,CA,MX |
| startDate |  | — | Start date in YYYY-MM-DD format. Must be used with endDate and cannot be earlier than the date one year ago. |

## What can you do with LinkedIn ad search in Windsurf?

Build a searchable competitor-ad report from LinkedIn copy, formats, advertiser identities, and creative links. A coding agent can add pagination, deduplicate ad IDs, and turn the results into tables in your project.

### Compare competitor messaging

Collect Salesforce and HubSpot ads, group their headlines by customer problem, and compare the promises each company makes.

### Prepare a creative brief

Find Microsoft ads about AI, separate examples by ad format, and summarize the hooks and calls to action for a writing brief.

### Review regional messaging

Compare SAP ads returned for Germany and the United States to identify differences in wording, offers, and creative formats.

### Watch for newly observed ads

Compare Adobe ad IDs across weekly searches and report newly observed headlines, formats, and offers with links to the ads.

### Research EU audience targeting

Review the targeting disclosures available for Salesforce ads targeted in Germany and summarize the professional audiences described.

### Build an offer inventory

Search HubSpot ads and organize the copy into webinars, reports, demos, and product announcements, retaining an ad link for each example.

### Analyze destination patterns

Collect available destination URLs from Salesforce ads and group them by domain and page path to see where different offers send readers.

## Overview

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

## LinkedIn ad search in other agents

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

## More Windsurf guides

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

## Questions about LinkedIn ad search in Windsurf

**Can Windsurf use LinkedIn ad search?**

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

**How much does LinkedIn ad search cost in Windsurf?**

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 Windsurf plan is separate.

**Do I need a ScrapeCreators account to use LinkedIn ad search in Windsurf?**

No. Spiral runs LinkedIn ad search 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 search in Windsurf?**

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

**Does Windsurf wait while LinkedIn ad search runs?**

LinkedIn ad search runs in the background. Windsurf 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. An older creative can therefore still appear if it received impressions within that window.

**How fresh is the data?**

Ads typically appear shortly after their first impression. LinkedIn calculates Ad Library analytics daily after upstream data becomes available.

**Do all ads include targeting and impression details?**

LinkedIn provides these additional disclosures for ads targeted in the European Union. Impression totals are estimates, and country percentages are rounded to the nearest percent.

**Why are some ad details hidden?**

For restricted ads, LinkedIn hides the ad preview, advertiser name, and payer name to comply with the law.

**Does one search return every matching ad?**

Search results support pagination. The documented response includes a continuation token, a last-page indicator, and a total ad count, so the first response can be only part of the results.

