DataForSEO Labs Google Keyword Ideas
From 14.4 credits/call
ae_dataforseo_labs_google_keyword_ideas
Generate relevant keyword ideas with search volume, CPC, and competition data using DataForSEO to expand your SEO or PPC strategy.
From 14.4 credits/call
Pricing
From 14.4 credits/call
| Condition | Charge |
|---|---|
| Without clickstream data (default) | 14.4 credits base fee + 0.2 credits per returned record |
| With clickstream data | 28.8 credits base fee + 0.3 credits per returned record |
Charges depend on clickstream inclusion and the number of results actually returned.
The starting price is the base query fee without clickstream data; returned records add the listed charges.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
tasks | array | Yes | No parameter description. | — |
tasks[].tag | string | null | No | No parameter description. | — |
tasks[].limit | integer | null | No | No parameter description. | — |
tasks[].offset | integer | null | No | No parameter description. | — |
tasks[].filters | array | null | No | No parameter description. | — |
tasks[].keywords | array | No | <em>keywords</em><br><strong>required field</strong><br>UTF-8 encoding<br>The maximum number of keywords you can specify: 200.<br>The keywords will be converted to lowercase format<p>learn more about rules and limitations of <code>keyword</code> and <code>keywords</code> fields in DataForSEO APIs in this <a href="https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis" rel="noopener noreferrer" target="_blank">Help Center article</a> | — |
tasks[].order_by | array | null | No | No parameter description. | — |
tasks[].offset_token | string | null | No | No parameter description. | — |
tasks[].language_code | string | null | No | No parameter description. | — |
tasks[].language_name | string | null | No | No parameter description. | — |
tasks[].location_code | integer | No | <em>unique location identifier</em><br><strong>required field if you don't specify</strong> <code>location_name</code><br><strong>Note:</strong> it is required to specify either <code>location_name</code> or <code>location_code</code><br>you can receive the list of available locations with their <code>location_code</code> by making a separate request to the <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>example:<br><code class="long-string">2840</code> | — |
tasks[].location_name | string | No | <em>full name of the location</em><br><strong>required field if you don't specify</strong> <code>location_code</code><br><strong>Note:</strong> it is required to specify either <code>location_name</code> or <code>location_code</code><br>you can receive the list of available locations with their <code>location_name</code> by making a separate request to the<br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>example:<br><code class="long-string">United Kingdom</code> | — |
tasks[].ignore_synonyms | boolean | null | No | No parameter description. | — |
tasks[].closely_variants | boolean | null | No | No parameter description. | — |
tasks[].include_serp_info | boolean | null | No | No parameter description. | — |
tasks[].include_clickstream_data | boolean | null | No | No parameter description. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_dataforseo_labs_google_keyword_ideas' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tasks": [
{
"keywords": [
"glass spigots"
],
"language_code": "en",
"limit": 3,
"location_code": 2840
}
]
}
}'Response exampleresponse.json
{
"cost": 0.01236,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.01236,
"data": {
"api": "dataforseo_labs",
"function": "keyword_ideas",
"keywords": [
"glass spigots"
],
"language_code": "en",
"limit": 3,
"location_code": 2840
},
"id": "11070901-2802-0400-0000-066e1212a04b",
"path": [
"v3"
],
"result": [
{
"items": [
{}
],
"items_count": 3,
"language_code": "en",
"location_code": 2840,
"offset": 0,
"offset_token": "eyJDdXJyZW50T2Zmc2V0IjozLCJSZXF1ZXN0RGF0YSI6eyJrZXl3b3JkcyI6WyJnbGFzcyBzcGlnb3RzIl0sImxvY2F0aW9uIjoyODQwLCJsYW5ndWFnZSI6ImVuIiwiY2xvc2VseV92YXJpYW50cyI6ZmFsc2UsIm5ld2VzdCI6ZmFsc2UsImV4dGVuZGVkIjpmYWxzZSwibG9hZF9zZXJwX2luZm8iOmZhbHNlLCJhdXRvY29ycmVjdCI6dHJ1"
}
],
"result_count": 1
}
],
"tasks_count": 1,
"tasks_error": 0
}This example shows part of the response. Copied content is valid JSON.

