DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Domain Whois Overview
Whois records enriched with SEO metrics. Each item carries domain, created_datetime, changed_datetime, expiration_datetime, updated_datetime, first_seen, epp_status_codes, tld, registered, registrar, plus metrics and backlinks_info. Paged with limit, offset and offset_token, filtered over the fields in get_dataforseo_domains_whois_available_filters.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.012.
- 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)[]
- filtersType: array (object | null)[] | null
array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operatorand,orbetween the conditions
the following operators are supported:regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
you can use the%operator withlikeandnot_liketo match any string of zero or more charactersEmpty object - limitType: integer | null
the maximum number of returned domains
optional field
default value:100
maximum value:1000 - 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;
Note: we recommend using this parameter only when retrieving up to 10,000 results for retrieving over 10,000 results, use theoffset_tokeninstead - offsetType: string | null
_token token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;
by specifying the uniqueoffset_tokenvalue from the response array, you will get the subsequent results of the initial task;offset_tokenvalues are unique for each subsequent task
Note: if theoffset_tokenis specified in the request, all other parameters should be identical to the previous request
learn more about this parameter on our Help Center - orderType: array string[] | null
_by results sorting rules
optional field
you can use the same values as in thefiltersarray to sort the results
possible sorting types:asc- results will be sorted in the ascending orderdesc- results will be sorted in the descending order
the comma is used as a separator
example:["metrics.organic.pos_1,desc"]
default rule:["metrics.organic.count,desc"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:["expiration_datetime,asc","metrics.organic.etv,desc","metrics.organic.pos_1,desc"] - 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
- Type: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo200
- 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_DomainAnalyticsWhoisOverviewLiveTaskInfo
- 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
items array
- backlinksType: object | null · Response36Afe1097B20_BacklinksInfo
_info backlink data for the returned domain
- backlinksType: integer | null Format: int64
average number of backlinks
- dofollowType: integer | null Format: int64
average number of dofollow links
- referringType: integer | null Format: int64
_domains average number of referring domains
- referringType: integer | null Format: int64
_main _domains average number of referring main domains
- referringType: integer | null Format: int64
_pages average number of referring pages
- timeType: string | null
_update date and time when backlink data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00
- changedType: string | null
_datetime - createdType: string | null
_datetime - domainType: string | null
domain name
- eppType: array (string | null)[] | null
_status _codes - expirationType: string | null
_datetime - firstType: string | null
_seen date and time when our crawler found the domain for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:"2019-11-15 12:57:46 +00:00" - metricsType: object | null · Response36Afe1097B20_MetricsBundleInfo
ranking data relevant to the specified domain
- organicType: object | null · Response36Afe1097B20_MetricsInfo
ranking and traffic data from organic search
- countType: integer | null Format: int64
total count of organic SERPs that contain the domain
- estimatedType: number | null
_paid _traffic _cost estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads (USD) for all keywords a domain 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
- isType: integer | null Format: int64
_down rank went down indicates how many ranked elements of this domain went down in Google Search
- isType: integer | null Format: int64
_lost lost ranked elements indicates how many ranked elements of this domain were previously presented in SERPs, but weren’t found during the last check
- isType: integer | null Format: int64
_new number of new ranked elements indicates how many new ranked elements were found for this domain
- isType: integer | null Format: int64
_up rank went up indicates how many ranked elements of this domain went up in Google Search
- posType: integer | null
_1 number of organic SERPs where the domain ranks #1
- posType: integer | null
_11 _20 number of organic SERPs where the domain ranks #11-20
- posType: integer | null
_2 _3 number of organic SERPs where the domain ranks #2-3
- posType: integer | null
_21 _30 number of organic SERPs where the domain ranks #21-30
- posType: integer | null
_31 _40 number of organic SERPs where the domain ranks #31-40
- posType: integer | null
_4 _10 number of organic SERPs where the domain ranks #4-10
- posType: integer | null
_41 _50 number of organic SERPs where the domain ranks #41-50
- posType: integer | null
_51 _60 number of organic SERPs where the domain ranks #51-60
- posType: integer | null
_61 _70 number of organic SERPs where the domain ranks #61-70
- posType: integer | null
_71 _80 number of organic SERPs where the domain ranks #71-80
- posType: integer | null
_81 _90 number of organic SERPs where the domain ranks #81-90
- posType: integer | null
_91 _100 number of organic SERPs where the domain ranks #91-100
- paidType: object | null · Response36Afe1097B20_MetricsInfo
ranking and traffic data from paid search
- countType: integer | null Format: int64
total count of organic SERPs that contain the domain
- estimatedType: number | null
_paid _traffic _cost estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads (USD) for all keywords a domain 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
- isType: integer | null Format: int64
_down rank went down indicates how many ranked elements of this domain went down in Google Search
- isType: integer | null Format: int64
_lost lost ranked elements indicates how many ranked elements of this domain were previously presented in SERPs, but weren’t found during the last check
- isType: integer | null Format: int64
_new number of new ranked elements indicates how many new ranked elements were found for this domain
- isType: integer | null Format: int64
_up rank went up indicates how many ranked elements of this domain went up in Google Search
- posType: integer | null
_1 number of organic SERPs where the domain ranks #1
- posType: integer | null
_11 _20 number of organic SERPs where the domain ranks #11-20
- posType: integer | null
_2 _3 number of organic SERPs where the domain ranks #2-3
- posType: integer | null
_21 _30 number of organic SERPs where the domain ranks #21-30
- posType: integer | null
_31 _40 number of organic SERPs where the domain ranks #31-40
- posType: integer | null
_4 _10 number of organic SERPs where the domain ranks #4-10
- posType: integer | null
_41 _50 number of organic SERPs where the domain ranks #41-50
- posType: integer | null
_51 _60 number of organic SERPs where the domain ranks #51-60
- posType: integer | null
_61 _70 number of organic SERPs where the domain ranks #61-70
- posType: integer | null
_71 _80 number of organic SERPs where the domain ranks #71-80
- posType: integer | null
_81 _90 number of organic SERPs where the domain ranks #81-90
- posType: integer | null
_91 _100 number of organic SERPs where the domain ranks #91-100
- registeredType: boolean | null
domain registration status
iffalse, the domain name registration has expired
Note: expired domains will remain in the database for only a short period of time - registrarType: string | null
domain registrar
ifnull, the domain registrar is unknown
example:NameCheap, Inc. - tldType: string | null
- updatedType: string | null
_datetime
- itemsType: integer | null Format: int64
_count the number of results returned in the
itemsarray - offsetType: integer | null
results offset value specified in POST request
- offsetType: string | null
_token - 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/domain_analytics/whois/overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"limit": 2,
"filters": [
[
"epp_status_codes",
"in",
[
"client_transfer_prohibited",
"client_update_prohibited"
]
]
]
}
]'
{
"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": [
{
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"domain": null,
"created_datetime": null,
"changed_datetime": null,
"expiration_datetime": null,
"updated_datetime": null,
"first_seen": null,
"epp_status_codes": [
"[Max Depth Exceeded]"
],
"tld": null,
"registered": null,
"registrar": null,
"metrics": "[Max Depth Exceeded]",
"backlinks_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}