[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Google keyword ideas](https://spiral.ai/integrations/codex/google-keyword-ideas)

# How to Use Google keyword ideas in Codex

Returns keywords in the same product or service categories as your seeds, with search volume, CPC, and advertiser competition. Use it to explore related topics beyond phrases containing your seed words.

|  |  |
| --- | --- |
| Model | Google keyword ideas |
| Available through | Alexandria |
| Category | SEO |
| Price | Up to $0.0576147 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Google keyword ideas in Codex

- Use Google keyword ideas with 'espresso machine' and 'coffee grinder' for the United States, in English. Compare returned terms and search volumes with our category pages and propose five additions.
- Use Google keyword ideas to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Google keyword ideas and tell me what changed since last week.
- Check Google keyword ideas and summarize what you find in three bullet points.
- Pull the newest data from Google keyword ideas and give me the result as a table.

## How to set up Google keyword ideas in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
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.

```bash
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.

```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 keyword ideas**: 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": "alexandria",
    "model": "dataforseo/keywords/ideas",
    "input": {
      "keywords": [
        "<keywords>"
      ],
      "location_code": 1
    }
  }'
```

Then paste one of the prompts above: Codex finds Google keyword ideas on Spiral, shows the price and runs it.

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

## Google keyword ideas tools and prices

- [DataForSEO · Keyword ideas](https://spiral.ai/tools/alexandria/dataforseo/keywords/ideas) (Alexandria): Up to $0.0576147 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 700 | 100 | Items to return, 1 to 700. DataForSEO allows 1000 (its default is 700); this connector stops at 700 so a call stays within 100 credits. Omitted, 100 is sent. |
| offset | 0 to … | — | Items to skip, for the next page. Default 0. |
| filters |  | — | JSON array of filter conditions in the DataForSEO syntax, at most 8, such as ["keyword_info.search_volume",">",100]. |
| order_by |  | — | Up to 3 sorting rules, each field,direction, such as keyword_info.search_volume,desc. |
| offset_token |  | — | Token from the previous response, for results past 10,000. |
| language_code |  | — | Language code, such as en. Use this or language_name. |

## What can you do with Google keyword ideas in Codex?

Turn the project's content inventory into a keyword research table with DataForSEO demand, difficulty, or intent data. Match returned phrases to existing pages to propose content updates and new briefs.

### Choose the next articles to commission

Expand running shoe topics with category ideas and longer phrases. Compare search demand and organic difficulty, then use intent labels to separate buying guides from informational articles.

### Plan ecommerce category pages

Research terms around espresso machines, including related product categories and specific buying queries. Use demand, difficulty, and search intent to propose category pages and supporting guides.

### Compare keyword opportunities across markets

Research English-language standing desk queries separately for the United States and United Kingdom. Compare discovered phrases, demand, and country-specific difficulty, then classify the shortlisted terms by intent.

### Prioritize existing content updates

Take the topics from an existing cycling guide library and look for related searches and more specific phrases. Combine demand, difficulty, and intent with your content inventory to recommend which pages to expand first.

### Schedule seasonal content

Discover searches around Christmas decorations, then inspect monthly search history for the shortlisted terms. Use the observed seasonal pattern to propose publication months.

### Prepare a paid search research brief

Find category terms and detailed searches around accounting software. Compare demand and advertiser competition, then use intent labels to identify terms worth reviewing for an acquisition campaign.

### Build a help center topic backlog

Expand spreadsheet topics into related subjects and detailed questions. Classify informational searches and compare their organic difficulty before proposing tutorial briefs.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Google keyword ideas in other agents

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

## More Codex guides

- [Google keyword difficulty](https://spiral.ai/integrations/codex/google-keyword-difficulty)
- [Google keyword search intent](https://spiral.ai/integrations/codex/google-keyword-search-intent)
- [Google company ads](https://spiral.ai/integrations/codex/google-company-ads)
- [Google long-tail keywords](https://spiral.ai/integrations/codex/google-long-tail-keywords)
- [Google Trends trending searches](https://spiral.ai/integrations/codex/google-trends-trending-searches)
- [Google organic search rankings](https://spiral.ai/integrations/codex/google-organic-search-rankings)

## Questions about Google keyword ideas in Codex

**Can Codex use Google keyword ideas?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Google keyword ideas like any built-in tool.

**How much does Google keyword ideas cost in Codex?**

Up to $0.0576147 per run. 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 an Alexandria account to use Google keyword ideas in Codex?**

No. Spiral runs Google keyword ideas on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Google keyword ideas in Codex?**

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

**Does Codex wait while Google keyword ideas runs?**

Google keyword ideas runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**How fresh is DataForSEO's keyword data?**

The keyword database follows a monthly refresh cycle tied to Google Ads. Search results used by DataForSEO Labs refresh on a separate cycle of 30 to 90 days, depending on the query and location.

**Are search volumes exact counts for each phrase?**

Google groups similar keywords and can report their combined search volume. That makes these figures unsuitable for measuring small differences between closely related spellings or phrases.

**Does competition mean organic ranking difficulty?**

Google Ads competition measures competition among advertisers in paid search. Organic difficulty is a separate DataForSEO score from 0 to 100 for reaching Google's top 10 organic results.

**How much monthly history is available?**

Google Ads keyword search volume offers up to four years of history. Keyword discovery results include a shorter history covering the previous 12 months.

**Does DataForSEO cover every country?**

No. DataForSEO says locations in Russia and Belarus are no longer supported across its services.

