Provided by DataForSEO
Get One Domain's Current Google Ranking Spread and Traffic Estimate (DataForSEO)
Get a single summary row for one domain in one location and language: how its Google placements spread across the ranking bands, its estimated monthly organic and paid traffic, and how many keywords are new, up, down or lost. One domain in, one row out; domains are summarised one at a time. One request per call, priced by the vendor's own rate card; an empty result set is reported as no result. location_code and language_code must be a pair from DataForSEO's Labs locations_and_languages list, where each location names the language codes it accepts; a code outside that list is rejected with Invalid Field (observed: the bare language code zh).
How to run it
Step 1Set up
Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.
set up https://glasser.ai/SKILL.md
Show me how to use the DataForSEO endpoint /v3/dataforseo_labs/google/domain_rank_overview/live on Glasser.glasser run -p dataforseo -e '/v3/dataforseo_labs/google/domain_rank_overview/live' -i '{"target":"dataforseo.com","language_code":"en","location_code":2840}' --endpoint-version 7Uses endpoint version 7. Inspect the current price before running. Install and log in first on Get Started.
Once per Run:
IDEMPOTENCY_KEY=$(uuidgen)Run it, and copy this same block to send it again:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"dataforseo","endpoint":"/v3/dataforseo_labs/google/domain_rank_overview/live","input":{"target":"dataforseo.com","language_code":"en","location_code":2840},"endpoint_version":7}'Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Uses endpoint version 7; inspect the current price before running.
Step 2Try a specific example task
When you need to review a domain’s SEO performance, you might gather its available metrics into a snapshot for your research notes.
Copy this prompt into your agent to prepare an SEO snapshot for your domain.
Use dataforseo:/v3/dataforseo_labs/google/domain_rank_overview/live on Glasser.
Pull returned SEO metrics for my domain into a research snapshot.Endpoint structure
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"target"
],
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"target": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_name": {
"type": "string"
},
"location_code": {
"type": "integer"
},
"location_name": {
"type": "string"
},
"ignore_synonyms": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"target": "dataforseo.com",
"language_code": "en",
"location_code": 2840
}This Endpoint publishes no output schema. You get the Provider's own response body, unchanged — we do not warrant a shape we cannot guarantee.
How pricing works
| Base fee | The same price with or without matching data. | $0.012 |
|---|---|---|
| Per row | For each row returned. | $0.00012 |
| Maximum per Run | The total charge will not exceed this amount. | $0.132 |
| Provider error | The Provider failed to answer. | $0.00 |
| Timed out | The Run exceeded its time limit. | $0.00 |
| Internal failure | An internal error prevented completion. | $0.00 |