DataForSEO · Schema
DataForSEO Domain Analytics API Schemas
SEOSERPKeywordsBacklinksDomain AnalyticsOn-Page SEOCompetitor ResearchSearch EnginesContent AnalysisE-CommerceApp StoreBusiness DataAI OptimizationSocial Media
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "DataForSEO Domain Analytics API Schemas",
"definitions": {
"DomainAnalyticsWhoisAvailableFiltersResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsWhoisAvailableFiltersTaskInfo"
}
],
"nullable": true
},
"nullable": true
}
}
}
]
},
"DomainAnalyticsWhoisAvailableFiltersTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsWhoisAvailableFiltersResultInfo"
}
],
"nullable": true
},
"nullable": true
}
}
}
]
},
"DomainAnalyticsWhoisAvailableFiltersResultInfo": {
"type": "object",
"properties": {
"overview": {
"type": "object",
"additionalProperties": {
"type": "string",
"nullable": true
},
"nullable": true
}
}
},
"BaseResponseTaskInfo": {
"properties": {
"id": {
"type": "string",
"description": "task identifier\nunique task identifier in our system in the UUID format",
"nullable": true
},
"status_code": {
"type": "integer",
"description": "status code of the task\ngenerated by DataForSEO, can be within the following range: 10000-60000\nyou can find the full list of the response codes here",
"nullable": true
},
"status_message": {
"type": "string",
"description": "informational message of the task\nyou 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
}
}
},
"BaseResponseInfo": {
"properties": {
"version": {
"type": "string",
"description": "the current version of the API",
"nullable": true
},
"status_code": {
"type": "integer",
"description": "general status code\nyou can find the full list of the response codes here",
"nullable": true
},
"status_message": {
"type": "string",
"description": "general informational message\nyou can find the full list of general informational messages here",
"nullable": true
},
"time": {
"type": "string",
"description": "total execution time, seconds",
"nullable": true
},
"cost": {
"type": "number",
"description": "total tasks cost, USD",
"format": "double",
"nullable": true
},
"tasks_count": {
"type": "integer",
"description": "the number of tasks in the tasks array",
"format": "int64",
"nullable": true
},
"tasks_error": {
"type": "integer",
"description": "the number of tasks in the tasks array returned with an error",
"format": "int64",
"nullable": true
}
}
},
"DomainAnalyticsTechnologiesDomainsByTechnologyLiveResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesDomainsByTechnologyLiveTaskInfo"
}
],
"nullable": true
},
"description": "array of tasks",
"nullable": true
}
}
}
]
},
"DomainAnalyticsTechnologiesDomainsByTechnologyLiveTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesDomainsByTechnologyLiveResultInfo"
}
],
"nullable": true
},
"description": "array of results",
"nullable": true
}
}
}
]
},
"DomainAnalyticsTechnologiesDomainsByTechnologyLiveResultInfo": {
"type": "object",
"properties": {
"total_count": {
"type": "integer",
"description": "total number of relevant items in the database",
"format": "int64",
"nullable": true
},
"items_count": {
"type": "integer",
"description": "number of items in the results array",
"format": "int64",
"nullable": true
},
"offset": {
"type": "integer",
"description": "specified offset value",
"nullable": true
},
"offset_token": {
"type": "string",
"description": "token for subsequent requests\nby specifying the unique offset_token when setting a new task, you will get the subsequent results of the initial task;\noffset_token values are unique for each subsequent task",
"nullable": true
},
"items": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesDomainsByLiveItem"
}
],
"nullable": true
},
"description": "items array",
"nullable": true
}
}
},
"DomainAnalyticsTechnologiesDomainsByLiveItem": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "type of element",
"nullable": true
},
"domain": {
"type": "string",
"description": "specified domain name",
"nullable": true
},
"title": {
"type": "string",
"description": "domain meta title",
"nullable": true
},
"description": {
"type": "string",
"description": "domain meta description",
"nullable": true
},
"meta_keywords": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"description": "domain meta keywords",
"nullable": true
},
"domain_rank": {
"type": "integer",
"description": "backlink rank of the target domain\nlearn more about the metric and how it is calculated in this help center article",
"nullable": true
},
"last_visited": {
"type": "string",
"description": "most recent date when our crawler visited the domain\nin the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d\nexample:\n2022-10-10 12:57:46 +00:00",
"nullable": true
},
"country_iso_code": {
"type": "string",
"description": "domain ISO code\nISO code of the country that target domain is determined to belong to",
"nullable": true
},
"language_code": {
"type": "string",
"description": "domain language\ncode of the language that target domain is determined to be associated with",
"nullable": true
},
"content_language_code": {
"type": "string",
"description": "content language\ncode of the language that content on the target domain is written with",
"nullable": true
},
"phone_numbers": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"description": "phone numbers of the target\ncontact phone numbers indicated on the target website",
"nullable": true
},
"emails": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"description": "emails of the target\nemails indicated on the target website",
"nullable": true
},
"social_graph_urls": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"description": "social media links and handles\nsocial media URLs detected in the social graphs of the target website",
"nullable": true
},
"technologies": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/TechnologiesInfo"
}
],
"description": "technologies used by target domain\ncontains objects with the names of technologies used on the website;\nto get a full list of technologies and their structure, refer to the technologies endpoint",
"nullable": true
}
},
"description": "items array"
},
"TechnologiesInfo": {
"type": "object",
"properties": {
"add_ons": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"analytics": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"web_development": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"security": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"business_tools": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"sales": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"other": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"user_generated_content": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"booking": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"privacy": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"servers": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"location": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"content": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"media": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"marketing": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"communication": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
},
"utilities": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"nullable": true
},
"nullable": true
}
}
},
"DomainAnalyticsTechnologiesTechnologiesSummaryLiveRequestInfo": {
"type": "object",
"properties": {
"technology_paths": {
"type": "array",
"items": {
"type": "string"
},
"description": "target technology paths\nrequired field if you don\u2019t specify groups, technologies and categories\neach technology path should be specified as a separate object containing \u201cpath\u201d and \u201cname\u201d, where \u201cpath\u201d is specified as \u201c$group_id.$category_id\u201d and \u201cname\u201d \u2013 as the name of the target technology;\neach object with a technology path should be separated with a comma\nyou can find the full list of technology group ids, category ids and technology names on this page\nnote: you can specify up to 10 technology paths in this array\nexample:\n[{\"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\nrequired field if you don\u2019t specify technologies, technology_paths, categories, or keywords\nyou can find the full list of technology group ids on this page\nnote: you can specify up to 10 technology groups in this array\nexample:\n[\"sales\", \"marketing\"]",
"nullable": true
},
"categories": {
"type": "array",
"items": {
"type": "string"
},
"description": "ids of the target technology categories\nrequired field if you don\u2019t specify groups, technology_paths, technologies, or keywords\nyou can find the full list of technology category ids on this page\nnote: you can specify up to 10 technology categories in this array\nexample:\n[\"payment_processors\",\"crm\"]",
"nullable": true
},
"technologies": {
"type": "array",
"items": {
"type": "string"
},
"description": "target technologies\nrequired field if you don\u2019t specify groups, technology_paths, categories, or keywords\nyou can find the full list of technologies you can specify here on this page\nnote: you can specify up to 10 technologies in this array\nexample:\n[\"Google Pay\",\"Salesforce\"]",
"nullable": true
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "target keywords in the domain\u2019s title, description or meta keywords\nrequired field if you don\u2019t specify groups, technology_paths, categories, or technologies\nyou can specify the maximum of 10 keywords;\nUTF-8 encoding;\nexample:\n[\"seo\",\"software\"]\nlearn 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\noptional field\npossible search mode types:\nas_is \u2013 search for results exactly matching the specified group ids, category ids, or technology names\nentry \u2013 search for results matching a part of the specified group ids, category ids, or technology names\ndefault value: as_is",
"nullable": true
},
"filters": {
"type": "array",
"items": {
"type": "object",
"nullable": true
},
"description": "array of results filtering parameters\noptional field\nyou can add several filters at once (8 filters maximum)\nyou should set a logical operator and, or between the conditions\nthe following operators are supported:\n<, <=, >, >=, =, <>, in, not_in, like,not_like\nyou can use the % operator with like and not_like to match any string of zero or more characters\nyou can use the following parameters to filter the results: domain_rank, last_visited, country_iso_code, language_code, content_language_code\nexample:\n[[\"country_iso_code\",\"=\",\"US\"],\n\"and\",\n[\"domain_rank\",\">\",800]]\nfor more information about filters, please refer to Domain Analytics Technologies API \u2013 Filters",
"nullable": true
},
"internal_list_limit": {
"type": "integer",
"description": "maximum number of elements within internal arrays\noptional field\nyou can use this field to limit the number of elements within the following arrays:\ncountries, languages, content_languages, keywords\ndefault value: 10\nminimum value: 1\nmaximum value: 10000",
"nullable": true
},
"tag": {
"type": "string",
"description": "user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response",
"nullable": true
}
},
"example": [
{
"mode": "entry",
"technologies": [
"Ngi"
],
"keywords": [
"WordPress"
],
"filters": [
[
"country_iso_code",
"=",
"US"
],
"and",
[
"domain_rank",
">",
800
]
]
}
]
},
"DomainAnalyticsTechnologiesTechnologiesResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesTechnologiesTaskInfo"
}
],
"nullable": true
},
"description": "array of tasks",
"nullable": true
}
}
}
]
},
"DomainAnalyticsTechnologiesTechnologiesTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesTechnologiesResultInfo"
}
],
"nullable": true
},
"description": "array of results",
"nullable": true
}
}
}
]
},
"DomainAnalyticsTechnologiesTechnologiesResultInfo": {
"type": "object",
"properties": {
"groups": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/Groups"
}
],
"nullable": true
},
"description": "array of technology groups",
"nullable": true
}
}
},
"Groups": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id of the technology group\nexample:\nmarketing, sales",
"nullable": true
},
"title": {
"type": "string",
"description": "title of the technology group",
"nullable": true
},
"categories": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/TechnologyCategoryInfo"
}
],
"nullable": true
},
"description": "technology categories in this group",
"nullable": true
}
}
},
"TechnologyCategoryInfo": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id of the technology category\nexample:\ncrm, cart_abandonment",
"nullable": true
},
"path": {
"type": "string",
"description": "path to the technology category\nexample:\nuser_generated_content.content_curation",
"nullable": true
},
"title": {
"type": "string",
"description": "title of the technology category",
"nullable": true
},
"technologies": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"description": "list of technologies in this category\nexample:\n\"Salesforce\", \"CareCart\"",
"nullable": true
}
}
},
"DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo"
}
],
"nullable": true
},
"description": "array of tasks",
"nullable": true
}
}
}
]
},
"DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo"
}
],
"nullable": true
},
"description": "array of results",
"nullable": true
}
}
}
]
},
"DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo": {
"type": "object",
"properties": {
"total_count": {
"type": "integer",
"description": "total number of relevant items in the database",
"format": "int64",
"nullable": true
},
"items_count": {
"type": "integer",
"description": "number of items in the results array",
"format": "int64",
"nullable": true
},
"offset": {
"type": "integer",
"description": "specified offset value",
"nullable": true
},
"offset_token": {
"type": "string",
"description": "token for subsequent requests\nby specifying the unique offset_token when setting a new task, you will get the subsequent results of the initial task;\noffset_token values are unique for each subsequent task",
"nullable": true
},
"items": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesDomainsByLiveItem"
}
],
"nullable": true
},
"description": "items array",
"nullable": true
}
}
},
"DomainAnalyticsTechnologiesTechnologiesSummaryLiveResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesTechnologiesSummaryLiveTaskInfo"
}
],
"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
}
}
}
]
},
"DomainAnalyticsTechnologiesTechnologiesSummaryLiveResultInfo": {
"type": "object",
"properties": {
"countries": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "distribution of websites by country\ncontains country codes and number of websites per country",
"nullable": true
},
"languages": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "distribution of websites by language\ncontains language codes and number of websites per language",
"nullable": true
},
"content_languages": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "distribution of websites by content language\ncontains content language codes and number of websites per language",
"nullable": true
},
"keywords": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "distribution of websites by keywords\ncontains keywords found in the websites\u2019 titles, descriptions or meta keywords, and number of websites using each keyword",
"nullable": true
}
}
},
"DomainAnalyticsTechnologiesLocationsResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesLocationsTaskInfo"
}
],
"nullable": true
},
"description": "array of tasks",
"nullable": true
}
}
}
]
},
"DomainAnalyticsTechnologiesLocationsTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/DomainAnalyticsTechnologiesLocationsResultInfo"
}
],
"nullable": true
},
"description": "array of results",
"nullable": true
}
}
}
]
},
"DomainAnalyticsT
# --- truncated at 32 KB (97 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/json-schema/dataforseo-domain-analytics-schema.json