Sign in
DomainAnalytics

Changed on

‌‌ 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.

post/v3/domain_analytics/technologies/technologies_summary/live

Request

  • Base URL: https://api.dataforseo.com
  • URL: https://api.dataforseo.com/v3/domain_analytics/technologies/technologies_summary/live
  • Auth: HTTP basic

Request body

technology_pathsstring[]

<em>target technology paths</em><br><strong>required field if you don't specify <code>groups</code>, <code>technologies</code> and <code>categories</code></strong><br>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; <br>each object with a technology path should be separated with a comma<br>you can find the full list of technology group ids, category ids and technology names <a href="/v3/domain_analytics/technologies/technologies" target="_blank" rel="noopener noreferrer">on this page</a><br><strong>note:</strong> you can specify up to 10 technology paths in this array<br>example:<br><code>[{"path": "content.cms","name": "wordpress"}, {"path": "marketing.crm","name": "salesforce"}]</code>

groupsstring[]

<em>ids of the target technology groups</em><br><strong>required field if you don't specify <code>technologies</code>, <code>technology_paths</code>, <code>categories</code>, or <code>keywords</code></strong><br>you can find the full list of technology group ids <a href="/v3/domain_analytics/technologies/technologies" target="_blank" rel="noopener noreferrer">on this page</a><br><strong>note:</strong> you can specify up to 10 technology groups in this array<br>example:<br><code>["sales", "marketing"]</code>

categoriesstring[]

<em>ids of the target technology categories</em><br><strong>required field if you don't specify <code>groups</code>, <code>technology_paths</code>, <code>technologies</code>, or <code>keywords</code></strong><br>you can find the full list of technology category ids <a href="/v3/domain_analytics/technologies/technologies" target="_blank" rel="noopener noreferrer">on this page</a><br><strong>note:</strong> you can specify up to 10 technology categories in this array<br>example:<br><code>["payment_processors","crm"]</code>

technologiesstring[]

<em>target technologies</em><br><strong>required field if you don't specify <code>groups</code>, <code>technology_paths</code>, <code>categories</code>, or <code>keywords</code></strong><br>you can find the full list of technologies you can specify here <a href="/v3/domain_analytics/technologies/technologies" target="_blank" rel="noopener noreferrer">on this page</a><br><strong>note:</strong> you can specify up to 10 technologies in this array<br>example:<br><code>["Google Pay","Salesforce"]</code>

keywordsstring[]

<em>target keywords in the domain's title, description or meta keywords</em><br><strong>required field if you don't specify <code>groups</code>, <code>technology_paths</code>, <code>categories</code>, or <code>technologies</code></strong><br>you can specify the maximum of 10 keywords;<br>UTF-8 encoding;<br>example:<br><code>["seo","software"]</code><p>learn more about rules and limitations of <code>keyword</code> and <code>keywords</code> fields in DataForSEO APIs in this <a href="https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis" rel="noopener noreferrer" target="_blank">Help Center article</a>

modestring nullable

<em>search mode</em><br>optional field<br>possible search mode types:<br><code>as_is</code> - search for results exactly matching the specified group ids, category ids, or technology names<br><code>entry</code> - search for results matching a part of the specified group ids, category ids, or technology names<br>default value: <code>as_is</code>

filtersobject[] nullable

<em>array of results filtering parameters</em><br>optional field<br><strong>you can add several filters at once (8 filters maximum)</strong><br>you should set a logical operator <code>and</code>, <code>or</code> between the conditions<br>the following operators are supported:<br><code><</code>, <code><=</code>, <code>></code>, <code>>=</code>, <code>=</code>, <code><></code>, <code>in</code>, <code>not_in</code>, <code>like</code>,<code>not_like</code><br>you can use the <code>%</code> operator with <code>like</code> and <code>not_like</code> to match any string of zero or more characters<br>you can use the following parameters to filter the results: <code>domain_rank</code>, <code>last_visited</code>, <code>country_iso_code</code>, <code>language_code</code>, <code>content_language_code</code><br>example:<br><code>[["country_iso_code","=","US"],<br>"and",<br>["domain_rank",">",800]]</code><p>for more information about filters, please refer to <a href="/v3/domain_analytics/technologies/filters" target="_blank" rel="noopener noreferrer">Domain Analytics Technologies API - Filters</a>

internal_list_limitinteger nullable

<em>maximum number of elements within internal arrays</em><br>optional field<br>you can use this field to limit the number of elements within the following arrays:<br><code>countries</code>, <code>languages</code>, <code>content_languages</code>, <code>keywords</code><br>default value: <code>10</code><br>minimum value: <code>1</code><br>maximum value: <code>10000</code>

tagstring nullable

<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response

Example request

[
  {
    "mode": "entry",
    "technologies": [
      "Ngi"
    ],
    "keywords": [
      "WordPress"
    ],
    "filters": [
      [
        "country_iso_code",
        "=",
        "US"
      ],
      "and",
      [
        "domain_rank",
        ">",
        800
      ]
    ]
  }
]

Response

Successful operation

versionstring nullable

the current version of the API

status_codeinteger nullable

general status code you can find the full list of the response codes here

status_messagestring nullable

general informational message you can find the full list of general informational messages here

timestring nullable

total execution time, seconds

costnumber double nullable

total tasks cost, USD

tasks_countinteger nullable

the number of tasks in the tasks array

tasks_errorinteger nullable

the number of tasks in the tasks array returned with an error

Changes

  • ba59e41453daRevision changes
    • breaking

      the request property ///// became not nullable

    • breaking

      the request property ///// became not nullable

    • breaking

      the request property ///// became not nullable

    • breaking

      the request property ///// became not nullable

    • breaking

      the request property ///// became not nullable

  • be20fca9d9ccRevision changes
    • info

      api operation id DomainAnalyticsTechnologiesTechnologiesSummaryLive removed and replaced with TechnologiesTechnologiesSummaryLive