Ranked keywords
dataforseo/labs_google_ranked_keywords_liveList the keywords a domain already ranks for, with position and traffic metrics.
- call
- $0.048
- DataForSEO
- 3 min
Overview
Takes a website, subdomain, or single page and returns the queries it currently holds rankings for. Every keyword comes with its search metrics — monthly volume, competition, cost per click, bid ranges — alongside the result that earned the position, including the exact position, ranking URL, and result type. Aggregate metrics summarise the whole profile: how many results fall into each position band, an estimated monthly organic traffic figure, and what that traffic would cost to buy through ads instead.
Position-band counts and traffic estimates for the target, plus one row per ranking keyword with its metrics and ranking result.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| target | string | Yes | The domain, subdomain, or page URL to report on. |
| location_name | string | No | Which market to report on; omit for every market on record. |
| language_name | string | No | Which language to report on; omit for every language on record. |
| limit | integer | No | How many rows to return. |
| order_by | array | No | Sort rules for the returned rows. |
| filters | array | No | Up to eight conditions the returned rows must meet. |
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_ranked_keywords_live","input":{"target":"example.com","location_name":"United States","language_name":"English","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.