DataForSEO Google Keyword Ideas

API docs
https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/keyword_ideas/live

Returns Google keyword suggestions alongside search volume and CPC metrics for SEO analysis. Helps research related search queries and evaluate keyword potential.

Price
From $0.0126USD / call
Method
POST
Response
JSON
Parameters
0 required · 4 optional

Playground

Input
List of keywords (up to 100 per call).
Maximum number of results (up to 100).
Location code, e.g. 2840 for the United States.
Language code, e.g. "en".
OutputExample
Responseoutputs · 726 B · 33 lines
[
  {
    "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"
  }
]

Examples

Select an example to load its inputs and result into the playground.

API README

DataForSEO Google Keyword Ideas API

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.

Use cases

  • Find adjacent topics and synonyms you do not rank for yet.
  • Build topic clusters from a handful of seed keywords.

Request

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].

Parameters

NameTypeRequiredDescription
keywordsarrayNoList of keywords (up to 100 per call).
language_codestringNoLanguage code, e.g. "en".
limitintegerNoMaximum number of results (up to 100).
location_codeintegerNoLocation code, e.g. 2840 for the United States.

Example response

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"
              }
            }
          ]
        }
      ]
    }
  ]
}

Response fields

FieldMeaning
tasks[].result[].items[]One row per keyword.
keywordThe keyword.
keyword_info.search_volumeAverage monthly Google searches (last 12 months).
keyword_info.cpc / competition_levelAverage 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_difficultyRanking difficulty 0-100 for the top 10 organic results.
search_intent_info.main_intentinformational, navigational, commercial or transactional.
total_countMatching keywords in the database; page with offset.

Notes

  • Ideas can omit the seed phrase. For variants that always contain it, use Keyword Suggestions.
  • keywords takes up to 100 seeds; limit is capped at 100 per call.

Pricing

Billed at the actual cost of each call, about $0.0126 for the request above. Failed calls are not charged.

Explore more

Related APIs

All APIs
APIPriceResponse
DataForSEOFrom $0.0126 per callJSON
DataForSEOFrom $0.0102 per callJSON
DataForSEOFrom $0.000724 per callJSON
DataForSEO$0.004 per callJSON
DataForSEOFrom $0.00162 per callJSON
DataForSEOFrom $0.001105 per callJSON

Questions

FAQ

How do I use the DataForSEO Google Keyword Ideas API?

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.

How much does the DataForSEO Google Keyword Ideas API cost?

From $0.0126 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the DataForSEO Google Keyword Ideas API accept?

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.

What does the DataForSEO Google Keyword Ideas API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a DataForSEO developer account or API key?

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.