Skip to main content
POST
/
api
/
ubersuggest
/
keywords
/ubersuggest/keywords
curl --request POST \
  --url https://api.anysite.io/api/ubersuggest/keywords \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "timeout": 300,
  "lang": "en",
  "loc_id": 2840
}
'
[
  {
    "keyword": "<string>",
    "@type": "@ubersuggest_keyword",
    "volume": 123,
    "cpc": 123,
    "competition": 123,
    "seo_difficulty": 123,
    "paid_difficulty": 123,
    "search_intent": [],
    "monthly_search_volume": {},
    "global_volume_breakdown": {},
    "language": "<string>",
    "loc_id": 123,
    "clickstream": {
      "@type": "@ubersuggest_keyword_clickstream",
      "click_rate": 123,
      "paid_searches_percentage": 123,
      "organic_searches_percentage": 123,
      "male_percentage": 123,
      "female_percentage": 123,
      "gender_unknown_percentage": 123,
      "age_under_18_percentage": 123,
      "age_18_to_24_percentage": 123,
      "age_25_to_34_percentage": 123,
      "age_35_to_44_percentage": 123,
      "age_45_to_54_percentage": 123,
      "age_55_to_64_percentage": 123,
      "age_plus_65_percentage": 123,
      "age_unknown_percentage": 123,
      "desktop_searches_percentage": {},
      "mobile_searches_percentage": {}
    },
    "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 look up

Minimum string length: 1
Examples:

"coffee maker"

"running shoes"

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

Response

Successful Response

keyword
string
required
@type
string
default:@ubersuggest_keyword
volume
integer | null
cpc
number | null
competition
number | null
seo_difficulty
integer | null
paid_difficulty
integer | null
search_intent
string[]
monthly_search_volume
Monthly Search Volume · object
global_volume_breakdown
Global Volume Breakdown · object
language
string | null
loc_id
integer | null
clickstream
UbersuggestKeywordClickstream · object
updated_at
integer | null