AgentSky
Log inSign up
DataForSEO logo

Domain rank overview

by DataForSEO

dataforseo/labs_google_domain_rank_overview_live
Get an API key All Tools

Summarise a domain's organic and paid visibility in one line.

Billed per
call
Price
Price: —
Provider
DataForSEO
Timeout
3 min

Overview

Gives a top-level summary of how a domain performs in search without enumerating individual keywords. For the market you select it reports how many results place the domain in each position band, separately for organic listings and paid ads, and estimates the monthly organic traffic along with what buying that traffic would cost. Change indicators show how much of the profile is newly gained, improved, declined, or lost. This is the companion to the ranked-keywords report: the overview for scale, the keyword list for detail.

One row per market with organic and paid position-band counts, traffic estimates, and traffic cost.

Input

These go in the input object of the run request.

FieldTypeRequiredDescription
targetstringYesDomain. the domain name of the target website the domain should be specified without https:// and www.
location_codeintegerNoLocation code. Optional.
language_codestringNoLanguage code. Optional.
location_namestringNoWhich market to report on; omit for every market on record.
language_namestringNoWhich language to report on; omit for every language on record.
limitintegerNoHow many rows to return.
Default: 100
Maximum: 1000
ignore_synonymsbooleanNoExclude near-identical keywords from the totals.
Default: false

Requests up to 1 MB.

Example

Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.

# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
  -H "authorization: Bearer $AGENTSKY_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
  -d '{"provider":"dataforseo","endpoint":"labs_google_domain_rank_overview_live","input":{"target":"example.com","location_code":2840}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.

Pricing

— per call using your plan when signed in. Reported usage is billed under your account plan. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.

Questions