Skip to content

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.

6 credits / keywordIntelligenceCSV bulkMCP
POST/v1/keyword-metrics
{
  "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"
  }
}
[01/Response]

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.
[02/Capabilities]

What Keyword Metrics does

01

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.

02

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.

03

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.

04

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.

[03/Try it]

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.

POST /v1/keyword-metrics6 credits / keyword

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

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)
[05/Use cases]

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.

[06/Cost]

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
PlanPer 1,000 creditsPer 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
[07/FAQ]

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.

[ Validate ][ Enrich ]
[Get started]

Run Keyword Metrics on your own data

Starter is $29 a month for 6,000 credits, enough for 1,000 keywords a month.

[ Screen ][ Scrape ]