Keyword metrics API: volume, CPC, difficulty, AI Overviews
Send a keyword and a country. Get monthly search volume, cost per click in USD, competition, a 0 to 100 difficulty score, a 12-month trend and whether Google shows an AI Overview for the query.
{
"success": true,
"data": {
"keyword": "phone validation api",
"country": "us",
"search_volume": 2400,
"cpc_usd": 14.2,
"competition": "high",
"keyword_difficulty": 46,
"has_ai_overview": true,
"trend": {
"change_12m_pct": 26,
"monthly": [
{
"month": "2026-08",
"volume": 2400
},
{
"month": "2026-09",
"volume": 2900
},
{
"month": "2026-10",
"volume": 2400
}
]
}
},
"meta": {
"credits_used": 6,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}What you get back
The fields most teams branch on. The full response is in the sample on this page and in the API reference.
search_volumeSearch volumeEstimated average monthly searches for the keyword in the country you picked.cpc_usdCost per clickWhat advertisers pay on average for a click on this term, in US dollars.competitionCompetitionHow contested the keyword is among advertisers: low, medium or high.keyword_difficultyKeyword difficultyA 0 to 100 score for how hard it is to rank organically. Higher means harder.has_ai_overviewAI OverviewTrue when Google currently shows an AI Overview above the results for this query.trend.change_12m_pct12-month changePercentage change in volume between the first and last month of the trend window.trend.monthlyMonthly trendSearch volume month by month for the past 12 months, so seasonality is visible.What Keyword Metrics does
Demand and price side by side
Monthly search volume tells you how many people look for a term. CPC in USD tells you what a click is worth to advertisers. Having both in one record lets you rank keywords by commercial value, not only by traffic.
A difficulty score for sorting
Keyword difficulty runs from 0 to 100 and estimates how hard the first page is to reach. It is a relative guide for ordering a list, not a promise about any single page.
Twelve months of history
The trend block holds a volume figure for each of the last 12 months. Seasonal terms and terms in decline are obvious at a glance, before you commit a writer or a budget.
AI Overview flag
A boolean reports whether Google shows an AI Overview for the query. An overview can pull clicks away from the organic listings, so the flag belongs in any traffic forecast.
See the response before you sign up
Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.
Fill in the field and run the lookup to see what comes back.
One POST request
Send JSON with a Bearer key. The same key works for all 79 products.
curl -X POST https://api.1lookup.dev/v1/keyword-metrics \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword":"phone validation api","country":"us"}'- Endpoint
POST /v1/keyword-metrics- Base URL
https://api.1lookup.dev- Request
keywordcountry- Price
- 6 credits / keyword
- Coverage
- Global
- Bulk
- CSV upload and bulk API
- Cache
- Repeats within 7 days are free
- Also via
- Dashboard and MCP server (run_lookup)
What teams use it for
Rank a content backlog
Run every candidate topic through the API and sort by volume against difficulty. Write the pieces with real demand and a realistic chance first.
Estimate a paid search budget
Multiply volume by an expected click-through rate and the CPC to get a rough monthly spend per keyword before you open an ads account.
Check demand before building programmatic pages
Test a sample of the keyword pattern in each target country. If the terms have no volume, you have saved yourself a few thousand pages.
Audit exposure to AI Overviews
Pull the flag for the keywords that bring you traffic today and see which ones now have an overview above your listing.
Search volume, CPC and difficulty are estimates. They are reliable for comparing keywords against each other, less so as exact figures.
6 credits / keyword
Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.
See pricing| Plan | Per 1,000 credits | Per 1,000 keywords |
|---|---|---|
| Starter $29/mo | $4.83 | $29.00 |
| Growth $99/mo | $3.96 | $23.76 |
| Pro $299/mo | $3.32 | $19.93 |
| Scale $799/mo | $2.66 | $15.98 |
Keyword Metrics questions
Which metrics come back for a keyword?
Monthly search volume, CPC in USD, advertiser competition, a keyword difficulty score from 0 to 100, a 12-month volume trend and a flag for AI Overview presence.
How exact are the numbers?
They are estimates. Search volume is a monthly average, CPC is an average across advertisers and difficulty is a modeled score. Use them to compare keywords with each other, not as precise counts.
What does a keyword lookup cost?
Six credits per keyword and country. Asking for the same keyword and country again within 7 days is free because the result is cached.
Which countries are supported?
Coverage is global. You pass a two-letter country code and the metrics are specific to that country, so one keyword can look very different in the US and in Germany. Rarely searched terms may come back with no volume data.
Can I look up thousands of keywords at once?
Yes. Upload the list as a CSV or post it to the bulk API with an idempotency key. Each row is billed as one keyword, and rows that error are listed so you can retry them.
Related products
Search Trends
Interest over time for up to five keywords, with regional breakdown.
Keyword Rank Checker
Where a site ranks on Google for a keyword, by country or city.
SERP Scraper
Live Google results for any query: organic, People Also Ask and related searches.
Run Keyword Metrics on your own data
Starter is $29 a month for 6,000 credits, enough for 1,000 keywords a month.