Sign in
DomainAnalytics

Changed on

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

post/v3/domain_analytics/technologies/aggregation_technologies/live

Request

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

Request body

groupstring

<em>id of the target technology group</em><br><strong>required field if you don't specify <code>technology</code>, <code>category</code> or <code>keyword</code></strong><br>at least one field (<code>group</code>, <code>category</code>, <code>keyword</code>, <code>technology</code>) must be set<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>example:<br><code>"marketing"</code>

categorystring

<em>id of the target technology category</em><br><strong>required field if you don't specify <code>group</code>, <code>keyword</code> or <code>technology</code></strong><br>at least one field (<code>group</code>, <code>category</code>, <code>keyword</code>, <code>technology</code>) must be set<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>example:<br><code>"crm"</code>

technologystring

<em>target technology</em><br><strong>required field if you don't specify <code>group</code>, <code>keyword</code> or <code>category</code></strong><br>at least one field (<code>group</code>, <code>category</code>, <code>keyword</code>, <code>technology</code>) must be set<br>you can find the full list of technologies <a href="/v3/domain_analytics/technologies/technologies" target="_blank" rel="noopener noreferrer">on this page</a><br>example:<br><code>"Salesforce"</code>

keywordstring

<em>target keyword in the domain's meta keywords</em><br><strong>required field if you don't specify <code>group</code>, <code>category</code> or <code>technology</code></strong><br>at least one field (<code>group</code>, <code>category</code>, <code>keyword</code>, <code>technology</code>) must be set<br>UTF-8 encoding<br>example:<br><code>"seo"</code>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" target="_blank" rel="noopener noreferrer">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><strong>Note:</strong> all filtering parameters are taken from the <code>domain_technology_item</code> of the <a href="/v3/domain_analytics/technologies/filters" target="_blank" rel="noopener noreferrer">domain_technologies</a> endpoint;<br>example:<br><code>[["country_iso_code","=","US"],<br>"and",<br>["domain_rank",">",800]]</code>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>

order_bystring[] nullable

<em>results sorting rules</em><br>optional field<br>you can use the following values to sort the results: <code>groups_count</code>, <code>categories_count</code>, <code>technologies_count</code><br>possible sorting types:<br><code>asc</code> - results will be sorted in the ascending order<br><code>desc</code> - results will be sorted in the descending order<br>you should use a comma to set up a sorting type<br>example:<br><code>["groups_count,desc"]</code><br><strong>note that you can set no more than three sorting rules in a single request</strong><br>you should use a comma to separate several sorting rules<br>example:<br><code>["groups_count,desc","technologies_count,desc"]</code><br>default value:<br><code>["groups_count,desc","categories_count,desc","technologies_count,desc"]</code>

internal_groups_list_limitinteger nullable

<em>maximum number of returned technology groups</em><br>optional field<br>you can use this field to limit the number of items with identical <code>"group"</code> in the results<br>default value: <code>5</code><br>minimum value: <code>1</code><br>maximum value: <code>10000</code>

internal_categories_list_limitinteger nullable

<em>maximum number of returned technology categories within the same group</em><br>optional field<br>you can use this field to limit the number of items with identical <code>"category"</code> in the results<br>default value: <code>5</code><br>minimum value: <code>1</code><br>maximum value: <code>10000</code>

internal_technologies_list_limitinteger nullable

<em>maximum number of returned technologies within the same category</em><br>optional field<br>you can use this field to limit the number of items with identical <code>"technology"</code> in the results<br>default value: <code>10</code><br>minimum value: <code>1</code><br>maximum value: <code>10000</code>

internal_list_limitinteger nullable

<em>maximum number of items with identical <code>"category"</code>, <code>"group"</code>, and <code>"technology"</code></em><br>optional field<br>if you use this field, the values specified in <code>internal_groups_list_limit</code>, <code>internal_categories_list_limit</code> and <code>internal_technologies_list_limit</code> will be ignored;<br>you can use this field to limit the number of items with identical <code>"category"</code>, <code>"group"</code>, or <code>"technology"</code><br>default value: <code>10</code><br>minimum value: <code>1</code><br>maximum value: <code>10000</code>

limitinteger nullable

<em>the maximum number of returned technologies</em><br>optional field<br>default value: <code>100</code><br>maximum value: <code>10000</code>

offsetinteger nullable

<em>offset in the results array of returned domains</em><br>optional field<br>default value: <code>0</code><br>maximum value: <code>9999</code><br>if you specify the <code>10</code> value, the first ten technologies in the results array will be omitted and the data will be provided for the successive technologies

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",
    "technology": "Nginx",
    "keyword": "WordPress",
    "filters": [
      [
        "country_iso_code",
        "=",
        "US"
      ],
      "and",
      [
        "domain_rank",
        ">",
        800
      ]
    ],
    "order_by": [
      "groups_count,desc"
    ],
    "limit": 10
  }
]

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

  • be20fca9d9ccRevision changes
    • info

      api operation id DomainAnalyticsTechnologiesAggregationTechnologiesLive removed and replaced with TechnologiesAggregationTechnologiesLive