DataForSEO DomainAnalytics API

openapi: 3.2.0
info:
  title: DataForSEO AiOptimization Domain Analytics 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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsIdListRequestInfo'
              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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsIdListResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsErrorsRequestInfo'
              example:
              - limit: 10
                offset: 0
                filtered_function: pingback_url
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsErrorsResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesAvailableFiltersResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesLocationsResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesLanguagesResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologiesResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesAggregationTechnologiesLiveRequestInfo'
              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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesAggregationTechnologiesLiveResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologiesSummaryLiveRequestInfo'
              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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologiesSummaryLiveResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologyStatsLiveRequestInfo'
              example:
              - technology: jQuery
                date_from: '2026-01-15'
                date_to: '2026-03-15'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesTechnologyStatsLiveResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainsByTechnologyLiveRequestInfo'
              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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainsByTechnologyLiveResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveRequestInfo'
              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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainTechnologiesLiveRequestInfo'
              example:
              - target: dataforseo.com
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainTechnologiesLiveResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsWhoisAvailableFiltersResponseInfo'
      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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsWhoisOverviewLiveRequestInfo'
              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
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/DomainAnalyticsWhoisOverviewLiveResponseInfo'
      security:
      - basicAuth: []
components:
  schemas:
    DomainAnalyticsTechnologiesAvailableFiltersResultInfo:
      type: object
      properties:
        domains_by_technology:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - string
            - 'null'
            description: 'backlink rank of the domain

              the following operators are supported: <, <=, >, >=, =, <>, in, not_in

              example:

              "filters": ["domain_rank","in",[100,500]]'
        aggregation_technologies:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - string
            - 'null'
            description: 'backlink rank of the domain

              the following operators are supported: <, <=, >, >=, =, <>, in, not_in

              example:

              "filters": ["domain_rank","in",[100,500]]'
        technologies_summary:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - string
            - 'null'
            description: 'backlink rank of the domain

              the following operators are supported: <, <=, >, >=, =, <>, in, not_in

              example:

              "filters": ["domain_rank","in",[100,500]]'
        domains_by_html_terms:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - string
            - 'null'
            description: 'backlink rank of the domain

              the following operators are supported: <, <=, >, >=, =, <>, in, not_in

              example:

              "filters": ["domain_rank","in",[100,500]]'
    DomainAnalyticsTechnologiesDomainsByLiveItem:
      type: object
      properties:
        type:
          type:
          - string
          - 'null'
          description: type of element
        domain:
          type:
          - string
          - 'null'
          description: specified domain name
        title:
          type:
          - string
          - 'null'
          description: domain meta title
        description:
          type:
          - string
          - 'null'
          description: domain meta description
        meta_keywords:
          type:
          - array
          - 'null'
          items:
            type:
            - string
            - 'null'
          description: domain meta keywords
        domain_rank:
          type:
          - integer
          - 'null'
          description: 'backlink rank of the target domain

            learn more about the metric and how it is calculated in this help center article'
        last_visited:
          type:
          - string
          - 'null'
          description: 'most recent date when our crawler visited the domain

            in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”

            example:

            2022-10-10 12:57:46 +00:00'
        country_iso_code:
          type:
          - string
          - 'null'
          description: 'domain ISO code

            ISO code of the country that target domain is determined to belong to'
        language_code:
          type:
          - string
          - 'null'
          description: 'domain language

            code of the language that target domain is determined to be associated with'
        content_language_code:
          type:
          - string
          - 'null'
          description: 'content language

            code of the language that content on the target domain is written with'
        phone_numbers:
          type:
          - array
          - 'null'
          items:
            type:
            - string
            - 'null'
          description: 'phone numbers of the target

            contact phone numbers indicated on the target website'
        emails:
          type:
          - array
          - 'null'
          items:
            type:
            - string
            - 'null'
          description: 'emails of the target

            emails indicated on the target website'
        social_graph_urls:
          type:
          - array
          - 'null'
          items:
            type:
            - string
            - 'null'
          description: 'social media links and handles

            social media URLs detected in the social graphs of the target website'
        technologies:
          type:
          - object
          - 'null'
          oneOf:
          - $ref: '#/components/schemas/TechnologiesInfo'
          description: 'technologies used by target domain

            contains objects with the names of technologies used on the website;

            to get a full list of technologies and their structure, refer to the technologies endpoint'
      description: items array
    DomainAnalyticsErrorsResponseInfo:
      type: object
      allOf:
      - $ref: '#/components/schemas/BaseResponseInfo'
      - type: object
        properties:
          tasks:
            type:
            - array
            - 'null'
            items:
              type:
              - object
              - 'null'
              oneOf:
              - $ref: '#/components/schemas/DomainAnalyticsErrorsTaskInfo'
            description: array of tasks
    DomainAnalyticsIdListResultInfo:
      type: object
      properties:
        id:
          type:
          - string
          - 'null'
          description: id of the task
        url:
          type:
          - string
          - 'null'
          description: 'URL of the task

            URL you used for making an API call'
        datetime_posted:
          type:
          - string
          - 'null'
          description: 'date and time when the task was made

            in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”

            example:

            2023-01-15 12:57:46 +00:00'
        datetime_done:
          type:
          - string
          - 'null'
          description: 'date and time when the task was completed

            in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”

            example:

            2023-01-15 12:57:46 +00:00'
        status:
          type:
          - string
          - 'null'
          description: 'informational message of the task

            you can find the full list of general informational messages here'
        cost:
          type:
          - number
          - 'null'
          description: cost of the task, USD
        metadata:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - object
            - 'null'
          description: contains parameters you specified in the POST request
    MetricsBundleInfo:
      type: object
      properties:
        organic:
          type:
          - object
          - 'null'
          oneOf:
          - $ref: '#/components/schemas/MetricsInfo'
          properties:
            is_new:
              type:
              - integer
              - 'null'
              description: 'number of new ranked elements

                indicates how many new ranked elements were found for this domain'
              format: int64
            is_up:
              type:
              - integer
              - 'null'
              description: 'rank went up

                indicates how many ranked elements of this domain went up in Google Search'
              format: int64
            is_down:
              type:
              - integer
              - 'null'
              description: 'rank went down

                indicates how many ranked elements of this domain went down in Google Search'
              format: int64
            is_lost:
              type:
              - integer
              - 'null'
              description: 'lost ranked elements

                indicates how many ranked elements of this domain were previously presented in SERPs, but weren’t found during the last check'
              format: int64
          description: ranking and traffic data from organic search
        paid:
          type:
          - object
          - 'null'
          oneOf:
          - $ref: '#/components/schemas/MetricsInfo'
          description: ranking and traffic data from paid search
    DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo:
      type: object
      properties:
        total_count:
          type:
          - integer
          - 'null'
          description: total number of relevant items in the database
          format: int64
        items_count:
          type:
          - integer
          - 'null'
          description: number of items in the results array
          format: int64
        offset:
          type:
          - integer
          - 'null'
          description: specified offset value
        offset_token:
          type:
          - string
          - 'null'
          description: 'token for subsequent requests

            by specifying the unique offset_token when setting a new task, you will get the subsequent results of the initial task;

            offset_token values are unique for each subsequent task'
        items:
          type:
          - array
          - 'null'
          items:
            type:
            - object
            - 'null'
            oneOf:
            - $ref: '#/components/schemas/DomainAnalyticsTechnologiesDomainsByLiveItem'
          description: items array
    DomainAnalyticsTechnologiesAggregationTechnologiesLiveResultInfo:
      type: object
      properties:
        total_count:
          type:
          - integer
          - 'null'
          description: total amount of results in our database relevant to your request
          format: int64
        items_count:
          type:
          - integer
          - 'null'
          description: the number of results returned in the items array
          format: int64
        offset:
          type:
          - integer
          - 'null'
          description: offset in the results array of returned domains
        items:
          type:
          - array
          - 'null'
          items:
            type:
            - object
            - 'null'
            oneOf:
            - $ref: '#/components/schemas/DomainAnalyticsTechnologiesAggregationTechnologiesLiveItem'
          description: items array
    TechnologiesInfo:
      type: object
      properties:
        add_ons:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        analytics:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        web_development:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        security:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        business_tools:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        sales:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        other:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        user_generated_content:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        booking:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        privacy:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        servers:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        location:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        content:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        media:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        marketing:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        communication:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
        utilities:
          type:
          - object
          - 'null'
          additionalProperties:
            type:
            - array
            - 'null'
            items:
              type:
              - string
              - 'null'
    DomainAnalyticsTechnologiesDomainsByTechnologyLiveRequestInfo:
      type: object
      properties:
        technology_paths:
          type:
          - array
          - 'null'
          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 s

# --- truncated at 32 KB (103 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-domainanalytics-api-openapi.yml