DataspryvaUbersuggest Keyword Suggestions by Country & Language
Returns related keyword suggestions for a seed keyword or domain, scoped to a chosen country and language, from a public no-login suggestion feed.
Input schema
Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.
| Field | Type | Required | Description |
|---|---|---|---|
keywords | array | optional | Keywords to expand. Each seed returns its own suggestions. Add several to research a topic. |
urls | array | optional | Optional domains or URLs converted into rough keyword seeds (make.com becomes make). This is not a domain keyword report; use the keywords field for real research. |
country | string | optional | Market for the suggestions. `worldwide` returns the global list. Russia and Belarus are not available from the source. |
Show all input fields
| Field | Type | Required | Description |
|---|---|---|---|
keywords | array | optional | Keywords to expand. Each seed returns its own suggestions. Add several to research a topic. |
urls | array | optional | Optional domains or URLs converted into rough keyword seeds (make.com becomes make). This is not a domain keyword report; use the keywords field for real research. |
country | string | optional | Market for the suggestions. `worldwide` returns the global list. Russia and Belarus are not available from the source. |
language | string | optional | Language of the suggestions. Leave English with auto-match on to use the market's main language automatically. |
autoMatchLanguageToCountry | boolean | optional | When language is English and the chosen market has another main language, switch to it automatically (Germany to German, Japan to Japanese). Turn off to keep English. |
sortBy | string | optional | Order of the suggestion list. |
maxSuggestionsPerSeed | integer | optional | Maximum suggestions returned for each seed. The default keeps runs fast; raise it for deep keyword lists. |
maxItems | integer | optional | Maximum suggestions across all seeds in one run. |
includeSeedOverview | boolean | optional | Fetch each seed's own metrics: search volume, CPC, competition, difficulty, intent, 4-month trend, global volume and device shares. Adds one request per seed. |
outputFormat | string | optional | One record per seed with nested suggestions (legacy), or one flat record per suggestion. |
Download the published input schema
View complete JSON
{
"description": "Expand seed keywords into Ubersuggest's keyword-idea list for a chosen country and language, with search volume, CPC, competition, difficulty and intent.",
"properties": {
"autoMatchLanguageToCountry": {
"default": true,
"description": "When language is English and the chosen market has another main language, switch to it automatically (Germany to German, Japan to Japanese). Turn off to keep English.",
"prefill": true,
"title": "Auto-match language to country",
"type": "boolean"
},
"country": {
"default": "us",
"description": "Market for the suggestions. `worldwide` returns the global list. Russia and Belarus are not available from the source.",
"editor": "select",
"enumSuggestedValues": [
"us",
"gb",
"ca",
"au",
"in",
"de",
"fr",
"es",
"it",
"br",
"jp",
"cn",
"kr",
"nl",
"mx",
"sg",
"hk",
"tw",
"id",
"my",
"ph",
"th",
"vn",
"pk",
"bd",
"ng",
"za",
"eg",
"sa",
"ae",
"il",
"ar",
"cl",
"co",
"pe",
"dk",
"no",
"fi",
"cz",
"gr",
"hu",
"ro",
"ua",
"sk",
"bg",
"hr",
"rs",
"si",
"lt",
"lv",
"ee",
"kz",
"ma",
"ke",
"af",
"al",
"dz",
"as",
"ad",
"ao",
"ai",
"ag",
"am",
"aw",
"at",
"az",
"bh",
"bb",
"be",
"bz",
"bj",
"bm",
"bt",
"bo",
"ba",
"bw",
"io",
"vg",
"bn",
"bf",
"bi",
"kh",
"cm",
"cv",
"bq",
"ky",
"cf",
"td",
"cx",
"cc",
"km",
"ck",
"cr",
"cw",
"cy",
"cd",
"dj",
"dm",
"do",
"ec",
"sv",
"gq",
"er",
"sz",
"et",
"fk",
"fo",
"fm",
"fj",
"gf",
"pf",
"tf",
"ga",
"ge",
"gh",
"gi",
"gl",
"gd",
"gp",
"gu",
"gt",
"gg",
"gn",
"gw",
"gy",
"ht",
"hn",
"is",
"iq",
"ie",
"jm",
"je",
"jo",
"ki",
"kw",
"xk",
"kg",
"la",
"lb",
"ls",
"lr",
"ly",
"li",
"lu",
"mo",
"mg",
"mw",
"mv",
"ml",
"mt",
"mh",
"mq",
"mr",
"mu",
"yt",
"md",
"mc",
"mn",
"me",
"ms",
"mz",
"mm",
"na",
"nr",
"np",
"nc",
"nz",
"ni",
"ne",
"nu",
"nf",
"mk",
"mp",
"om",
"pw",
"ps",
"pa",
"pg",
"py",
"pn",
"pl",
"pt",
"pr",
"qa",
"cg",
"re",
"rw",
"sh",
"kn",
"lc",
"pm",
"vc",
"ws",
"sm",
"st",
"sn",
"sc",
"sl",
"sx",
"sb",
"so",
"lk",
"sr",
"sj",
"se",
"ch",
"tj",
"tz",
"bs",
"gm",
"tl",
"tg",
"tk",
"to",
"tt",
"tn",
"tr",
"tm",
"tc",
"vi",
"ug",
"uy",
"uz",
"vu",
"va",
"ve",
"wf",
"eh",
"ye",
"zm",
"zw",
"worldwide"
],
"enumTitles": [
"United States",
"United Kingdom",
"Canada",
"Australia",
"India",
"Germany",
"France",
"Spain",
"Italy",
"Brazil",
"Japan",
"China",
"Korea",
"Netherlands",
"Mexico",
"Singapore",
"Hong Kong",
"Taiwan",
"Indonesia",
"Malaysia",
"Philippines",
"Thailand",
"Vietnam",
"Pakistan",
"Bangladesh",
"Nigeria",
"South Africa",
"Egypt",
"Saudi Arabia",
"United Arab Emirates",
"Israel",
"Argentina",
"Chile",
"Colombia",
"Peru",
"Denmark",
"Norway",
"Finland",
"Czech Republic",
"Greece",
"Hungary",
"Romania",
"Ukraine",
"Slovakia",
"Bulgaria",
"Croatia",
"Serbia",
"Slovenia",
"Lithuania",
"Latvia",
"Estonia",
"Kazakhstan",
"Morocco",
"Kenya",
"Afghanistan",
"Albania",
"Algeria",
"American Samoa",
"Andorra",
"Angola",
"Anguilla",
"Antigua & Barbuda",
"Armenia",
"Aruba",
"Austria",
"Azerbaijan",
"Bahrain",
"Barbados",
"Belgium",
"Belize",
"Benin",
"Bermuda",
"Bhutan",
"Bolivia",
"Bosnia & Herzegovina",
"Botswana",
"British Indian Ocean Territory",
"British Virgin Islands",
"Brunei",
"Burkina Faso",
"Burundi",
"Cambodia",
"Cameroon",
"Cape Verde",
"Caribbean Netherlands",
"Cayman Islands",
"Central African Republic",
"Chad",
"Christmas Island",
"Cocos (Keeling) Islands",
"Comoros",
"Cook Islands",
"Costa Rica",
"Curacao",
"Cyprus",
"Democratic Republic of The Congo",
"Djibouti",
"Dominica",
"Dominican Republic",
"Ecuador",
"El Salvador",
"Equatorial Guinea",
"Eritrea",
"Eswatini",
"Ethiopia",
"Falkland Islands (Islas Malvinas)",
"Faroe Islands",
"Federated States of Micronesia",
"Fiji",
"French Guiana",
"French Polynesia",
"French Southern and Antarctic Lands",
"Gabon",
"Georgia",
"Ghana",
"Gibraltar",
"Greenland",
"Grenada",
"Guadeloupe",
"Guam",
"Guatemala",
"Guernsey",
"Guinea",
"Guinea-Bissau",
"Guyana",
"Haiti",
"Honduras",
"Iceland",
"Iraq",
"Ireland",
"Jamaica",
"Jersey",
"Jordan",
"Kiribati",
"Kiribati",
"Kosovo",
"Kyrgyzstan",
"Laos",
"Lebanon",
"Lesotho",
"Liberia",
"Libya",
"Liechtenstein",
"Luxembourg",
"Macao",
"Madagascar",
"Malawi",
"Maldives",
"Mali",
"Malta",
"Marshall Islands",
"Martinique",
"Mauritania",
"Mauritius",
"Mayotte",
"Moldova",
"Monaco",
"Mongolia",
"Montenegro",
"Montserrat",
"Mozambique",
"Myanmar (Burma)",
"Namibia",
"Nauru",
"Nepal",
"New Caledonia",
"New Zealand",
"Nicaragua",
"Niger",
"Niue",
"Norfolk Island",
"North Macedonia",
"Northern Mariana Islands",
"Oman",
"Palau",
"Palestinian Territory",
"Panama",
"Papua New Guinea",
"Paraguay",
"Pitcairn Islands",
"Poland",
"Portugal",
"Puerto Rico",
"Qatar",
"Republic of the Congo",
"Reunion",
"Rwanda",
"Saint Helena, Ascension and Tristan da Cunha",
"Saint Kitts and Nevis",
"Saint Lucia",
"Saint Pierre and Miquelon",
"Saint Vincent and The Grenadines",
"Samoa",
"San Marino",
"Sao Tome and Principe",
"Senegal",
"Seychelles",
"Sierra Leone",
"Sint Maarten",
"Solomon Islands",
"Somalia",
"Sri Lanka",
"Suriname",
"Svalbard and Jan Mayen",
"Sweden",
"Switzerland",
"Tajikistan",
"Tanzania",
"The Bahamas",
"The Gambia",
"Timor-Leste",
"Togo",
"Tokelau",
"Tonga",
"Trinidad & Tobago",
"Tunisia",
"Turkey",
"Turkmenistan",
"Turks and Caicos Islands",
"U.S. Virgin Islands",
"Uganda",
"Uruguay",
"Uzbekistan",
"Vanuatu",
"Vatican City",
"Venezuela",
"Wallis and Futuna",
"Western Sahara",
"Yemen",
"Zambia",
"Zimbabwe",
"Worldwide (all locations)"
],
"prefill": "us",
"title": "Country",
"type": "string"
},
"includeSeedOverview": {
"default": true,
"description": "Fetch each seed's own metrics: search volume, CPC, competition, difficulty, intent, 4-month trend, global volume and device shares. Adds one request per seed.",
"prefill": false,
"title": "Include seed metrics",
"type": "boolean"
},
"keywords": {
"description": "Keywords to expand. Each seed returns its own suggestions. Add several to research a topic.",
"editor": "stringList",
"prefill": [
"coffee"
],
"title": "Seed keywords",
"type": "array"
},
"language": {
"default": "en",
"description": "Language of the suggestions. Leave English with auto-match on to use the market's main language automatically.",
"editor": "select",
"enum": [
"en",
"af",
"ak",
"sq",
"ach",
"am",
"ar",
"hy",
"az",
"ban",
"lt",
"eu",
"bn",
"bs",
"bg",
"my",
"ca",
"ceb",
"km",
"zh",
"zh_cn",
"zh_tw",
"hr",
"cs",
"da",
"nl",
"et",
"ee",
"fo",
"fil",
"fi",
"fr",
"fy",
"gaa",
"gl",
"lg",
"ka",
"de",
"el",
"gu",
"ht",
"ha",
"he",
"iw",
"hi",
"hu",
"is",
"bem",
"ig",
"id",
"ga",
"it",
"ja",
"kn",
"kk",
"rw",
"kg",
"ko",
"mfe",
"crs",
"kri",
"ckb",
"ky",
"lo",
"lv",
"mk",
"mg",
"tum",
"ms",
"ml",
"mt",
"mi",
"mr",
"mn",
"ne",
"nso",
"nb",
"ny",
"nyn",
"om",
"pa",
"fa",
"pcm",
"pl",
"pt",
"ps",
"qu",
"ro",
"rm",
"rn",
"ru",
"sr",
"sn",
"loz",
"sd",
"si",
"sk",
"sl",
"so",
"st",
"es",
"sw",
"sv",
"tg",
"ta",
"te",
"th",
"ti",
"tl",
"to",
"lua",
"tn",
"tr",
"tk",
"uk",
"ur",
"uz",
"vi",
"wo",
"xh",
"yo",
"zu"
],
"enumTitles": [
"English",
"Afrikaans",
"Akan",
"Albanian",
"Alur",
"Amharic",
"Arabic",
"Armenian",
"Azerbaijani",
"Balinese",
"Baltic",
"Basque",
"Bengali",
"Bosnian",
"Bulgarian",
"Burmese",
"Catalan - Valencian",
"Cebuano",
"Central Khmer",
"Chinese",
"Chinese (Simplified)",
"Chinese (Traditional)",
"Croatian",
"Czech",
"Danish",
"Dutch",
"Estonian",
"Ewe",
"Faroese",
"Filipino",
"Finnish",
"French",
"Frisian",
"Ga",
"Galician",
"Ganda",
"Georgian",
"German",
"Greek",
"Gujarati",
"Haitian",
"Hausa",
"Hebrew (he)",
"Hebrew (iw)",
"Hindi",
"Hungarian",
"Icelandic",
"IciBemba",
"Igbo",
"Indonesian",
"Irish",
"Italian",
"Japanese",
"Kannada",
"Kazakh",
"Kinyarwanda",
"Kongo",
"Korean",
"Kreol morisien",
"Kreol Seselwa",
"Krio",
"Kurdish",
"Kyrgyz",
"Lao",
"Latvian",
"Macedonian",
"Malagasy",
"Malawi",
"Malay",
"Malayalam",
"Maltese",
"Maori",
"Marathi",
"Mongolian",
"Nepali",
"Northern Sotho",
"Norwegian",
"Nyanja",
"Nyankole",
"Oromo",
"Panjabi",
"Persian",
"Pidgin",
"Polish",
"Portuguese",
"Pushto",
"Quechua",
"Romanian",
"Romansh",
"Rundi",
"Russian",
"Serbian",
"Shona",
"Silozi",
"Sindhi",
"Sinhala",
"Slovak",
"Slovene",
"Somali",
"Southern Sotho",
"Spanish",
"Swahili",
"Swedish",
"Tajik",
"Tamil",
"Telugu",
"Thai",
"Tigrinya",
"tl",
"Tonga (Tonga Islands)",
"Tshiluba",
"Tswana",
"Turkish",
"Turkmen",
"Ukrainian",
"Urdu",
"Uzbek",
"Vietnamese",
"Wolof",
"Xhosa",
"Yoruba",
"Zulu"
],
"prefill": "en",
"title": "Language",
"type": "string"
},
"maxItems": {
"default": 1000,
"description": "Maximum suggestions across all seeds in one run.",
"maximum": 10000,
"minimum": 1,
"prefill": 1,
"title": "Max suggestions in total",
"type": "integer"
},
"maxSuggestionsPerSeed": {
"default": 100,
"description": "Maximum suggestions returned for each seed. The default keeps runs fast; raise it for deep keyword lists.",
"maximum": 1000,
"minimum": 1,
"prefill": 1,
"title": "Max suggestions per seed",
"type": "integer"
},
"outputFormat": {
"default": "perSeed",
"description": "One record per seed with nested suggestions (legacy), or one flat record per suggestion.",
"editor": "select",
"enum": [
"perSeed",
"perSuggestion"
],
"enumTitles": [
"One record per seed (nested suggestions)",
"One record per suggestion (flat rows)"
],
"prefill": "perSeed",
"title": "Output format",
"type": "string"
},
"sortBy": {
"default": "-searchVolume",
"description": "Order of the suggestion list.",
"editor": "select",
"enum": [
"-searchVolume",
"+searchVolume",
"-cpc",
"+cpc",
"-sd",
"+sd",
"-pd",
"+pd",
"-keyword",
"+keyword"
],
"enumTitles": [
"Highest search volume",
"Lowest search volume",
"Highest CPC",
"Lowest CPC",
"Highest SEO difficulty",
"Lowest SEO difficulty",
"Highest paid difficulty",
"Lowest paid difficulty",
"Keyword Z-A",
"Keyword A-Z"
],
"prefill": "-searchVolume",
"title": "Sort suggestions by",
"type": "string"
},
"urls": {
"description": "Optional domains or URLs converted into rough keyword seeds (make.com becomes make). This is not a domain keyword report; use the keywords field for real research.",
"editor": "stringList",
"prefill": [],
"title": "Domains as seeds (legacy)",
"type": "array"
}
},
"required": [],
"schemaVersion": 1,
"title": "Ubersuggest Keyword Suggestions Input",
"type": "object"
}
Output schema
Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.
| Field | Type | Required | Description |
|---|---|---|---|
keywords | string | optional | Dataset containing seed records with nested suggestions, or flat suggestion rows. |
Download the published output schema
View complete JSON
{
"actorOutputSchemaVersion": 1,
"description": "Ubersuggest keyword suggestions with search volume, CPC, competition, difficulty and intent, plus optional seed overviews.",
"properties": {
"keywords": {
"description": "Dataset containing seed records with nested suggestions, or flat suggestion rows.",
"template": "{{links.apiDefaultDatasetUrl}}/items",
"title": "Keyword suggestions",
"type": "string"
}
},
"title": "Ubersuggest Keyword Suggestions by Country Output"
}
Dataset schema
Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.
Download the published dataset schema
View complete JSON
{
"actorSpecification": 1,
"views": {
"flatSuggestions": {
"display": {
"component": "table",
"properties": {
"country": {
"format": "text",
"label": "Country"
},
"cpc": {
"format": "number",
"label": "CPC (USD)"
},
"keyword": {
"format": "text",
"label": "Suggestion"
},
"language": {
"format": "text",
"label": "Language"
},
"paidDifficulty": {
"format": "number",
"label": "Paid difficulty"
},
"scrapedAt": {
"format": "date",
"label": "Scraped at"
},
"searchIntent": {
"format": "array",
"label": "Intent"
},
"searchVolume": {
"format": "number",
"label": "Search volume"
},
"seedKeyword": {
"format": "text",
"label": "Seed keyword"
},
"seoDifficulty": {
"format": "number",
"label": "SEO difficulty"
}
}
},
"title": "Flat suggestions",
"transformation": {
"fields": [
"seedKeyword",
"keyword",
"searchVolume",
"cpc",
"seoDifficulty",
"paidDifficulty",
"searchIntent",
"country",
"language",
"scrapedAt"
]
}
},
"seedSuggestions": {
"display": {
"component": "table",
"properties": {
"country": {
"format": "text",
"label": "Country"
},
"keyword": {
"format": "text",
"label": "Seed keyword"
},
"language": {
"format": "text",
"label": "Language"
},
"scrapedAt": {
"format": "date",
"label": "Scraped at"
},
"seedOverview": {
"format": "object",
"label": "Seed overview"
},
"suggestions": {
"format": "array",
"label": "Suggestions"
},
"type": {
"format": "text",
"label": "Type"
}
}
},
"title": "Seed suggestions",
"transformation": {
"fields": [
"type",
"keyword",
"country",
"language",
"suggestions",
"seedOverview",
"scrapedAt"
]
}
}
}
}
Key-value schema
Published key-value store definitions, when provided by this build.
This definition is not present in the default published build. See the published README for available documentation.
Published README
Read the full published documentation
Ubersuggest Keyword Suggestions by Country & Language
Pull Ubersuggest's keyword-idea list for a seed keyword in the market and language you choose. Suggestions carry search volume, CPC, competition, SEO and paid difficulty, and search intent where Ubersuggest exposes them; the source unlocks full metrics for the first ~19 suggestions in each response. An optional overview adds the seed's own metrics. 231 countries plus worldwide, 122 languages, no login and no cookies.
What this actor does
- Expand one or many seeds. Give it
coffee,running shoes, orproject management software; each seed returns its own suggestion list. - Choose the market. 231 countries plus a worldwide option (232 choices). Country changes the suggestions and the metrics, not just a label.
- Choose the language. 122 languages. With auto-match on, picking Germany, Japan or Brazil switches to the market's main language automatically.
- Get real keyword metrics. Search volume, CPC in USD and local currency, competition, SEO difficulty, paid difficulty, search intent and the source's freshness date.
- Add a seed overview. Optionally fetch the seed's own volume, CPC, difficulty, intent, a 4-month volume trend, global volume breakdown, device share and click share.
- Go deep or stay small. Cursor pagination can return thousands of suggestions per seed; per-seed and whole-run caps keep runs predictable.
- Choose the shape. Keep the classic one-record-per-seed output with nested suggestions, or switch to one flat record per suggestion.
- Empty fields are omitted; the actor never writes
null, empty strings or empty arrays.
Output per seed (default)
Each record is one seed keyword:
type—keywordkeyword— the seed you suppliedcountry,language— the market and language actually usedlocationId— Ubersuggest's location id ("0000"for worldwide)suggestions[]— related keywords, each with:type—keywordkeywordcountry,languagesearchVolume,cpc,cpcLocal,currencycompetition,seoDifficulty,paidDifficultysearchIntent[]—informational,navigational,commercial,transactionaldataUpdatedAt
- Metrics appear only on the rows Ubersuggest unlocks (the first ~19 in each response); the rest carry the identity fields.
seedOverview— present when seed metrics are enabled:searchVolume,cpc,cpcLocal,currencycompetition,seoDifficulty,paidDifficulty,searchIntent[]monthlyTrend— 4 monthly volume pointsglobalSearchVolume,globalVolumeBreakdowndesktopShare,mobileShare,clickRate,paidClickShare,organicClickSharedataUpdatedAt
updated_at,scrapedAt
Output per suggestion (flat mode)
Set outputFormat to perSuggestion to get one row per suggestion:
type—keywordSuggestionseedKeyword,keyword,country,language,locationIdsearchVolume,cpc,cpcLocal,currencycompetition,seoDifficulty,paidDifficulty,searchIntent[]dataUpdatedAt,scrapedAt
When seed metrics are enabled, a matching type: "keywordOverview" record is added once per seed with the overview fields. This is intentional: flat mode returns the seed row plus one row per suggestion (three suggestions with seed metrics on = four rows). With seed metrics off, flat mode returns only suggestion rows.
Input
| Field | Type | Default | Description |
|---|---|---|---|
keywords |
Array | – | Seed keywords. Each seed returns its own suggestions. |
urls |
Array | – | Optional domains/URLs converted into keyword seeds. A path URL uses its last usable segment (/blog/coffee-guide → coffee guide); a homepage uses the host label (make.com → make). Not a domain keyword report. |
country |
Select | us |
231 countries or worldwide (232 options). Legacy uk is accepted and output as gb; legacy ka maps to la. |
language |
Select | en |
122 languages. |
autoMatchLanguageToCountry |
Boolean | true | Switch English to the market's main language when one exists. |
sortBy |
Select | -searchVolume |
Volume, CPC, SEO/paid difficulty or alphabetical. |
maxSuggestionsPerSeed |
Integer | 100 | Per-seed cap, 1–1000. |
maxItems |
Integer | 1000 | Whole-run suggestion cap, 1–10000. |
includeSeedOverview |
Boolean | true | Add the seed's own metrics, trend, global and device shares. |
outputFormat |
Select | perSeed |
Nested seed records or flat suggestion rows. |
Legacy tasks: keyword maps to the seed list; uk: true wins over country and is output as gb; legacy ka maps to la; old include_*/proxy keys are accepted but ignored. Flat mode includes one keywordOverview seed row when includeSeedOverview is on.
Example: default US English
{
"keywords": ["coffee"],
"country": "us",
"language": "en"
}
Example: German market with automatic language
{
"keywords": ["Kaffee"],
"country": "de",
"autoMatchLanguageToCountry": true
}
Example: Japanese seed and a deeper list
{
"keywords": ["コーヒー"],
"country": "jp",
"language": "ja",
"maxSuggestionsPerSeed": 300,
"maxItems": 300
}
Example: flat rows with a seed overview
{
"keywords": ["running shoes", "trail shoes"],
"country": "gb",
"sortBy": "-searchVolume",
"maxSuggestionsPerSeed": 100,
"maxItems": 200,
"includeSeedOverview": true,
"outputFormat": "perSuggestion"
}
Use cases
- Keyword research — expand a seed into the phrasings Ubersuggest actually suggests for a market.
- Content planning — find question-led and long-tail ideas, then sort by volume or difficulty.
- Paid search — pull CPC and paid difficulty for ad keyword lists.
- Multi-market SEO — compare the same seed across countries and languages.
- SEO dashboards — export flat rows into a warehouse, sheet or BI tool.
- Agency workflows — batch many client seeds with a predictable per-seed and total cap.
FAQ
Where does the data come from?
Ubersuggest's public keyword data. The actor reads only keyword suggestions and their metrics; it does not need an Ubersuggest account, cookie or API key.
Are the search volumes exact?
No. Ubersuggest search volumes are estimates, rounded to practical buckets and refreshed on its own schedule. They are useful for prioritisation and for comparing ideas in the same market; they are not Google Ads' exact figures. CPC is Ubersuggest's advertiser estimate, in USD (cpc) and the market's currency (cpcLocal).
Why do some suggestions have no volume, CPC or difficulty?
Ubersuggest exposes full metrics for the first ~19 suggestions in each response. The remaining keywords are still returned with their identity fields, but without volume/CPC/difficulty. Ubersuggest's bulk metrics endpoint repeats the same core fields for up to 10 keywords per request; it adds no new per-suggestion fields, so the actor does not make a separate enrichment pass and never guesses missing values.
How many suggestions can I get per seed?
The list is cursor-paginated and can run into the thousands for broad seeds. maxSuggestionsPerSeed and maxItems stop the run; the source can also run out earlier. The actor does not publish a total result count because the source's match count is not the number of returned rows.
What is the seed overview?
It is the metrics for the seed itself, not for a suggestion. It includes volume, CPC, competition, difficulty, intent, a 4-month volume trend, global volume with a breakdown, and desktop/mobile and click shares. It adds one extra request per seed.
Which countries and languages are supported?
231 countries, 122 languages and worldwide (232 options). Russia and Belarus are not available from Ubersuggest's location data and are intentionally absent. If an old task still asks for one of them, the actor explains the limitation instead of returning wrong data.
What does auto-match do?
When language is en and the chosen market has another main language, auto-match switches to it: Germany to German, Japan to Japanese, Brazil to Portuguese, China to Simplified Chinese. Set it to false to keep English suggestions for that market.
Do I need a login, cookies or a proxy?
No. The actor reads public keyword data without an account, and it chooses its own working connection automatically. Just provide keywords and run it.
Can I use a domain instead of a keyword?
urls is a legacy convenience. A path URL uses its last usable path segment (https://example.com/blog/coffee-guide becomes coffee guide); a homepage or a bare domain uses the host label (make.com becomes make). It does not analyse the domain's rankings, pages or backlinks. For real keyword research, use keywords.
Is this affiliated with Ubersuggest?
No. This is an independent tool that reads publicly available keyword data.
Python quickstart
Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.
Source build nhx6wb2iZUAMRMRky. Documentation is regenerated from the default published build; private drafts are not included.