# Bulk Keyword Search Volume (Google Ads data) (`psypherz/keyword-search-volume`) Actor

Get Google Ads search volume, CPC, competition and a 12-month trend for up to 10,000 keywords per run, in 49 countries.

- **URL**: https://apify.com/psypherz/keyword-search-volume.md
- **Developed by:** [Muhammad Yasin Bin Abdul Rahman](https://apify.com/psypherz) (community)
- **Categories:** SEO tools, Marketing
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 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

## Bulk Keyword Search Volume (Google Ads data)

Get monthly Google search volume, cost per click, competition and a 12-month trend for up to 10,000 keywords in one run. Data comes from Google Ads through DataForSEO, the same source most SEO tools use. You need no Google Ads account and no API key.

**Price: US$0.003 per keyword for the first 100 in a run, then US$0.0003, plus US$0.09 per block of up to 1,000 keywords.** 50 keywords cost US$0.24. 1,000 keywords cost US$0.66.

### What people use it for

- **Keyword research:** rank a list of ideas by real search demand before you write content.
- **PPC planning:** see CPC and top-of-page bid ranges before you spend on Google Ads.
- **Content gaps:** check volume for every keyword a competitor ranks for, in bulk.
- **Seasonality:** the 12-month trend shows when demand peaks, so you can publish in time.
- **AI agents and automations:** call it from n8n, Make, Zapier, LangChain or an MCP client and get compact JSON back.

### Example output

Real output from the sample input on Apify (27 Oct 2026).

| keyword | searchVolume | cpcUsd | competition | competitionIndex | trendChangePct |
|---|---|---|---|---|---|
| running shoes | 301000 | 1.09 | HIGH | 100 | -13.3 |
| trail running shoes | 165000 | 1.03 | HIGH | 100 | -40.4 |
| best running shoes for flat feet | 9900 | 0.96 | HIGH | 86 | 61.1 |

One full item:

```json
{
  "keyword": "trail running shoes",
  "country": "US",
  "language": "en",
  "searchVolume": 165000,
  "cpcUsd": 1.03,
  "lowTopOfPageBidUsd": 0.32,
  "highTopOfPageBidUsd": 1.59,
  "competition": "HIGH",
  "competitionIndex": 100,
  "trendChangePct": -40.4,
  "monthlyTrend": [
    {
      "month": "2025-10",
      "volume": 301000
    },
    {
      "month": "2025-11",
      "volume": 110000
    },
    {
      "month": "2026-09",
      "volume": 40500
    }
  ],
  "checkedAt": "2026-10-27T11:06:22+00:00"
}
```

`trendChangePct` compares the average of the latest 3 months with the average of the earliest 3 months in the 12-month trend. `monthlyTrend` lists the last 12 months, oldest first (shortened above to 3).

### Input

| Field | What it does | Default |
|---|---|---|
| `keywords` | One keyword per line, up to 10,000. Each must be 80 characters or fewer and 10 words or fewer. | 3 sample keywords |
| `country` | Two-letter country code. 49 countries supported, including US, GB, DE, IN, SG, BR, JP. | `US` |
| `language` | Two-letter language code, such as `en`, `de`, `es`. | `en` |
| `includeSearchPartners` | Add searches on Google's partner sites. Most SEO tools leave this off. | `false` |

Duplicates are removed (case does not matter). Keywords Google Ads cannot accept, such as ones with `!`, `@` or `,`, are listed in the output with a note and are not charged.

### Pricing

Pay per event. You only pay for keywords that come back.

| Event | Price |
|---|---|
| Run fee, per block of up to 1,000 keywords | US$0.09 |
| Keyword, first 100 in a run | US$0.003 |
| Keyword, after the first 100 | US$0.0003 |

Examples: 10 keywords cost US$0.12. 100 keywords cost US$0.39. 1,000 keywords cost US$0.66. 5,000 keywords cost US$2.22.

The run fee exists because the data provider charges per request, whatever the keyword count. Set "Maximum cost per run" in Apify and the Actor checks only as many keywords as that limit covers.

### Limits

- 10,000 keywords per run. Split bigger lists across runs.
- Results usually take 1 to 5 minutes, because requests go through a queue that keeps the price low.
- This Actor needs a paid Apify plan. Every run buys fresh data, and Apify does not pay developers for runs on the free plan. On the free plan, a run with the prefilled example keywords returns a stored, dated sample (marked `cachedExample: true`) at no charge, so you can see the output. Any other free-plan input is refused.
- Volumes are Google's rounded monthly averages, the same numbers Google Keyword Planner shows.

### FAQ

**Where does the data come from?** Google Ads keyword data, through the DataForSEO API.

**Why is a keyword's volume empty?** Google has no data for it, usually because almost nobody searches it. You are still charged for it, since the lookup was made.

**Can I get keyword ideas or related keywords?** Not in this Actor. Use it to measure lists you already have.

**What if the run fails?** You are not charged for invalid input, for keywords that were skipped, or when the data provider is unavailable. The status message says what went wrong.

**Can an AI agent call it?** Yes. The input is plain JSON and the output is compact JSON with stable field names. It works with Apify's MCP server and pay-per-event payments.

### More tools from the same developer

Same style: clean JSON output, pay only for results, no charge on failed items.

| Tool | What it does |
|---|---|
| [Google Keyword Ideas](https://apify.com/PsypherZ/google-keyword-ideas) | Hundreds of keyword ideas per seed with volume, CPC, difficulty and search intent |
| [Amazon Keyword Search Volume](https://apify.com/PsypherZ/amazon-keyword-volume) | Monthly Amazon searches for up to 10,000 keywords in 16 markets, plus related keywords |
| [Competitor Keywords](https://apify.com/PsypherZ/competitor-keywords) | Every Google keyword a domain ranks for, with traffic, plus its closest competitors |
| [Google Trends API](https://apify.com/PsypherZ/google-trends-api) | Interest over time, by region, and rising queries and topics for up to 500 keywords |
| [Google SERP Results](https://apify.com/PsypherZ/google-serp-results) | Organic results, featured snippets and People Also Ask for any keyword, country and device |
| [AI Brand Visibility Tracker](https://apify.com/PsypherZ/ai-brand-visibility) | Which brands ChatGPT, Claude, Gemini and Perplexity recommend, and where yours ranks |
| [Google AI Overview Tracker](https://apify.com/PsypherZ/google-ai-overview-tracker) | Which keywords show an AI Overview, what it says, and whether it cites your site |
| [Audio and Video Transcriber](https://apify.com/PsypherZ/audio-video-transcriber) | Timestamped transcripts from audio and video files in 90+ languages |
| [Subtitle Generator](https://apify.com/PsypherZ/subtitle-generator) | Ready-to-use SRT and WebVTT subtitles from audio and video files |
| [Podcast Transcriber](https://apify.com/PsypherZ/podcast-transcriber) | Timestamped transcripts of podcast episodes from any RSS feed or Apple Podcasts link |
| [Image OCR](https://apify.com/PsypherZ/image-ocr) | Text from images in 20 languages, with confidence scores |
| [AI Image Upscaler](https://apify.com/PsypherZ/image-upscaler) | Upscale photos and artwork 2x, 3x or 4x with Real-ESRGAN AI |
| [PDF to Text and Markdown](https://apify.com/PsypherZ/pdf-to-text-markdown) | Clean text and Markdown from PDFs, with OCR for scanned pages |
| [Bulk PageSpeed Insights Audit](https://apify.com/PsypherZ/bulk-pagespeed-audit) | Core Web Vitals and Lighthouse scores for many pages, mobile and desktop |

# Actor input Schema

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

One keyword per line. Up to 10,000 per run. Each keyword: 80 characters or fewer, 10 words or fewer.

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

Two-letter country code for the search market.

## `language` (type: `string`):

Two-letter language code, for example en, de, es, fr, ja.

## `includeSearchPartners` (type: `boolean`):

Add searches on Google's partner sites to the volume. Most SEO tools leave this off.

## Actor input object example

```json
{
  "keywords": [
    "running shoes",
    "trail running shoes",
    "best running shoes for flat feet"
  ],
  "country": "US",
  "language": "en",
  "includeSearchPartners": false
}
```

# Actor output Schema

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

One row per keyword: search volume, CPC, competition and a 12-month trend.

# 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": [
        "running shoes",
        "trail running shoes",
        "best running shoes for flat feet"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("psypherz/keyword-search-volume").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": [
        "running shoes",
        "trail running shoes",
        "best running shoes for flat feet",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("psypherz/keyword-search-volume").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": [
    "running shoes",
    "trail running shoes",
    "best running shoes for flat feet"
  ]
}' |
apify call psypherz/keyword-search-volume --silent --output-dataset

```

## MCP server setup

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

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/XL5364xmXu5WksL3o/builds/Dy5opqB9Pzspylyok/openapi.json