# Get US search volume for a keyword list

**Use case:** 

Paste a list of keywords and get average monthly US searches, CPC, competition and 12 months of history for each one. The numbers are Google Ads Keyword Planner data, the same source as Google's own Keyword Planner, with no Google Ads account needed. We built this Actor at Magenta Waterwheel. Keywords with no data are free.

## Input

```json
{
  "keywords": [
    "keyword research tool",
    "seo audit checklist",
    "best project management software",
    "how to start a podcast",
    "email marketing tools"
  ],
  "location": "United States",
  "language": "en",
  "includeCpcCompetition": true,
  "includeMonthlySearches": true,
  "includeKeywordsWithoutData": true,
  "searchPartners": false,
  "includeAdultKeywords": false
}
```

## Output

```json
{
  "keyword": {
    "label": "Keyword",
    "format": "string"
  },
  "searchVolume": {
    "label": "Monthly searches",
    "format": "integer"
  },
  "cpc": {
    "label": "CPC (USD)",
    "format": "number"
  },
  "competition": {
    "label": "Competition",
    "format": "string"
  },
  "competitionIndex": {
    "label": "Competition index",
    "format": "integer"
  },
  "trend3mPct": {
    "label": "3-month trend %",
    "format": "number"
  },
  "trendYoYPct": {
    "label": "Year-over-year %",
    "format": "number"
  },
  "location": {
    "label": "Location",
    "format": "string"
  },
  "language": {
    "label": "Language",
    "format": "string"
  },
  "hasData": {
    "label": "Has data",
    "format": "boolean"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Keyword Planner API: Google Search Volume, CPC & Local Keywords Actor is ready to run with the inputs already set for "Get US search volume for a keyword list". [Sign up or log in](https://console.apify.com/create-task-from-example/hX94v4m6AG6aw4gUd) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Get US search volume for a keyword list" task

The Keyword Planner API: Google Search Volume, CPC & Local Keywords Actor will start running based on the input automatically. You can also change all the input fields, like keywords, location, and more, to match your specific use case.

### 3. Receive the "Get US search volume for a keyword list" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as keyword, monthly searches, CPC (USD), and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Get US search volume for a keyword list" task via API](https://apify.com/magenta_waterwheel/keyword-search-volume.md).

## FAQ

### What does the US keyword search volume task return?

The US keyword search volume task returns one row per keyword with average monthly searches, CPC, top-of-page bid range, competition level and month-by-month search history.

### Do I need a Google Ads account for this task?

No. The US keyword search volume task returns Google Ads Keyword Planner data without a Google Ads account or ad spend.

### What does the US keyword search volume task cost?

The US keyword search volume task charges $1.50 per 1,000 keywords with data plus $0.12 per lookup of up to 1,000 keywords. Keywords with no data are free. It needs a paid Apify plan.

## About this Actor

This example demonstrates how to use [Keyword Planner API: Google Search Volume, CPC & Local Keywords](https://apify.com/magenta_waterwheel/keyword-search-volume.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/magenta_waterwheel/keyword-search-volume.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

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 full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/magenta_waterwheel/keyword-search-volume.md

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