Get list of keywords for domain or URL
Use to get keywords that specific URL or domain is ranking for.
The results are sorted by the estimated visits from organic clicks. That means that keyword with the biggest impact on organic traffic is first.
You will get a list of competitors (domains with the most shared keywords) with each list of keywords.
Limits
Each request is counted towards your Keyword lookups limit. Lookup is not counted if you make the identical request within 24 hours.
Locations
Use location_id to specify country.
The request will return up to 1,000 keywords per request.
The list of available countries
These locations you can use in kwfinder/competitor-keywords endpoint.
[
{
"_id": 0,
"name": "Anywhere",
"tld": "us",
"country_code": "us",
"hl": "en"
},
{
"_id": 2840,
"name": "United States",
"country_code" : "US",
"tld" : "us",
"hl" : "en"
},
{
"_id": 2276,
"name": "Germany",
"country_code" : "DE",
"tld" : "de",
"hl" : "de"
},
{
"_id": 2826,
"name": "United Kingdom",
"country_code" : "GB",
"tld" : "uk",
"hl" : "en"
},
{
"_id": 2724,
"name": "Spain",
"country_code" : "ES",
"tld" : "es",
"hl" : "es"
},
{
"_id": 2250,
"name": "France",
"country_code" : "FR",
"tld" : "fr",
"hl" : "fr"
},
{
"_id": 2036,
"name": "Australia",
"country_code" : "AU",
"tld" : "au",
"hl" : "en_AU"
},
{
"_id": 2124,
"name": "Canada",
"country_code" : "CA",
"tld" : "ca",
"hl" : "ca"
},
{
"_id": 2528,
"name": "Netherlands",
"country_code" : "NL",
"tld" : "nl",
"hl" : "nl"
},
{
"_id": 2484,
"name": "Mexico",
"country_code" : "MX",
"tld" : "mx",
"hl" : "mx"
},
{
"_id": 2392,
"name": "Japan",
"country_code" : "JP",
"tld" : "jp",
"hl" : "jp"
},
{
"_id": 2380,
"name": "Italy",
"country_code" : "IT",
"tld" : "it",
"hl" : "it"
},
{
"_id": 2756,
"name": "Switzerland",
"country_code" : "CH",
"tld" : "ch",
"hl" : "de_CH"
},
{
"_id": 2040,
"name": "Austria",
"proportion": 0.75,
"count": 1500000,
"maxSV": 1000000000,
"country_code" : "AT",
"tld" : "at",
"hl" : "de_AT"
},
{
"_id": 2752,
"name": "Sweden",
"country_code" : "SE",
"tld" : "se",
"hl" : "sv_SE"
},
{
"_id": 2376,
"name": "Israel",
"country_code" : "IL",
"tld" : "il",
"hl" : "il"
},
{
"_id": 2703,
"name": "Slovakia",
"country_code" : "SK",
"tld" : "sk",
"hl" : "sk_SK"
},
{
"_id": 2704,
"name": "Vietnam",
"country_code" : "VN",
"tld" : "vn",
"hl" : "vn",
"comment": "orig. Viet Nam"
},
{
"_id": 2056,
"name": "Belgium",
"country_code" : "BE",
"tld" : "be",
"hl" : ["en", "de"]
},
{
"_id": 2792,
"name": "Turkey",
"country_code" : "TR",
"tld" : "tr",
"hl" : "tr_TR"
},
{
"_id": 2620,
"name": "Portugal",
"country_code" : "PT",
"tld" : "pt",
"hl" : "pt_PT"
},
{
"_id": 2702,
"name": "Singapore",
"country_code" : "SG",
"tld" : "sg",
"hl" : "sg"
},
{
"_id": 2076,
"name": "Brazil",
"country_code" : "BR",
"tld" : "br",
"hl" : "br_FR"
},
{
"_id": 2458,
"name": "Malaysia",
"country_code" : "MY",
"tld" : "my",
"hl" : "my"
},
{
"_id": 2208,
"name": "Denmark",
"country_code" : "DK",
"tld" : "dk",
"hl" : "da_DK"
},
{
"_id": 2710,
"name": "South Africa",
"country_code" : "ZA",
"tld" : "za",
"hl" : "za"
},
{
"_id": 2410,
"name": "South Korea",
"country_code" : "KR",
"tld" : "kr",
"hl" : "kr"
},
{
"_id": 2578,
"name": "Norway",
"country_code" : "NO",
"tld" : "no",
"hl" : "no"
},
{
"_id": 2784,
"name": "United Arab Emirates",
"country_code" : "AE",
"tld" : "ae",
"hl" : "ae"
},
{
"_id": 2372,
"name": "Ireland",
"country_code" : "IE",
"tld" : "ie",
"hl" : "en_GB"
},
{
"_id": 2554,
"name": "New Zealand",
"country_code" : "NZ",
"tld" : "nz",
"hl" : "en_GB"
},
{
"_id": 2682,
"name": "Saudi Arabia",
"country_code" : "SA",
"tld" : "sa",
"hl" : "ar_SA"
},
{
"_id": 2246,
"name": "Finland",
"country_code" : "FI",
"tld" : "fi",
"hl" : "fi"
},
{
"_id": 2203,
"name": "Czechia",
"country_code" : "CZ",
"tld" : "cz",
"hl" : "cs_CZ"
}
]Authorization
ApiKeyAuth x-access-token<token>
API token issued for your Mangools account, sent as an API key in the x-access-token HTTP header. This is NOT a standard RFC 6750 Authorization: Bearer <token> header. Auto-generated clients should be configured to send the token in x-access-token accordingly.
In: header
Query Parameters
location_id*integer
ID of location, default 2840
url*string
Target URL / domain / subdomain
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.mangools.com/v3/kwfinder/competitor-keywords?location_id=0&url=string"{
"competitorId": "4f9465a0a5efacc86123e82b6ad9e288",
"url_type": "RootDomain",
"location": {
"_id": 0,
"label": "Slovakia",
"code": "us"
},
"competitors": [
"aktuality.sk",
"zoznam.sk"
],
"keywords": [
{
"_id": "005de7e7771450763339653e918778ef",
"cpc": 0.813559,
"kw": "seo solutions",
"lid": 0,
"msv": [
[
2015,
8,
590
]
],
"ppc": 15,
"seo": 13,
"seo_ts": 1590868935,
"sv": 930,
"svn": 930,
"svs": 0,
"ts": 1592997076,
"h": [
[
1300,
5.24,
20,
33,
1507733116,
0.813559
]
]
}
]
}{
"error": {
"type": "AuthError",
"message": "Invalid API Key"
}
}{
"error": {
"type": "InvalidInput",
"message": "Parameter url is invalid"
}
}{
"error": {
"type": "RateLimit",
"message": "Not enough limits 2"
}
}