# Keyword Search Volume Scraper - CPC, Difficulty & Ideas (`topapi/keyword-volume-scraper`) Actor

Bulk keyword search volume, CPC (broad, phrase, exact), keyword difficulty, clicks, SERP features and advertisers from SpyFu's keyword database, 32 countries. Keyword ideas and domain keywords too. Filters, monitor mode. No login or API key. $0.90 per 1,000 keywords.

- **URL**: https://apify.com/topapi/keyword-volume-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** SEO tools, Marketing, Developer tools
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.90 / 1,000 keywords

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Keyword Search Volume Scraper do?

Keyword Search Volume Scraper returns **monthly search volume, cost per click (broad, phrase and exact match), keyword difficulty, clicks, SERP features and the advertisers bidding** for every keyword you give it, in bulk. It also finds **keyword ideas** for seed keywords (related keywords, questions, buying-intent keywords, keywords that competing pages and advertisers also target) and lists **the keywords any domain ranks for** in Google.

The numbers come from **SpyFu's public keyword database** (spyfu.com), for **32 countries**. You don't need a SpyFu, Google Ads, Semrush or Ahrefs account, an API key or a login.

- **Bulk:** 100 keywords go to SpyFu in one call. 1,192 keywords took 6.5 seconds in our test run.
- **One price, every metric:** $0.90 per 1,000 keywords. Keywords SpyFu doesn't know are returned free.
- **Filters inside SpyFu's query:** minimum or maximum volume, CPC, difficulty, clicks and word count, and words a keyword must include or exclude.
- **Monitor mode:** a scheduled run delivers only new keywords and keywords whose volume, CPC, difficulty or rank changed, with the previous values.

### What data can you get?

| Group | Fields |
|---|---|
| Volume | `search_volume` (SpyFu monthly average), `live_search_volume` (SpyFu's most recent figure), `search_volume_source` |
| Cost | `cpc` (broad), `cpc_broad`, `cpc_phrase`, `cpc_exact`, estimated monthly ad clicks and ad cost per match type |
| Difficulty and competition | `keyword_difficulty` (0-100), `paid_competitors` (number of advertisers), `ranking_homepages` (homepages in the top 10) |
| Clicks | `monthly_clicks`, `organic_clicks_pct`, `paid_clicks_pct`, `no_click_pct`, `mobile_searches_pct`, `desktop_searches_pct` |
| Search results | `serp_features` (People Also Ask, Images, Maps, Local Teaser Pack, Videos...), `serp_first_result` (domain at #1) |
| Intent | `is_question`, `is_transactional`, `search_intent`, `is_adult`, `word_count` |
| Advertisers | `advertisers_latest` (top 10 domains buying ads last month), `advertisers_latest_count`, `advertisers_month`; with **Advertiser history** on, `advertisers_by_month` for every month SpyFu recorded (usually 12-13) |
| Domain mode | `domain`, `rank`, `rank_change`, `ranking_url`, `seo_clicks`, `seo_clicks_change` |
| Ideas | `seed_keyword`, `idea_type`, `position` |
| Links | `spyfu_url`, `google_search_url`, `term_id` |

### How to use it

1. Paste your keywords into **Keywords**, one per line.
2. Pick the **Country** (32 markets, United States by default).
3. Pick the **Mode**:
   - **Metrics for my keywords** - one row per keyword.
   - **Keyword ideas for my seeds** - up to *Max ideas* per seed and idea type, highest volume first.
   - **Metrics + ideas** - both in one run.
   - **Keywords a domain ranks for** - fill in **Domains**.
4. Optionally add filters, then click **Start**.

#### Input

| Field | What it does | Default |
|---|---|---|
| `keywords` | Keywords (Metrics) or seeds (Ideas), one per line | 3 sample keywords |
| `mode` | `metrics`, `ideas`, `both`, `domain` | `metrics` |
| `domains` | Websites for Domain mode (`ahrefs.com`, a full URL works too) | - |
| `country` | US, UK, CA, AU, NZ, IE, IN, SG, ZA, DE, AT, CH, FR, BE, NL, IT, ES, PT, SE, NO, DK, FI, PL, CZ, TR, UA, BR, MX, AR, CL, VE, JP | `US` |
| `ideaTypes` | `related`, `questions`, `alsoRanksFor`, `alsoBuysAdsFor`, `transactional` | `related` |
| `maxIdeas` | Ideas per seed and idea type (up to 10,000) | 100 |
| `maxDomainKeywords` | Ranked keywords per domain (up to 10,000) | 100 |
| `maxItems` | Stop after this many charged rows | no limit |
| `minVolume` / `maxVolume` | Monthly search volume range | - |
| `minCpc` / `maxCpc` | Broad-match CPC range (USD) | - |
| `minDifficulty` / `maxDifficulty` | Keyword difficulty range (0-100) | - |
| `minClicks` | Minimum monthly clicks | - |
| `minWords` / `maxWords` | Word count range (3+ for long-tail) | - |
| `includeTerms` / `includeAnyTerm` / `excludeTerms` | Words a keyword must (or may) contain, or must not contain | - |
| `includeAdultKeywords` | Keep adult keywords in idea and domain lists | off |
| `sortBy` / `sortOrder` | Order of idea and domain lists: volume, difficulty, CPC, clicks, advertisers, A-Z, SEO clicks, rank | volume, high first |
| `includeAdvertisers` | Add the month-by-month advertiser history | off |
| `includeNotFound` | Free `found: false` rows for keywords SpyFu doesn't know | on |
| `dedupe` | One row per keyword across seeds and idea types | on |
| `monitorMode`, `monitorName`, `changeThresholdPct`, `emitBaseline`, `resetMonitor` | Monitor mode (see below) | off, `default`, 10%, on, off |
| `proxyConfiguration` | Optional proxy; by default the run calls SpyFu directly | - |
| `maxConcurrency` | SpyFu calls in flight | 8 |

Field names from other keyword tools also work through the API: `keywordsText`, `seedKeywords`, `geo`, `location_code` (2840, 2826...), `maxIdeasPerSeed`, `ideasMethod`, `minSearchVolume`, `includeAdultKeywords`.

```json
{
  "keywords": ["coffee maker", "running shoes", "plumber near me"],
  "mode": "metrics",
  "country": "US"
}
```

Keyword ideas with filters:

```json
{
  "keywords": ["running shoes"],
  "mode": "ideas",
  "ideaTypes": ["related", "questions"],
  "maxIdeas": 500,
  "minVolume": 1000,
  "maxDifficulty": 30,
  "excludeTerms": ["nike"]
}
```

### Output

A real row from a test run (`best crm software`, United States):

```json
{
  "keyword": "best crm software",
  "type": "metrics",
  "country": "US",
  "country_name": "United States",
  "search_volume": 1200,
  "search_volume_source": "spyfu_monthly",
  "spyfu_search_volume": 1200,
  "live_search_volume": 1600,
  "cpc": 30.09,
  "cpc_broad": 30.09,
  "cpc_phrase": 33.53,
  "cpc_exact": 32.64,
  "keyword_difficulty": 40,
  "monthly_clicks": 840,
  "organic_clicks_pct": 83.6,
  "paid_clicks_pct": 16.4,
  "no_click_pct": 27.2,
  "mobile_searches_pct": 19.6,
  "desktop_searches_pct": 80.4,
  "monthly_ad_clicks_broad": 115,
  "monthly_ad_clicks_phrase": 51.6,
  "monthly_ad_clicks_exact": 48,
  "monthly_ad_cost_broad": 3454.8,
  "monthly_ad_cost_phrase": 1726.8,
  "monthly_ad_cost_exact": 1565.4,
  "paid_competitors": 127,
  "ranking_homepages": 0,
  "serp_features": ["People Also Ask"],
  "serp_first_result": "solutionsreview.com",
  "is_question": false,
  "is_transactional": true,
  "is_adult": false,
  "search_intent": "transactional",
  "word_count": 3,
  "advertisers_latest": ["zoho.com", "universell.us", "vtiger.com", "monday.com", "google.com", "hubspot.com", "getjobber.com", "titandxp.com", "bigin.com", "kustomer.com"],
  "advertisers_latest_count": 28,
  "advertisers_month": "2026-11",
  "term_id": "2732183",
  "spyfu_url": "https://www.spyfu.com/keyword/overview?query=best%20crm%20software&countryCode=US",
  "google_search_url": "https://www.google.com/search?q=best%20crm%20software",
  "found": true,
  "source": "spyfu",
  "scraped_at": "2026-11-13T09:41:27.172Z"
}
```

A Domain-mode row (`ahrefs.com`) adds:

```json
{ "keyword": "sentence rewriter", "type": "domain", "domain": "ahrefs.com", "position": 2, "search_volume": 12700, "keyword_difficulty": 29,
  "rank": 1, "rank_change": 0, "ranking_url": "https://ahrefs.com/writing-tools/sentence-rewriter", "seo_clicks": 2100, "seo_clicks_change": 0 }
```

Fields that are empty for a keyword are left out of its row, except `search_volume`, `cpc` and `keyword_difficulty`, which are always present (null when SpyFu has no figure).

#### Fill rates (measured)

On a 1,192-keyword US run (2026-11-13): `search_volume` 100%, `live_search_volume` 91.6%, `keyword_difficulty` 94.4%, `monthly_clicks` 98.0%, `paid_competitors` 98.0%, `serp_first_result` 98.0%, `serp_features` 93.8%, `organic_clicks_pct` 89.4%, `advertisers_latest_count` 96.7%, `cpc` 69.0% (long-tail keywords often have no CPC in SpyFu's data). Domain mode (193 rows, ahrefs.com and nytimes.com): `rank`, `ranking_url`, `seo_clicks` and `keyword_difficulty` 100%, `rank_change` 79.3%.

#### Where the numbers come from

Every figure is SpyFu's own estimate from its keyword database, read from the same public keyword tools spyfu.com shows signed-out visitors. These are **not Google Ads Keyword Planner numbers**: Keyword Planner's competition label and index, top-of-page bid range, 12-month search history, search-partner network, language setting, Bing volume and "AI search volume" exist only in Google Ads, Bing Ads or paid data APIs, so this actor doesn't return them. SpyFu and Keyword Planner can differ (for example `plumber near me` in the US: SpyFu monthly 256,000, live 330,000). When SpyFu publishes only its live figure for a keyword, `search_volume` holds that figure and `search_volume_source` says `spyfu_live`.

### How much does it cost?

**$0.90 per 1,000 keyword rows** ($0.0009 a row), pay-per-event. There's no start fee. Only rows that carry SpyFu metrics are charged; you don't pay for:

- keywords SpyFu doesn't know (free `found: false` rows),
- keywords your filters remove,
- repeats (one row per keyword with `dedupe` on),
- keywords unchanged since the last monitor run.

| Example run (measured 2026-11-13) | Rows | Time | You pay |
|---|---:|---:|---:|
| 1 keyword | 1 | 2 s | $0.0009 |
| 100-keyword list | 100 | 2.5 s | $0.09 |
| 3 seeds x 50 ideas | 150 | 4.3 s | $0.135 |
| 1,193-keyword list | 1,192 | 6.5 s | $1.07 |
| 1 seed x 2,000 ideas | 1,997 | 28-103 s | $1.80 |
| 2 domains x 100 ranked keywords | 193 | 17 s | $0.17 |

Set a spending limit on the run (**Max total charge**) and the run stops cleanly at it: in our test a $0.01 limit stopped at 11 rows.

### Monitor mode (only changes)

Turn on **Monitor mode** and schedule the run (daily or weekly). The first run delivers everything (or, with **Deliver the first run** off, only records it). Each later run delivers:

- **NEW** keywords (a new idea for your seed, a new keyword a domain ranks for),
- **UPDATED** keywords whose volume or CPC moved by at least the threshold (10% by default), whose difficulty moved by 5+ points, or whose domain rank changed, with `previous_search_volume`, `previous_cpc`, `previous_keyword_difficulty`, `previous_rank` and `first_seen_at`,
- **DETAILS**: if you switch **Advertiser history** on later, each remembered keyword comes back once with it.

Unchanged keywords are skipped and not charged. In our test an immediate second poll delivered nothing and cost about $0.0001 in platform usage. Use **Monitor name** to keep separate memories for separate schedules of the same input.

### Integrations, API and MCP

Run it from the Apify Console, the Apify API, the JavaScript or Python client, Make, Zapier, n8n, Google Sheets, webhooks, or as a tool for AI agents through Apify's MCP server. Results download as JSON, CSV, Excel or XML. The dataset has four views: Keywords, PPC, SEO and Domain keywords.

### Limits and empty runs

- **Countries:** the 32 markets listed above. Any other country ends the run at once with the list, and nothing is charged.
- **Ideas and domain lists** come 5 rows per SpyFu call (the signed-out page size), so 1,000 ideas take 10-50 seconds. Keyword lists go 100 per call.
- **A keyword SpyFu doesn't know** gets a free `found: false` row (Metrics mode). A seed with no ideas, or a domain SpyFu doesn't track, ends with 0 rows and a status message saying so; nothing is charged.
- **SpyFu's signed-out bulk lookup has an allowance per IP.** When it runs out, the run moves to an Apify proxy, and after that looks each keyword up on its own through SpyFu's related-keyword list (slower, same price).
- Every run ends with a status message: rows delivered, keywords not found, keywords removed by filters, and why a run returned nothing.

### FAQ

#### How many keywords can one run handle?

There's no fixed limit. 100 keywords go in each SpyFu call and four calls run at once; our 1,193-keyword test took 6.5 seconds. Idea and domain lists go up to 10,000 rows per seed or domain.

#### Are these Google Keyword Planner numbers?

No. They are SpyFu's estimates of Google search volume and CPC. See "Where the numbers come from" above for what's included and what's not.

#### Which CPC is `cpc`?

Broad-match CPC, the figure SpyFu shows by default. `cpc_phrase` and `cpc_exact` are in the same row.

#### Do I need a SpyFu, Google Ads or SEO-tool account?

No. You don't need an account, cookies or an API key.

#### Can I get keyword ideas and their metrics in one run?

Yes. Ideas mode returns every idea with the same metrics as Metrics mode, and **Metrics + ideas** does both.

#### Why did my run return no results?

The status message says why: the keywords aren't in SpyFu's database for that country, your filters removed everything, the seed has no ideas, or the domain isn't tracked. Nothing is charged for an empty run.

#### Your feedback

Found a bug or need another field? Open an issue on the actor's Issues tab and we'll look at it.

# Actor input Schema

## `keywords` (type: `array`):

Keywords, one per line ("coffee maker", "plumber near me", "best crm software"). In Metrics mode each keyword gets its own row; in Ideas mode each is a seed for keyword ideas. 100 keywords go to SpyFu in one call, so lists of thousands are fine. Leave empty (and no domain) for a 3-keyword sample.

## `mode` (type: `string`):

Metrics: volume, CPC, difficulty and clicks for the keywords you list. Ideas: keyword ideas for each keyword (the seed) with the same metrics. Metrics + ideas: both in one run. Domain: the keywords a domain ranks for in Google (fill in Domains).

## `domains` (type: `array`):

Websites ("ahrefs.com", "https://www.nytimes.com") for the keywords they rank for in Google organic search: keyword, rank, rank change, ranking URL, estimated SEO clicks, plus the keyword's volume, CPC and difficulty. Used in Domain mode, or whenever filled in.

## `country` (type: `string`):

The Google market. SpyFu keeps a keyword database for these 32 countries.

## `ideaTypes` (type: `array`):

Which keyword ideas to collect for each seed (Ideas mode). Related: keywords containing the seed. Questions: question keywords containing the seed. Also ranks for: keywords the pages ranking for the seed also rank for. Also buys ads for: keywords the advertisers on the seed also bid on. Transactional: buying-intent keywords containing the seed.

## `maxIdeas` (type: `integer`):

How many ideas to keep for each seed and idea type, highest volume first unless you sort otherwise.

## `maxDomainKeywords` (type: `integer`):

How many ranked keywords to keep for each domain, most organic clicks first unless you sort otherwise.

## `maxItems` (type: `integer`):

Stop after this many charged rows across the whole run. Leave empty for no limit.

## `minVolume` (type: `integer`):

Only keywords with at least this many monthly searches. Applied by SpyFu in its own query.

## `maxVolume` (type: `integer`):

Only keywords with at most this many monthly searches.

## `minCpc` (type: `number`):

Only keywords whose broad-match cost per click is at least this.

## `maxCpc` (type: `number`):

Only keywords whose broad-match cost per click is at most this.

## `minDifficulty` (type: `integer`):

SpyFu's ranking difficulty, 0-100.

## `maxDifficulty` (type: `integer`):

Only keywords at or under this ranking difficulty (0-100), e.g. 30 for easy wins.

## `minClicks` (type: `integer`):

Only keywords whose searches lead to at least this many clicks a month.

## `minWords` (type: `integer`):

Only keywords with at least this many words (3+ for long-tail).

## `maxWords` (type: `integer`):

Only keywords with at most this many words.

## `includeTerms` (type: `array`):

Only keywords containing these words (SpyFu matches word forms: "woman" finds "women").

## `includeAnyTerm` (type: `boolean`):

On: a keyword needs only one of the words above. Off: it needs all of them.

## `excludeTerms` (type: `array`):

Drop keywords containing any of these words (brand names, "free", "jobs").

## `includeAdultKeywords` (type: `boolean`):

Keep adult keywords in idea and domain lists (SpyFu filters them out by default). Keywords you list yourself are always looked up.

## `sortBy` (type: `string`):

Order of idea and domain lists (which rows the limits above keep). Default: search volume for ideas, organic clicks for domains.

## `sortOrder` (type: `string`):

High to low or low to high.

## `includeAdvertisers` (type: `boolean`):

Add the domains that bought Google ads on each keyword, month by month (often 12 months; 'advertisers_by_month'). Without it each row still carries the latest month's top 10 advertisers and their count. Same price.

## `includeNotFound` (type: `boolean`):

In Metrics mode, a keyword missing from SpyFu's database for the country gets a row with found: false. These rows are free.

## `dedupe` (type: `boolean`):

On: a keyword found under several seeds or idea types is delivered (and charged) once. Off: once per seed and idea type, with its seed_keyword and idea_type.

## `monitorMode` (type: `boolean`):

Remember what earlier runs delivered (same input, same monitor name). A run then delivers only new keywords and keywords whose volume or CPC moved by the threshold below, difficulty by 5+ points or rank changed, with the previous values; unchanged keywords are skipped and not charged.

## `monitorName` (type: `string`):

Keeps separate memories for separate schedules of the same input.

## `changeThresholdPct` (type: `integer`):

In monitor mode, a keyword counts as changed when its search volume or CPC moved by at least this percent.

## `emitBaseline` (type: `boolean`):

On: the first monitor run delivers everything it finds. Off: it only records them (nothing delivered or charged) and later runs deliver changes.

## `resetMonitor` (type: `boolean`):

Forget what earlier runs delivered and start again.

## `proxyConfiguration` (type: `object`):

Optional. By default the run calls SpyFu directly and moves one rung up (Apify datacenter, then residential) only if SpyFu refuses an egress.

## `maxConcurrency` (type: `integer`):

SpyFu calls in flight at once.

## Actor input object example

```json
{
  "keywords": [
    "coffee maker",
    "running shoes",
    "plumber near me"
  ],
  "mode": "metrics",
  "country": "US",
  "ideaTypes": [
    "related"
  ],
  "maxIdeas": 100,
  "maxDomainKeywords": 100,
  "includeAnyTerm": false,
  "includeAdultKeywords": false,
  "sortOrder": "descending",
  "includeAdvertisers": false,
  "includeNotFound": true,
  "dedupe": true,
  "monitorMode": false,
  "monitorName": "default",
  "changeThresholdPct": 10,
  "emitBaseline": true,
  "resetMonitor": false,
  "maxConcurrency": 8
}
```

# Actor output Schema

## `results` (type: `string`):

One item per keyword: monthly search volume, CPC (broad, phrase, exact), keyword difficulty, clicks, SERP features, advertisers; keyword ideas and domain keywords carry their seed or domain.

## `summary` (type: `string`):

Per-seed and per-domain counts, not-found keywords, filters, egress and calls. Written on runs of 1,000+ rows or when part of the input could not be read; every run logs it.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "coffee maker",
        "running shoes",
        "plumber near me"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/keyword-volume-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": [
        "coffee maker",
        "running shoes",
        "plumber near me",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("topapi/keyword-volume-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "coffee maker",
    "running shoes",
    "plumber near me"
  ]
}' |
apify call topapi/keyword-volume-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/keyword-volume-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/jBPs4OLbrQ0zpfjIM/builds/ZdPgXxAKZVGprdkUb/openapi.json
