Get average monthly searches, competition and bid ranges for a specific list of up to 200 keywords, with no expansion.

POSThttps://api.rankparse.com/v1/google-ads/keyword-metricsFree (daily caps apply)API key + connected Google Ads account

Returns metrics for an explicit list of keywords, with no expansion into related terms. Use it when you already have keywords and want them sized. It returns volume and competition, never rankings. To discover new keywords, use Get keyword ideas.

Each call counts as one request against your daily cap, whether it carries 1 keyword or 200, and only after Google answers successfully.

Body parameters

Send JSON with Content-Type: application/json. A body that is not valid JSON returns 400 invalid_json.

keywordsarray of stringsrequired

Keywords to look up. Blank entries are ignored. At most 200 are used: the rest are dropped and truncated is true. An empty or missing list returns 400 missing_keywords.

languagestringdefault languageConstants/1000

Google language resource name. 1000 is English. Must match languageConstants/<digits>, otherwise 400 invalid_language.

geo_target_constantsarray of stringsdefault ["geoTargetConstants/2840"]

Google location resource names. 2840 is the United States. Each must match geoTargetConstants/<digits>, otherwise 400 invalid_geo_target. Only the first 10 are used.

keyword_plan_networkstringdefault GOOGLE_SEARCH

GOOGLE_SEARCH or GOOGLE_SEARCH_AND_PARTNERS. Any other value falls back to the default.

include_adult_keywordsbooleandefault false

Only the literal true turns it on. The REST route accepts it; the MCP tool does not expose it.

Response

dataarray

One entry per keyword Google returned metrics for.

Show properties

keywordstring

The keyword text.

close_variantsarray of strings

Close variants Google groups with this keyword. Empty when none.

metricsobject

avg_monthly_searches, competition, competition_index, low_top_of_page_bid_micros and high_top_of_page_bid_micros. Any can be null. Field meanings are on Get keyword ideas.

totalinteger

Entries in data.

requestedinteger

Keywords actually sent to Google, after trimming to 200.

truncatedboolean

true when you sent more than 200 keywords. Treat the missing ones as "not asked for", not "no data".

max_keywordsinteger

The per-call limit (200).

customer_idstring

The Google Ads account the call ran against.

Errors

HTTP	Code	When
400	`invalid_json`	The request body is not valid JSON.
400	`missing_keywords`	`keywords` is missing, not an array, or has no non-blank entry.
400	`invalid_language`	`language` is not a resource name like `languageConstants/1000`.
400	`invalid_geo_target`	`geo_target_constants` is not an array of names like `geoTargetConstants/2840`.
400	`google_ads_not_connected`, `google_ads_no_account_selected`	Connect Google Ads, or select an account, in the dashboard.
429	`google_ads_user_quota_exceeded`, `google_ads_daily_quota_exceeded`	A daily cap was reached. See `retry_after`.

The other Google Ads errors (token, access and quota failures) are listed in the overview.

MCP tool: get_google_ads_keyword_metrics (accepts keywords, language, geo_target_constants, keyword_plan_network).

Get keyword ideas

Discover new keywords from seeds or a URL.

Get rankings

Where your tracked keywords rank, per engine.

curl -X POST "https://api.rankparse.com/v1/google-ads/keyword-metrics" \
  -H "X-API-Key: rp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["seo api", "rank tracker"]}'

Response

{
  "data": [
    {
      "keyword": "seo api",
      "close_variants": ["seo apis"],
      "metrics": {
        "avg_monthly_searches": 1900,
        "competition": "MEDIUM",
        "competition_index": 47,
        "low_top_of_page_bid_micros": 1850000,
        "high_top_of_page_bid_micros": 6200000
      }
    }
  ],
  "total": 1,
  "requested": 2,
  "truncated": false,
  "max_keywords": 200,
  "customer_id": "1234567890"
}

Get keyword metrics

Body parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link

Get keyword ideas

Get rankings

Body parameters

Response

Errors

Related