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

Codex · Social Media

How to Use Google Ad Library Company Ads in Codex

Fetch a company's public Google ad records, including creative IDs, formats, and available first and last shown dates. Use it to compare advertisers' creative catalogs or spot newly observed ads.

Prompts to try with Google Ad Library Company Ads in Codex

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

Use Google company ads for lululemon.com in the US over the past 30 days. Add a CSV export to this project with advertiser ID, creative ID, format, and available first and last shown dates.

Google Ad Library Company AdsCodex
Try asking
  • Use Google company ads for nike.com and adidas.com in the US over the past 90 days. Add a comparison view showing collected unique creatives by format.

  • Use Google company ads for shopify.com in Canada over the past month. Add pagination that preserves the original filters and deduplicates records by advertiser ID and creative ID.

  • Use Google company ads for canva.com in Australia over the past 60 days. Save the returned records in this project's data directory and generate a timeline from available shown dates.

  • Use Google company ads for hubspot.com in the US over the past month. Add a comparison with our previous collection that lists newly observed creative IDs.

How to set up Google Ad Library Company Ads in Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    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.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Google Ad Library Company Ads

    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/google-company-ads",
        "input": {
          "topic": "all"
        }
      }'

Then paste one of the prompts above: Codex finds Google Ad Library Company Ads on Spiral, shows the price and runs it.

Google Ad Library Company Ads providers and prices

Spiral runs Google Ad Library Company Ads through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Google Ad Library · Company Ads
scrapecreators/google-company-ads

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Topicall or political

The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU'

Formattext, image, or video

Ad format to search for.

Platformgoogle_maps, google_play, google_search, google_shopping, or youtube

Platform to search for.

Every API field of Google Ad Library · Company Ads is on its tool page: open its card above.

What can you do with Google Ad Library Company Ads in Codex?

Build a competitor ad inventory that compares Google's public creative IDs, formats, and available run dates. A coding agent can add pagination and collection comparisons to your project.

Competitor creative inventory

Collect public ad records for competing businesses and compare the formats represented in each retrieved catalog.

New creative alerts

Compare successive collections by advertiser ID and creative ID to flag ads first observed since the previous check.

Regional ad comparisons

Compare a company's retrieved ad records across the US, Canada, and Australia to identify creative IDs appearing in each market's results.

Seasonal campaign review

Collect records for a defined holiday period and organize available first and last shown dates into a creative timeline.

Long-running creative shortlist

Rank ads with both dates by the span between first and last shown. Use the shortlist for creative review without treating longevity as evidence of conversions.

Agency research brief

Prepare an advertiser-by-advertiser summary of collected creative counts, formats, and date ranges before a campaign planning meeting.

Questions about Google Ad Library Company Ads in Codex

Can Codex use Google Ad Library Company Ads?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Google Ad Library Company Ads like any built-in tool.

How much does Google Ad Library Company Ads cost in Codex?

$0.0013 per request ($0.0325 with ad details). 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 Google Ad Library Company Ads in Codex?

No. Spiral runs Google Ad Library Company Ads on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up Google Ad Library Company Ads in Codex?

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

Does Codex wait while Google Ad Library Company Ads runs?

Google Ad Library Company Ads runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

Does this include every ad a company has run?

It covers public Google Ad Library records. ScrapeCreators explicitly excludes ads that require signing in, so the results can omit ads visible only after login.

How fresh are the results?

ScrapeCreators says it fetches the latest information available from Google Ad Library when you make a request. That describes retrieval from the library, rather than a guaranteed delay between an ad serving and appearing there.

How many ads come back in one call?

ScrapeCreators' published lululemon.com test returned 40 ads, followed by 40 different creative IDs on the next page. Treat 40 as an observed page size; follow the returned cursor with unchanged filters to collect additional pages.

Can I see a competitor's spend or conversions?

Ordinary commercial Transparency Center records generally do not expose exact spend, CTR, conversions, private bid keywords, or account settings. The available creative records support ad research, but cannot establish campaign profitability.

Why might a first-shown date disappear when I inspect an ad?

ScrapeCreators documents that an individual ad detail response can return a null first-shown date even when the company list has one. Preserve the company-list date when combining those results.

Get started

Start using Google Ad Library Company Ads in Codex

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

Paste this into Codex:

Set up Codex

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