Keyword suggestions
dataforseo/labs_google_keyword_suggestions_liveExpand one seed keyword into longer phrases that contain it.
- call
- $0.048
- DataForSEO
- 3 min
Overview
Takes a single seed phrase and returns longer keywords that include it, drawn from a keyword database rather than generated. Each suggestion arrives with its own demand and monetisation metrics: average monthly volume, a twelve-month history, advertiser competition as both a score and a level, average cost per click, and the bid range for top-of-page placement. Metrics for the seed itself can be included for comparison, and near-duplicate synonyms collapsed to core terms.
The seed phrase and one row per suggestion with its volume, competition, cost per click, and bid range.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| keyword | string | Yes | The seed phrase to expand. |
| location_code | integer | No | Which market to report on; omit for every market on record. |
| language_code | string | No | Which language to report on; omit to use the market's dominant language. |
| limit | integer | No | How many rows to return. |
| include_seed_keyword | boolean | No | Also return metrics for the seed phrase itself. |
| include_serp_info | boolean | No | Attach a summary of each keyword's results page. |
Requests up to 1 MB.
Example
A call that works, with your own key.
curl https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-d '{"provider":"dataforseo","endpoint":"labs_google_keyword_suggestions_live","input":{"keyword":"phone case","location_code":2840,"language_code":"en","limit":100}}'Pricing
$0.048 per call on the default plan. That is the list price; when the provider reports what a call actually cost, you are billed that instead. Every run carries its price in the response.