Highest-volume keywords in a market
keyword_top_searches is a $0.20 GET request on the Wuthering AI API. List the most-searched terms for a location, with optional filtering. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/keyword_top_searches
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/keyword_top_searches?location_code=…&token=YOUR_TOKEN'
What does keyword_top_searches return, and when should you call it?
Return the highest-volume keywords for a location and language, without needing a seed term.
The only discovery tool here that takes no input keyword, which makes it a way into an unfamiliar market. Results are broad by construction and usually need filtering before they are useful.
Returns: keyword, search_volume, cpc, competition, keyword_difficulty.
Use when entering a market you know nothing about. Don't use when you have any seed term at all; every other tool here will be more relevant.
What parameters does keyword_top_searches take?
keyword_top_searches accepts 4 parameters, none of them required. Array values are comma-separated on the query string.
| Parameter | Type | Required | Description |
|---|---|---|---|
| location_code | number | no | Numeric location code to scope results to. Defaults to 2840 (United States). Search volume and competition vary sharply by country, so set this when the question is about a specific market.Defaults to 2840 |
| language_code | string | no | ISO language code for results, for example 'en' or 'de'. Defaults to 'en'.Defaults to en |
| limit | number | no | Maximum rows to return (1 to 1000, default 100). Ask for the fewest that answer the question: every row is billed and spends the caller's context.Defaults to 100 |
| offset | number | no | Rows to skip before returning results. Use with limit to page through a large set.Defaults to 0 |
Reference for keyword_top_searches · last updated · published by Wuthering AI