How to Use LinkedIn ad keyword search in Windsurf
Returns a page of LinkedIn library ads matching a keyword, including advertiser details, copy, headlines, and creative assets. Use it to discover advertisers discussing a product or topic.
Prompts to try with LinkedIn ad keyword search in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use LinkedIn ad keyword search for webinar in the United States over the last 30 days, then create a CSV of advertiser names, headlines, copy, and image URLs.
Use LinkedIn ad keyword search for cybersecurity in Germany over the last 30 days and build a local viewer for returned advertiser names, ad copy, and creative links.
Use LinkedIn ad keyword search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from LinkedIn ad keyword search and tell me what changed since last week.
Check LinkedIn ad keyword search and summarize what you find in three bullet points.
How to set up LinkedIn ad keyword search in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - 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.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run LinkedIn ad keyword search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "adyntel/linkedin/keyword-search", "input": { "keyword": "<keyword>" } }'
Then paste one of the prompts above: Windsurf finds LinkedIn ad keyword search on Spiral, shows the price and runs it.
LinkedIn ad keyword search providers and prices
Spiral runs LinkedIn ad keyword search through Alexandria. Open a card for today's price, with every fee included.
What can you do with LinkedIn ad keyword search in Windsurf?
Build a searchable review of LinkedIn ad copy and creative assets in your project. Use returned records to compare advertisers, group repeated messages, and link each example to its media.
Compare competitor messaging
Collect ads from named competitors or a shared product topic. Compare headlines and copy to see which benefits each advertiser emphasizes.
Build a creative reference list
Organize returned image and video links by advertiser and message. Give a creative team concrete examples to review before drafting its own campaign.
Review webinar promotions
Find webinar offers in a company's ads or search the topic across advertisers. Compare event headlines, calls to action, and supporting copy.
Monitor changes in advertised offers
Compare repeated searches with earlier results to flag newly observed headlines and offers. Keep the advertiser and creative link beside each change.
Prepare an agency account review
Review a public business's ads or relevant category ads before an account meeting. Summarize messaging themes and creative formats using returned examples.
Find repeated creative concepts
Compare headlines, copy, and media URLs across returned ads. Separate repeated executions from distinct concepts when assembling a campaign review.
More on LinkedIn ad keyword search and Windsurf
Overview
LinkedIn ad keyword search in other agents
Questions about LinkedIn ad keyword search in Windsurf
Can Windsurf use LinkedIn ad keyword search?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run LinkedIn ad keyword search like any built-in tool.
How much does LinkedIn ad keyword search cost in Windsurf?
Up to $0.0977704 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 an Alexandria account to use LinkedIn ad keyword search in Windsurf?
No. Spiral runs LinkedIn ad keyword search on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up LinkedIn ad keyword search in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while LinkedIn ad keyword search runs?
LinkedIn ad keyword 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. The library therefore includes ads that have stopped running, alongside more recent activity.
How soon do new ads appear?
LinkedIn says ads typically appear shortly after their first impression. Its help page gives no fixed number of minutes or hours.
Does one response contain every matching ad?
Results are paginated. Use the continuation token to retrieve additional pages before treating the returned ads as the complete result.
Will the retrieved ads always match the displayed total?
Counts and retrievable records can differ. In Adyntel's September 2026 HubSpot test, pagination returned 1,167 ads against a displayed total of 1,409.
Does LinkedIn publish impression data for every ad?
LinkedIn documents estimated total impressions and country breakdowns for EU-targeted ads. That additional library information should not be assumed to appear in every ad search response.
Start using LinkedIn ad keyword search in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


