Keyword traffic insights

Google keyword search traffic insights: volume, competition, bids, and trend for related keyword suggestions.

← All Google Search endpoints · Capability overview

GET/v1/google-search/keyword-traffic-insights

https://api.vee3.io/v1/google-search/keyword-traffic-insights

20 tokens

Google keyword search traffic insights: volume, competition, bids, and trend for related keyword suggestions.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_seo_keyword_traffic_insights

Parameters6 fields

keywordstringRequired

Seed keyword to get traffic insights and suggestions for.

max length 512

languagestringRequired

Language code for the search market (for example en).

max length 16

locationstringOptional

Optional country or region code for localized traffic (for example US). Omit for global keyword insights.

Default: "" · max length 16

mode"exact" | "all"Optional

Keyword suggestion filter: exact returns only suggestions that exactly match the seed keyword; all returns all suggestions (default).

Default: "all"

min_search_volumeintegerOptional

Minimum monthly search volume; only keywords at or above this threshold are returned.

Default: 0 · min 0

intent"informational" | "navigational" | "commercial" | "transactional"Optional

Filter by search intent: informational, navigational, commercial, or transactional.

Response8 fields

keyword_suggestionsarrayitems

7 fields

Keyword suggestions with traffic and competition metrics.

textstring

Suggested keyword text.

volumeinteger

Estimated monthly search volume.

competition_levelstring

Competition level (for example LOW, MEDIUM, HIGH, UNSPECIFIED).

competition_indexinteger

Competition index score.

low_bidnumber

Low top-of-page bid estimate.

high_bidnumber

High top-of-page bid estimate.

trendnumber

Search volume trend percentage.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, seo_not_configured, seo_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/google-search/keyword-traffic-insights"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "keyword": "Sustainable Living",
    "language": "en"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample keyword suggestions for Sustainable Living.

sustainable_living_us.json

[
  {
    "text": "sustainable living",
    "volume": 5400,
    "competition_level": "LOW",
    "competition_index": 4,
    "low_bid": 0.310609,
    "high_bid": 2.259171,
    "trend": -0.58
  },
  {
    "text": "eco living",
    "volume": 390,
    "competition_level": "LOW",
    "competition_index": 11,
    "low_bid": 0.252541,
    "high_bid": 10.555247,
    "trend": -4.65
  }
]