keywordsarray
List of keywords (up to 100 per call).
https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/keyword_ideas/liveReturns Google keyword suggestions alongside search volume and CPC metrics for SEO analysis. Helps research related search queries and evaluate keyword potential.
[
{
"cost": 0,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0,
"data": {
"api": "dataforseo_labs",
"function": "keyword_ideas",
"se_type": "google"
},
"id": "08200930-2190-0400-0000-cc5704c84558",
"path": [
"v3",
"dataforseo_labs",
"google",
"… 2 more items in the full response"
],
"result": null,
"result_count": 0,
"status_code": 40503,
"status_message": "POST Data Is Invalid.",
"time": "0 sec."
}
],
"tasks_count": 1,
"tasks_error": 1,
"time": "0.0079 sec.",
"version": "0.1.20260806"
}
]Select an example to load its inputs and result into the playground.
Keyword ideas related to up to 100 seed keywords, chosen by topic relevance rather than by containing the seed phrase, with search volume, CPC, competition, keyword difficulty and search intent.
curl -X POST "https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/keyword_ideas/live" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords": ["running shoes"], "limit": 5, "location_code": 2840, "language_code": "en"}'
The result is returned in outputs[0].
| Name | Type | Required | Description |
|---|---|---|---|
keywords | array | No | List of keywords (up to 100 per call). |
language_code | string | No | Language code, e.g. "en". |
limit | integer | No | Maximum number of results (up to 100). |
location_code | integer | No | Location code, e.g. 2840 for the United States. |
Real response for the request above, trimmed: lists keep their first item and long strings are cut.
{
"status_code": 20000,
"tasks": [
{
"status_code": 20000,
"result": [
{
"se_type": "google",
"location_code": 2840,
"language_code": "en",
"total_count": 1013880,
"items_count": 5,
"items": [
{
"keyword": "on running shoes",
"keyword_info": {
"search_volume": 201000,
"cpc": 1.23,
"competition": 1,
"competition_level": "HIGH",
"low_top_of_page_bid": 0.39,
"high_top_of_page_bid": 1.96
},
"keyword_properties": {
"keyword_difficulty": 27,
"core_keyword": "running shoes"
},
"search_intent_info": {
"main_intent": "transactional"
}
}
]
}
]
}
]
}
| Field | Meaning |
|---|---|
tasks[].result[].items[] | One row per keyword. |
keyword | The keyword. |
keyword_info.search_volume | Average monthly Google searches (last 12 months). |
keyword_info.cpc / competition_level | Average cost per click in USD and Google Ads competition (LOW/MEDIUM/HIGH). |
keyword_info.monthly_searches[] | Searches per month for the last 12 months. |
keyword_properties.keyword_difficulty | Ranking difficulty 0-100 for the top 10 organic results. |
search_intent_info.main_intent | informational, navigational, commercial or transactional. |
total_count | Matching keywords in the database; page with offset. |
keywords takes up to 100 seeds; limit is capped at 100 per call.Billed at the actual cost of each call, about $0.0126 for the request above. Failed calls are not charged.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/keyword_ideas/live" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"limit": 5,
"keywords": [
"running shoes"
],
"language_code": "en",
"location_code": 2840
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
keywordsarrayList of keywords (up to 100 per call).
limitintegerMaximum number of results (up to 100).
location_codeintegerLocation code, e.g. 2840 for the United States.
language_codestringLanguage code, e.g. "en".
Saved example response for this API; no live request is made when viewing it.
[
{
"cost": 0,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0,
"data": {
"api": "dataforseo_labs",
"function": "keyword_ideas",
"se_type": "google"
},
"id": "08200930-2190-0400-0000-cc5704c84558",
"path": [
"v3",
"dataforseo_labs",
"google",
"… 2 more items in the full response"
],
"result": null,
"result_count": 0,
"status_code": 40503,
"status_message": "POST Data Is Invalid.",
"time": "0 sec."
}
],
"tasks_count": 1,
"tasks_error": 1,
"time": "0.0079 sec.",
"version": "0.1.20260806"
}
]Explore more
| API | Price | Response |
|---|---|---|
DataForSEO Google Keyword IdeasThis API DataForSEO | From $0.0126 per call | JSON |
DataForSEO | From $0.0102 per call | JSON |
DataForSEO | From $0.000724 per call | JSON |
DataForSEO | $0.004 per call | JSON |
DataForSEO | From $0.00162 per call | JSON |
DataForSEO | From $0.001105 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/keyword_ideas/live with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
From $0.0126 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
No parameters are required. Optional: keywords (array), limit (integer), location_code (integer) and language_code (string). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
No. DataForSEO Google Keyword Ideas runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for DataForSEO API access separately.