[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [Google Ad Library Company Ads](https://spiral.ai/integrations/muse-code/google-ad-library-company-ads)

# How to Use Google Ad Library Company Ads in Muse Code

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.

|  |  |
| --- | --- |
| Model | Google Ad Library Company Ads |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | $0.0013 per request ($0.0325 with ad details). |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Google Ad Library Company Ads in Muse Code

- 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.
- 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 Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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 Google Ad Library Company Ads**: 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/google-company-ads",
    "input": {
      "topic": "all"
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## Google Ad Library Company Ads tools and prices

- [Google Ad Library · Company Ads](https://spiral.ai/tools/scrapecreators/scrapecreators/google-company-ads) (ScrapeCreators): $0.0013 per request ($0.0325 with ad details).

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| topic | all, political | — | The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU' |
| cursor |  | — | Cursor to paginate through results |
| domain |  | — | The domain of the company |
| format | text, image, video | — | Ad format to search for. |
| region |  | — | The region to search for. Defaults to anywhere |
| end_date |  | — | End date to search for. Format: YYYY-MM-DD |

## What can you do with Google Ad Library Company Ads in Muse Code?

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.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## Google Ad Library Company Ads in other agents

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

## More Muse Code guides

- [Facebook video transcript](https://spiral.ai/integrations/muse-code/facebook-video-transcript)
- [Google Ads advertiser search](https://spiral.ai/integrations/muse-code/google-ads-advertiser-search)
- [Facebook video search](https://spiral.ai/integrations/muse-code/facebook-video-search)
- [Google ad details](https://spiral.ai/integrations/muse-code/google-ad-details)
- [Facebook video and post details](https://spiral.ai/integrations/muse-code/facebook-video-and-post-details)
- [Influencers.club Enrich TikTok creator](https://spiral.ai/integrations/muse-code/influencers-club-enrich-tiktok-creator)

## Questions about Google Ad Library Company Ads in Muse Code

**Can Muse Code use Google Ad Library Company Ads?**

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

**How much does Google Ad Library Company Ads cost in Muse Code?**

$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 Muse Code plan is separate.

**Do I need a ScrapeCreators account to use Google Ad Library Company Ads in Muse Code?**

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 Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while Google Ad Library Company Ads runs?**

Google Ad Library Company Ads runs in the background. Muse Code 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.

