Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Social Media

How to Use LinkedIn ad details in Gemini CLI

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.

Prompts to try with LinkedIn ad details in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

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.

LinkedIn ad detailsGemini CLI
Try asking
  • 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 Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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.

    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.

    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: Gemini CLI finds LinkedIn ad details on Spiral, shows the price and runs it.

LinkedIn ad details providers and prices

Spiral runs LinkedIn ad details through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
LinkedIn Ad Library · Ad Details
scrapecreators/linkedin-ad

What can you do with LinkedIn ad details in Gemini CLI?

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.

Questions about LinkedIn ad details in Gemini CLI

Can Gemini CLI use LinkedIn ad details?

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

How much does LinkedIn ad details cost in Gemini CLI?

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

Do I need a ScrapeCreators account to use LinkedIn ad details in Gemini CLI?

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 Gemini CLI?

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

Does Gemini CLI wait while LinkedIn ad details runs?

LinkedIn ad details runs in the background. Gemini CLI 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.

Get started

Start using LinkedIn ad details in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options