Technologies Summary
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.
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.
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
<?php // You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip require('RestClient.php'); $api_url = 'https://api.dataforseo.com/'; // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access $client = new RestClient($api_url, null, 'login', 'password'); $post_array = array(); // You can set only one task at a time $post_array[] = array( "technologies" => [ "Nginx" ], "keywords" => [ "WordPress" ], "filters" => [ [ "country_iso_code", "=", "US" ], "and", [ "domain_rank", ">", 800 ] ] ); try { // POST /v3/domain_analytics/technologies/technologies_summary/live $result = $client->post('/v3/domain_analytics/technologies/technologies_summary/live', $post_array); print_r($result); // do something with post result } catch (RestClientException $e) { echo "\n"; print "HTTP code: {$e->getHttpCode()}\n"; print "Error code: {$e->getCode()}\n"; print "Message: {$e->getMessage()}\n"; print $e->getTraceAsString(); echo "\n"; } $client = null; ?>
The above command returns JSON structured like this:
{ "version": "0.1.20220819", "status_code": 20000, "status_message": "Ok.", "time": "1.3292 sec.", "cost": 0.01, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "10171409-1535-0492-0000-337ee8538e4a", "status_code": 20000, "status_message": "Ok.", "time": "1.2371 sec.", "cost": 0.01, "result_count": 1, "path": [ "v3", "domain_analytics", "technologies", "technologies_summary", "live" ], "data": { "api": "domain_analytics", "function": "technologies_summary", "se": "technologies", "mode": "entry", "technologies": [ "Ngi" ], "keywords": [ "WordPress" ], "filters": [ [ "country_iso_code", "=", "US" ], "and", [ "domain_rank", ">", 800 ] ] }, "result": [ { "countries": { "US": 5 }, "languages": { "en": 4, "de": 1 }, "content_languages": { "en": 4, "de": 1 }, "keywords": { "wordpress buddypress bbpress community support forums": 2 } } ] } ] }
All POST data should be sent in the JSON format (UTF-8 encoding). The task setting is done using the POST method. When setting a task, you should send all task parameters in the task array of the generic POST array. You can send up to 2000 API requests per minute.
Description of the fields for setting a task:
Field name | Type | Description |
---|---|---|
technology_paths |
array | target technology paths required field if you don’t specify groups , technologies and categories 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"}] |
groups |
array | ids of the target technology groups required field if you don’t specify technologies , technology_paths , categories , or keywords 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"] |
categories |
array | ids of the target technology categories required field if you don’t specify groups , technology_paths , technologies , or keywords 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"] |
technologies |
array | target technologies required field if you don’t specify groups , technology_paths , categories , or keywords 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"] |
keywords |
array | target keywords in the domain’s title, description or meta keywords required field if you don’t specify groups , technology_paths , categories , or technologies you can specify the maximum of 10 keywords; UTF-8 encoding; example: ["seo","software"]
learn more about rules and limitations of |
mode |
string | search mode optional field possible search mode types: as_is – search for results exactly matching the specified group ids, category ids, or technology namesentry – search for results matching a part of the specified group ids, category ids, or technology namesdefault value: as_is |
filters |
array | 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 conditionsthe 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 charactersyou can use the following parameters to filter the results: domain_rank , last_visited , country_iso_code , language_code , content_language_code example: [["country_iso_code","=","US"],
for more information about filters, please refer to Domain Analytics Technologies API – Filters |
internal_list_limit |
integer | maximum number of elements within internal arrays optional field you can use this field to limit the number of elements within the following arrays: countries , languages , content_languages , keywords default value: 10 minimum value: 1 maximum value: 10000 |
tag |
string | 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 |
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.
Description of the fields in the results array:
Field name | Type | Description |
---|---|---|
version |
string | the current version of the API |
status_code |
integer | general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions |
status_message |
string | general informational message you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | total tasks cost, USD |
tasks_count |
integer | the number of tasks in the tasks array |
tasks_error |
integer | the number of tasks in the tasks array returned with an error |
tasks |
array | array of tasks |
id |
string | task identifier unique task identifier in our system in the UUID format |
status_code |
integer | 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 |
status_message |
string | informational message of the task you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | cost of the task, USD |
result_count |
integer | number of elements in the result array |
path |
array | URL path |
data |
object | contains the same parameters that you specified in the POST request |
result |
array | array of results |
countries |
object | distribution of websites by country contains country codes and number of websites per country |
languages |
object | distribution of websites by language contains language codes and number of websites per language |
content_languages |
object | distribution of websites by content language contains content language codes and number of websites per language |
keywords |
object | distribution of websites by keywords contains keywords found in the websites’ titles, descriptions or meta keywords, and number of websites using each keyword |