Skip to main content
POST
/
api
/
ubersuggest
/
keywords
/
search
/ubersuggest/keywords/search
curl --request POST \
  --url https://api.anysite.io/api/ubersuggest/keywords/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 2,
  "timeout": 300,
  "lang": "en",
  "loc_id": 2840,
  "sort_by": "-searchVolume",
  "search_intent": [],
  "volume_min": 1,
  "volume_max": 1,
  "seo_difficulty_min": 50,
  "seo_difficulty_max": 50,
  "cpc_min": 1,
  "cpc_max": 1,
  "competition_min": 0.5,
  "competition_max": 0.5,
  "pd_min": 50,
  "pd_max": 50,
  "include": [],
  "exclude": []
}
'
[
  {
    "keyword": "<string>",
    "@type": "@ubersuggest_keyword_idea",
    "volume": 123,
    "cpc": 123,
    "competition": 123,
    "seo_difficulty": 123,
    "paid_difficulty": 123,
    "search_intent": [],
    "updated_at": 123
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
keyword
string
required

Seed keyword to expand into related keyword ideas

Minimum string length: 1
Examples:

"coffee maker"

"seo"

​
count
integer
required

Max number of keyword ideas to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
lang
enum<string>
default:en

Keyword language

Available options:
en,
es,
de,
fr,
it,
pt,
nl,
pl,
ru,
ja,
hi
​
loc_id
integer
default:2840

Location id (resolve via the locations search endpoint, e.g. 2840 for the United States)

Required range: x >= 1
Example:

2840

​
sort_by
enum<string>
default:-searchVolume

Result ordering

Available options:
-searchVolume,
searchVolume,
-cpc,
cpc,
-sd,
sd,
-pd,
pd
​
search_intent
enum<integer>[]

Keep only keywords whose intent is in this set

Available options:
1,
2,
3,
4
​
volume_min
integer | null

Minimum monthly search volume

Required range: x >= 0
​
volume_max
integer | null

Maximum monthly search volume

Required range: x >= 0
​
seo_difficulty_min
integer | null

Minimum SEO difficulty (0-100)

Required range: 0 <= x <= 100
​
seo_difficulty_max
integer | null

Maximum SEO difficulty (0-100)

Required range: 0 <= x <= 100
​
cpc_min
number | null

Minimum cost-per-click

Required range: x >= 0
​
cpc_max
number | null

Maximum cost-per-click

Required range: x >= 0
​
competition_min
number | null

Minimum paid competition (0-1)

Required range: 0 <= x <= 1
​
competition_max
number | null

Maximum paid competition (0-1)

Required range: 0 <= x <= 1
​
pd_min
integer | null

Minimum paid difficulty (0-100)

Required range: 0 <= x <= 100
​
pd_max
integer | null

Maximum paid difficulty (0-100)

Required range: 0 <= x <= 100
​
include
string[]

Keep only keywords containing all of these terms

​
exclude
string[]

Drop keywords containing any of these terms

Response

Successful Response

​
keyword
string
required
​
@type
string
default:@ubersuggest_keyword_idea
​
volume
integer | null
​
cpc
number | null
​
competition
number | null
​
seo_difficulty
integer | null
​
paid_difficulty
integer | null
​
search_intent
string[]
​
updated_at
integer | null