openapi: 3.0.1
info:
title: DataForSEO AiOptimization DomainAnalytics API
description: DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget. DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
version: 1.0.0
servers:
- url: https://api.dataforseo.com
- url: https://sandbox.dataforseo.com
tags:
- name: DomainAnalytics
paths:
/v3/domain_analytics/id_list:
post:
tags:
- DomainAnalytics
description: 'This endpoint is designed to provide you with a list of IDs and metadata for all Domain Analytics tasks created within the specified time period, including both successful and uncompleted tasks.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/id_list/?bash'''
operationId: DomainAnalyticsIdList
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsIdListRequestInfo'
nullable: true
example:
- datetime_from: '2026-04-12 04:39:39 +00:00'
datetime_to: '2026-04-14 04:39:39 +00:00'
limit: 100
offset: 0
sort: desc
include_metadata: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsIdListResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/errors:
post:
tags:
- DomainAnalytics
description: 'By calling this endpoint you will receive information about the Domain Analytics API tasks that returned an error within the past 7 days.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/errors/?bash'''
operationId: DomainAnalyticsErrors
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsErrorsRequestInfo'
nullable: true
example:
- limit: 10
offset: 0
filtered_function: pingback_url
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsErrorsResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/available_filters:
get:
tags:
- DomainAnalytics
description: 'Here you will find all the necessary information about filters that can be used with Domain Analytics Technologies API endpoints.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/filters/?bash'''
operationId: TechnologiesAvailableFilters
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesAvailableFiltersResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/locations:
get:
tags:
- DomainAnalytics
description: 'You will receive the list of locations by this API call.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/locations/?bash'''
operationId: TechnologiesLocations
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesLocationsResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/languages:
get:
tags:
- DomainAnalytics
description: 'You will receive the list of languages by calling this API.
As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/languages/?bash'''
operationId: TechnologiesLanguages
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesLanguagesResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/technologies:
get:
tags:
- DomainAnalytics
description: 'This endpoint will provide you with the full list of available technologies structured by technology groups and categories each particular technology belongs to.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/technologies/?bash'''
operationId: TechnologiesTechnologies
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologiesResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/aggregation_technologies/live:
post:
tags:
- DomainAnalytics
description: 'The Aggregation Technologies endpoint will provide you with a list of the most popular technologies websites use alongside the technologies you specify. Alternatively, you can specify technology categories or groups to obtain wider stats.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/aggregation_technologies/live/?bash'''
operationId: TechnologiesAggregationTechnologiesLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesAggregationTechnologiesLiveRequestInfo'
nullable: true
example:
- mode: entry
technology: Nginx
keyword: WordPress
filters:
- - country_iso_code
- '='
- US
- and
- - domain_rank
- '>'
- 800
order_by:
- groups_count,desc
limit: 10
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesAggregationTechnologiesLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/technologies_summary/live:
post:
tags:
- DomainAnalytics
description: 'The Technologies Summary endpoint will provide you with the number of domains across different countries and languages that use the specified technology names, technology groups, or technology categories.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/technologies_summary/live/?bash'''
operationId: TechnologiesTechnologiesSummaryLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologiesSummaryLiveRequestInfo'
nullable: true
example:
- mode: entry
technologies:
- Ngi
keywords:
- WordPress
filters:
- - country_iso_code
- '='
- US
- and
- - domain_rank
- '>'
- 800
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologiesSummaryLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/technology_stats/live:
post:
tags:
- DomainAnalytics
description: 'The Technology Stats endpoint will provide you with historical data on the number of domains across different countries and languages that use the specified technology.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/technology_stats/live/?bash'''
operationId: TechnologiesTechnologyStatsLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologyStatsLiveRequestInfo'
nullable: true
example:
- technology: jQuery
date_from: '2026-01-15'
date_to: '2026-03-15'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologyStatsLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/domains_by_technology/live:
post:
tags:
- DomainAnalytics
description: 'This endpoint provides domains based on the technology they use. In addition to the list of domains, you will also get their technology profiles, the country and language they belong to, and other related data.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/domains_by_technology/live/?bash'''
operationId: TechnologiesDomainsByTechnologyLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainsByTechnologyLiveRequestInfo'
nullable: true
example:
- technologies:
- Nginx
filters:
- - country_iso_code
- '='
- US
- and
- - domain_rank
- '>'
- 800
order_by:
- last_visited,desc
limit: 10
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainsByTechnologyLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/domains_by_html_terms/live:
post:
tags:
- DomainAnalytics
description: 'This endpoint provides domains based on the HTML terms they use on their homepage. In addition to the list of domains, you will also get their technology profiles, the country and language they belong to, and other related data.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/domains_by_html_terms/live/?bash'''
operationId: TechnologiesDomainsByHtmlTermsLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveRequestInfo'
nullable: true
example:
- search_terms:
- data-attrid
order_by:
- last_visited,desc
limit: 10
offset: 0
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/technologies/domain_technologies/live:
post:
tags:
- DomainAnalytics
description: 'Using this endpoint you will get a list of technologies used in a particular domain.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/technologies/domain_technologies/live/?bash'''
operationId: TechnologiesDomainTechnologiesLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainTechnologiesLiveRequestInfo'
nullable: true
example:
- target: dataforseo.com
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainTechnologiesLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/whois/available_filters:
get:
tags:
- DomainAnalytics
description: 'Here you will find all the necessary information about filters that can be used with Domain Analytics Whois API.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/whois/filters/?bash'''
operationId: WhoisAvailableFilters
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsWhoisAvailableFiltersResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/domain_analytics/whois/overview/live:
post:
tags:
- DomainAnalytics
description: 'This endpoint will provide you with Whois data enriched with backlink stats, and ranking and traffic info from organic and paid search results. Using this endpoint you will be able to get all these data for the domains matching the parameters you specify in the request.
for more info please visit ''https://docs.dataforseo.com/v3/domain_analytics/whois/overview/live/?bash'''
operationId: WhoisOverviewLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsWhoisOverviewLiveRequestInfo'
nullable: true
example:
- limit: 2
filters:
- - epp_status_codes
- in
- - client_transfer_prohibited
- client_update_prohibited
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsWhoisOverviewLiveResponseInfo'
nullable: true
security:
- basicAuth: []
components:
schemas:
BaseResponseTaskInfo:
properties:
id:
type: string
description: 'task identifier
unique task identifier in our system in the UUID format'
nullable: true
status_code:
type: integer
description: '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'
nullable: true
status_message:
type: string
description: 'informational message of the task
you can find the full list of general informational messages here'
nullable: true
time:
type: string
description: execution time, seconds
nullable: true
cost:
type: number
description: total tasks cost, USD
format: double
nullable: true
result_count:
type: integer
description: number of elements in the result array
format: int64
nullable: true
path:
type: array
items:
type: string
nullable: true
description: URL path
nullable: true
data:
type: object
additionalProperties:
type: object
nullable: true
description: contains the same parameters that you specified in the POST request
nullable: true
DomainAnalyticsIdListRequestInfo:
type: object
properties:
datetime_from:
type: string
description: 'start time for filtering results
required field
if include_metadata is set to true, maximum value: a month from current datetime;
if include_metadata is set to false, maximum value: six months from current datetime;
must be specified in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2023-01-15 12:57:46 +00:00'
datetime_to:
type: string
description: 'finish time for filtering results
required field
maximum value: current datetime;
must be specified in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2023-01-31 13:57:46 +00:00'
limit:
type: integer
description: 'the maximum number of returned task IDs
optional field
default value: 1000
maximum value: 1000'
nullable: true
offset:
type: integer
description: 'offset in the results array of returned task IDs
optional field
default value: 0
if you specify the 10 value, the first ten tasks in the results array will be omitted'
nullable: true
sort:
type: string
description: 'sorting by task execution time
optional field
possible values: "asc", "desc"
default value: "asc"'
nullable: true
include_metadata:
type: boolean
description: 'include task metadata in the respond
optional field
default value: false'
nullable: true
example:
- datetime_from: '2026-04-12 04:39:39 +00:00'
datetime_to: '2026-04-14 04:39:39 +00:00'
limit: 100
offset: 0
sort: desc
include_metadata: true
DomainAnalyticsErrorsRequestInfo:
type: object
properties:
limit:
type: integer
description: 'the maximum number of returned tasks that responded with an error
optional field
default value: 1000
maximum value: 1000'
nullable: true
offset:
type: integer
description: 'offset in the results array of returned tasks
optional field
default value: 0
if you specify the 10 value, the first ten tasks in the results array will be omitted and the data will be provided for the successive tasks'
nullable: true
filtered_function:
type: string
description: 'return tasks with a certain function
use this field to obtain a list of tasks that returned an error filtered by a certain function
you can filter the results by the values you receive in the function fields of the API response
i.e., once you receive unfiltered results, you can call this API again to filter them by function
example: domain_analytics/task_get, postback_url, pingback_url'
nullable: true
datetime_from:
type: string
description: 'start time for filtering results
optional field
allows filtering results by the datetime parameter within the range of the last 7 days;
must be specified in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2021-11-15 12:57:46 +00:00'
nullable: true
datetime_to:
type: string
description: 'finish time for filtering results
optional field
allows filtering results by the datetime parameter within the range of the last 7 days;
must be specified in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2021-11-15 13:57:46 +00:00'
nullable: true
example:
- limit: 10
offset: 0
filtered_function: pingback_url
DomainAnalyticsTechnologiesAvailableFiltersResponseInfo:
type: object
allOf:
- $ref: '#/components/schemas/BaseResponseInfo'
- type: object
properties:
tasks:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesAvailableFiltersTaskInfo'
nullable: true
nullable: true
DomainAnalyticsTechnologiesTechnologyStatsLiveRequestInfo:
type: object
properties:
technology:
type: string
description: 'target technology
required field
you can find the full list of technologies you can specify here on this page
example:
"Salesforce"'
date_from:
type: string
description: 'starting date of the time range
optional field
minimum value: 2022-10-31
if you don’t specify this field, the minimum value will be used by default
date format: "yyyy-mm-dd"
example:
"2023-06-01"'
nullable: true
date_to:
type: string
description: 'ending date of the time range
optional field
if you don’t specify this field, the today’s date will be used by default
date format: "yyyy-mm-dd"
example:
"2023-01-15"'
nullable: true
tag:
type: string
description: '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 specified tag value in the data object of the response'
nullable: true
example:
- technology: jQuery
date_from: '2026-01-15'
date_to: '2026-03-15'
DomainAnalyticsTechnologiesLanguagesResponseInfo:
type: object
allOf:
- $ref: '#/components/schemas/BaseResponseInfo'
- type: object
properties:
tasks:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesLanguagesTaskInfo'
nullable: true
description: array of tasks
nullable: true
DomainAnalyticsTechnologiesTechnologiesSummaryLiveTaskInfo:
type: object
allOf:
- $ref: '#/components/schemas/BaseResponseTaskInfo'
- type: object
properties:
result:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologiesSummaryLiveResultInfo'
nullable: true
description: array of results
nullable: true
DomainAnalyticsTechnologiesDomainsByTechnologyLiveRequestInfo:
type: object
properties:
technology_paths:
type: array
items:
type: string
description: 'target technology paths
required field if you don’t specify groups, technologies, keywords or categories
at least one field (technology_paths, groups, technologies, keywords or categories) must be set;
each technology path should be specified as a separate object containing “path” and “name”, where “path” is specified as “$group_id.$category_id” and “name” – as the name of the target technology;
each object with a technology path should be separated with a comma
you can find the full list of technology group ids, category ids and technology names on this page
note: you can specify up to 10 technology paths in this array
example:
[{"path": "content.cms","name": "wordpress"}, {"path": "marketing.crm","name": "salesforce"}]'
nullable: true
groups:
type: array
items:
type: string
description: 'ids of the target technology groups
required field if you don’t specify technologies, technology_paths, keywords or categories
you can find the full list of technology group ids on this page
note: you can specify up to 10 technology groups in this array
example:
["sales", "marketing"]'
nullable: true
categories:
type: array
items:
type: string
description: 'ids of the target technology categories
required field if you don’t specify groups, technology_paths, keywords or technologies
you can find the full list of technology category ids on this page
note: you can specify up to 10 technology categories in this array
example:
["payment_processors","crm"]'
nullable: true
technologies:
type: array
items:
type: string
description: 'target technologies
required field if you don’t specify groups, technology_paths, keywords or categories
you can find the full list of technologies you can specify here on this page
note: you can specify up to 10 technologies in this array
example:
["Google Pay","Salesforce"]'
nullable: true
keywords:
type: array
items:
type: string
description: 'target keywords in the domain’s title, description or meta keywords
required field if you don’t specify groups, technology_paths, technologies or categories
optional field
you can specify the maximum of 10 keywords;
UTF-8 encoding;
example:
["seo","software"]
learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article'
nullable: true
mode:
type: string
description: 'search mode
optional field
possible search mode types:
as_is – search for results exactly matching the specified group ids, category ids, or technology names
entry – search for results matching a part of the specified group ids, category ids, or technology names
default value: as_is'
nullable: true
filters:
type: array
items:
type: object
nullable: true
description: 'array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:
<, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:
["country_iso_code","=","US"]
[["country_iso_code","=","US"],
"and",
["domain_rank",">",100]]
[["domain_rank",">",100],
"and",
[["country_iso_code","=","US"],"or",["country_iso_code","=","CA"]]]
for more information about filters, please refer to Domain Analytics Technologies API – Filters'
nullable: true
order_by:
type: array
items:
type: string
description: 'results sorting rules
optional field
available fields:
domain_rank, domain, last_visited, country_iso_code, language_code, content_language_code
possible sorting types:
asc – results will be sorted in the ascending order
desc – results will be sorted in the descending order
you should use a comma to set up a sorting type
example:
["last_visited,desc"]
default rule:
["domain_rank,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:
["last_visited,desc","domain_rank,desc"]'
nullable: true
limit:
type: integer
description: 'the maximum number of returned domains
optional field
default value: 100
maximum value: 10000'
nullable: true
offset:
type: integer
description: 'offset in the results array of returned domains
optional field
default value: 0
if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive domains;
Note: the maximum value is 9999, the sum of limit and offset must not exceed 10000;
use the offset_token if you would like to offset more results'
nullable: true
offset_token:
type: string
description: '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 unique offset_token value from the response array, you will get the subsequent results of the initial task;
offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters should be iden
# --- truncated at 32 KB (101 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-domainanalytics-api-openapi.yml