What is the Keyword Search Volume API?
The Keyword Search Volume API answers two questions about a list you already have: how often is each term searched on Google, and what do advertisers pay for it? You send up to 1,000 keywords with a country and a language. You get back average monthly searches, the figure for each of the last 12 months, cost per click, the low and high top-of-page bid and the competition level, all from Google Ads data.
Use it after brainstorming or keyword discovery, when the question changes from “what could we target?” to “which of these is worth it?”.
You ask
Get US search volume, CPC and competition for these 12 trail running keywords and show the last 12 months.
It runs
From your AI assistant over MCP or from your code over REST
You get
- Keyword
- Demand
- Cost
- Competition
- Score a list in one runCheck the terms from a brief, a spreadsheet or a client call in a single request.
- Spot seasonalityRead 12 months per keyword and see when demand peaks and when it drops.
- Budget paid searchEstimate click costs from CPC and the top-of-page bid range before you launch.
- Compare variantsSee whether “women” or “men”, “waterproof” or “gore-tex” draws more searches before you name a page.
- Keep agents groundedLet your assistant check real volumes instead of guessing which phrase is more popular.
What data does the search volume API return?
Each keyword comes back as one record. These are the fields our test run returned, described in plain words.
Keyword
- Keyword as you sent it
- Spelling suggestion, when Google has one
- Location and language of the figures
- Whether search partner sites are included
Demand
- Average monthly searches
- Searches for each month of the last 12, or of your date range
Cost
- Cost per click
- Low top-of-page bid
- High top-of-page bid
Competition
- Competition level: low, medium or high
- Competition index from 0 to 100
These are Google Ads planning figures, so there is no keyword difficulty or search intent here. For organic metrics and new ideas around a seed, use Keyword Research API for Seed Ideas.
Sample output from a real volume check
The table at the top of this page is a real run from 16 November 2026: 12 trail running and hiking keywords for the United States in English. All 12 came back with data. Below the chart is the month-by-month series for the head term, straight from the same run.
One result in full
trail running shoes, month by month
- Nov 2025
- 110,000
- Dec 2025
- 110,000
- Jan 2026
- 165,000
- Feb 2026
- 165,000
- Mar 2026
- 246,000
- Apr 2026
- 201,000
- May 2026
- 201,000
- Jun 2026
- 135,000
- Jul 2026
- 135,000
- Aug 2026
- 135,000
- Sep 2026
- 40,500
- Oct 2026
- 40,500
What this sample tells you
“trail running shoes” averages 135,000 searches a month, yet its months run from 246,000 in March 2026 down to 40,500 in September and October. Plan spend on the monthly series, not the average.
In October 2026 “hiking shoes” drew 165,000 searches, four times “trail running shoes”, even though their 12-month averages are close at 110,000 and 135,000.
The highest CPCs sit on small terms: “trail running socks” at $2.02 with 590 searches and “trail running shoes wide feet” at $1.87 with 210, against $1.10 for the head term.
11of 12
11 of 12 terms score 100 on the competition index. The comparison question “road vs trail running shoes” scores 68 and still carries the high label, so read the index when you need finer detail.
How to check search volume with your AI assistant
Connect AI/ML API
Click Try it now, pick your client and add the MCP server. You sign in with your AI/ML API account once.
Paste your list
Give the keywords, one per line or separated by commas, plus the country and the language.
Get the numbers
Your assistant returns volume, CPC, bids and competition per keyword, and the monthly series when you ask for it.
Decide in the chat
Ask it to rank by volume, flag seasonal terms or split the list into ad groups with an expected cost per click.
Prompts to start with
Use the AI/ML API MCP Keyword Search Volume API for Google Ads tool. Get Google Ads search volume, CPC and competition in the US for: trail running shoes, best trail running shoes, waterproof trail running shoes, trail running vest.
Use the AI/ML API MCP Keyword Search Volume API for Google Ads tool. Here are 200 keywords from our spreadsheet. Return search volume and CPC for the United Kingdom and sort them by volume.
Use the AI/ML API MCP Keyword Search Volume API for Google Ads tool. Compare monthly search volume for “hiking shoes” and “trail running shoes” in the US over the last 12 months and tell me when each one peaks.
Use the AI/ML API MCP Keyword Search Volume API for Google Ads tool. Check search volume in Germany, in German, for these product names and flag any with fewer than 100 searches a month.
Settings for a volume check
In chat you list the keywords and the market and your assistant fills in the rest. In code you pass these settings yourself.
| Setting | What it controls | Tip |
|---|---|---|
| Keywords | 1 to 1,000 terms per run, each up to 80 characters and 10 words | Send the whole list in one run instead of one keyword at a time |
| Location | Country or region, by name or code | Volumes are per market, so run each country separately |
| Language | Language of the searches | Use the language people search in, not the language of your site |
| Date range | Start and end dates for the monthly figures | Leave it empty to get the last 12 months |
| Search partners | Add searches on Google's partner sites, off by default | Keep it off when you compare with organic demand |
| Adult keywords | Include terms Google treats as adult content | Leave it off unless your category needs it |
| Sort order | Order of the returned rows, by relevance unless you choose otherwise | Sort by volume when you want the biggest terms first |
Competition here describes the Google Ads auction, not organic difficulty. A term can be crowded with advertisers and still be within reach in organic results, or the other way round.
Ways teams use search volume data
Ad group planning
Group keywords by volume and CPC, then set bids and budgets per group before the campaign goes live.
Search volumeCPCBids
Seasonal budgets
Move spend toward the months where a term peaks and pull back when the series drops.
Monthly searches
Content priorities
Rank the topics in your content plan by demand and write for the biggest ones first.
Search volume
Market comparison
Run the same list for several countries to see where demand for a product line really is.
Search volumeLocation
Product naming
Test which product name, feature or variant people search for before you print the label or name the page.
Search volumeCompetition
Client reporting
Refresh volumes for a client's keyword list every month and show how demand moved.
Monthly searchesCPC
Search volume API for your code
In your code
REST · your AI/ML API key, JSON records back
The same tool runs over REST with your AI/ML API key. Post up to 1,000 keywords with a location and a language and you get JSON with one record per keyword: average monthly searches, the monthly series, CPC, low and high top-of-page bids, the competition level and its 0 to 100 index.
Use MCP when someone checks a list in a chat and REST when a scheduled job refreshes volumes for a dashboard, a bidding script or a content plan. Both use one AI/ML API account and one balance, and you skip applying for a Google Ads developer token. Start with the Toolbox REST quickstart.
Other ways to get keyword search volume
Several routes lead to the same numbers. They differ in how many keywords you can check at once and where the result ends up.
| Google Keyword Planner by hand | Paid SEO suite in the browser | Build on the Google Ads API | ||
|---|---|---|---|---|
| Setup | Connect once with your AI/ML API account | Google Ads account, paste the list, export | Monthly subscription, upload or paste the list | Developer token approval, OAuth and your own code |
| Inside an AI chat | Yes. Over MCP | No. No | Only through exports | Only if you build it |
| Best for | Lists of up to 1,000 terms from chat or code | A one-off check of a short list | Teams that already work in one | Ad platforms that need first-party access |
Pricing
Pay as you goBilled per run from your AI/ML API balance
- No subscription
- No seat fee
- One balance for every tool
Each run is billed from your AI/ML API balance, with no subscription or seat fee. A run is priced per request, and one request covers up to 1,000 keywords, so send your list in one go instead of keyword by keyword. Our 12-keyword test run cost about 12 cents. Check the current price in your dashboard before large runs.
FAQ
Where do the search volume figures come from?
They are Google Ads planning figures for the location and language you choose, rounded into bands such as 590, 720 and 1,300. Use them to compare terms against each other, not as exact search counts.
Is advertiser competition the same as keyword difficulty?
No. Competition describes how crowded the Google Ads auction is for a term. Ranking in organic results needs separate checks of intent and the pages that already rank.
How many keywords can I check at once?
Up to 1,000 per run. Each keyword can be up to 80 characters and 10 words long, so full sentences need trimming first.
Why is the average different from this month's searches?
The headline number is a rounded 12-month average. In our test, “trail running shoes” showed 135,000 on average but 40,500 in October 2026. Read the monthly series when timing matters.
Can I get search volume for Bing or Amazon?
This tool returns Google figures only. Use Bing Search Volume for Bing Ads and Amazon Bulk Search Volume for searches on Amazon.
How is this different from the Google Ads API?
The Google Ads API is Google's own developer product and needs an Ads account, a developer token and OAuth. This tool returns the same kind of planning figures, runs on your AI/ML API account and works inside AI assistants over MCP.
Can I use it from Claude, ChatGPT or Cursor?
Yes. Add the AI/ML API MCP server once and paste your list in plain English. Hermes, OpenClaw and other MCP clients work the same way.
How fresh is the data?
Each run returns the latest monthly figures available. On 16 November 2026 the series ended with October 2026, the last full month.
Can I export the results to CSV or Google Sheets?
Ask your assistant to return the table as CSV, or write the JSON from the REST response to a file or a sheet in your code.
Check your first keyword list
Connect once, then paste your keywords and ask for volumes in plain English.