DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Domain Rank Overview
A domain's search footprint: organic and paid keyword counts, estimated traffic and traffic value, by location_code. Returns se_type, target, total_count, items_count and items. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. For the same numbers over time use post_dataforseo_labs_google_historical_rank_live; for many domains at once, post_dataforseo_labs_google_bulk_traffic_estimation_live.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.0121.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: array (object | null)[]
- ignoreType: boolean | null
_synonyms ignore highly similar keywords
optional field
if set to_true, all highly similar keywords will be excluded from the ranking and traffic calculations, the results will be based on data for main keywords from groups of synonyms
default value:falsen - languageType: string | null
_code language code
optional field
if you use this field, you don't need to specifylanguage_name
you can receive the list of available languages with theirlanguage_codeby making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:en - languageType: string | null
_name full name of the language
optional field
if you use this field, you don't need to specifylanguage_code
you can receive the list of available languages with theirlanguage_nameby making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:English - limitType: integer | null
the maximum number of returned results for domain
optional field
default value:100
maximum value:1000 - locationType: integer | null
_code location code
optional field
if you use this field, you don't need to specifylocation_name
you can receive the list of available locations with theirlocation_codeby making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:2840 - locationType: string | null
_name full name of the location
optional field
if you use this field, you don't need to specifylocation_code
you can receive the list of available locations with theirlocation_nameby making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:United Kingdom - offsetType: integer | null
offset in the results array of returned items
optional field
default value:0
if you specify the10value, the first tenitemsin the results array will be omitted and the data will be provided for the successive items - tagType: string | null
user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specifiedtagvalue in thedataobject of the response - targetType: string
domain
required field
the domain name of the target website
the domain should be specified withouthttps://andwww.
- Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo200
- Type: number | null Format: doublecost
total tasks cost, USD
- Type: integer | nullstatus
_code general status code you can find the full list of the response codes here
- Type: string | nullstatus
_message general informational message you can find the full list of general informational messages here
- Type: array (object | null)[] | nulltasks
array of tasks
- Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
- costType: number | null Format: double
total tasks cost, USD
- dataType: object | null
contains the same parameters that you specified in the POST request
- propertyType: object | null
Name
- idType: string | null
task identifier unique task identifier in our system in the UUID format
- pathType: array (string | null)[] | null
URL path
- resultType: array (object | null)[] | null
array of results
- itemsType: array (object | null)[] | null
contains ranking and traffic data
- languageType: string | null
_code language code in a POST array
- locationType: integer | null
_code location code in a POST array
- metricsType: object | null
ranking data relevant to the specified domain
- propertyType: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
Name - clickstreamType: object | null
_age _distribution - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- clickstreamType: number | null Format: double
_etv estimated traffic volume based on clickstream data
calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain ranks for
to retrieve results for this field, the parameterinclude_clickstream_datamust be set totrue
learn more about how the metric is calculated in this help center article - clickstreamType: object | null
_gender _distribution - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- countType: integer | null Format: int64
total count of organic SERPs that contain the domain or subdomain
- estimatedType: number | null
_paid _traffic _cost estimated cost of converting organic search traffic into paid
represents the estimated monthly cost (USD) of running ads for all keywords in the category that the domain or subdomain ranks for
the metric is calculated as the product of organicetvand paidcpcvalues and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
learn more about how the metric is calculated in this help center article - etvType: number | null
estimated traffic volume
estimated organic monthly traffic to the domain or subdomain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the domain or subdomain ranks for
learn more about how the metric is calculated in this help center article - isType: integer | null
_down rank went down
indicates how many ranked elements of the indicated target went down - isType: integer | null
_lost lost ranked elements
indicates how many ranked elements of the indicated target were previously presented in SERPs, but weren't found during the last check - isType: integer | null
_new number of new ranked elements
indicates how many new ranked elements were found for the indicated target - isType: integer | null
_up rank went up
indicates how many ranked elements of the indicated target went up - posType: integer | null
_1 number of organic SERPs where the domain or subdomain ranks #1
- posType: integer | null
_11 _20 number of organic SERPs where the domain or subdomain ranks #11-20
- posType: integer | null
_2 _3 number of organic SERPs where the domain or subdomain ranks #2-3
- posType: integer | null
_21 _30 number of organic SERPs where the domain or subdomain ranks #21-30
- posType: integer | null
_31 _40 number of organic SERPs where the domain or subdomain ranks #31-40
- posType: integer | null
_4 _10 number of organic SERPs where the domain or subdomain ranks #4-10
- posType: integer | null
_41 _50 number of organic SERPs where the domain or subdomain ranks #41-50
- posType: integer | null
_51 _60 number of organic SERPs where the domain or subdomain ranks #51-60
- posType: integer | null
_61 _70 number of organic SERPs where the domain or subdomain ranks #61-70
- posType: integer | null
_71 _80 number of organic SERPs where the domain or subdomain ranks #71-80
- posType: integer | null
_81 _90 number of organic SERPs where the domain or subdomain ranks #81-90
- posType: integer | null
_91 _100 number of organic SERPs where the domain or subdomain ranks #91-100
- seType: string | null
_type search engine type
- itemsType: integer | null Format: int64
_count the number of results returned in the
itemsarray - languageType: string | null
_code language code in a POST array
- locationType: integer | null
_code location code in a POST array
- seType: string | null
_type search engine type
- targetType: string | null
target domain in a POST array
- totalType: integer | null Format: int64
_count total amount of results in our database relevant to your request
- resultType: integer | null Format: int64
_count number of elements in the result array
- statusType: integer | null
_code status code of the task generated by DataForSEO, can be within the following range: 10000-60000 you can find the full list of the response codes here
- statusType: string | null
_message informational message of the task you can find the full list of general informational messages here
- timeType: string | null
execution time, seconds
- Type: integer | null Format: int64tasks
_count the number of tasks in the tasks array
- Type: integer | null Format: int64tasks
_error the number of tasks in the tasks array returned with an error
- Type: string | nulltime
total execution time, seconds
- Type: string | nullversion
the current version of the API
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"language_name": "English",
"location_code": 2840
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"se_type": null,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"metrics": null
}
]
}
]
}
]
}