Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-dashboard
<?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/'; try { // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard $client = new RestClient($api_url, null, 'login', 'password'); } 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"; exit(); } try { // using this method you can get a list of categories // GET /v3/keywords_data/google_trends/categories $result = $client->get('/v3/keywords_data/google_trends/categories'); print_r($result); // do something with 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.20210917", "status_code": 20000, "status_message": "Ok.", "time": "0.0569 sec.", "cost": 0, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "09201838-1535-0175-0000-03b094f03823", "status_code": 20000, "status_message": "Ok.", "time": "0.0019 sec.", "cost": 0, "result_count": 1427, "path": [ "v3", "keywords_data", "google_trends", "categories" ], "data": { "api": "keywords_data", "function": "categories", "se": "google_trends" }, "result": [ { "category_code": 0, "category_name": "All categories", "category_code_parent": null }, { "category_code": 3, "category_name": "Arts & Entertainment", "category_code_parent": 0 }, { "category_code": 184, "category_name": "Celebrities & Entertainment News", "category_code_parent": 3 }, { "category_code": 316, "category_name": "Comics & Animation", "category_code_parent": 3 }, { "category_code": 1104, "category_name": "Animated Films", "category_code_parent": 316 }, { "category_code": 317, "category_name": "Anime & Manga", "category_code_parent": 316 }, { "category_code": 319, "category_name": "Cartoons", "category_code_parent": 316 }, { "category_code": 318, "category_name": "Comics", "category_code_parent": 316 }, { "category_code": 612, "category_name": "Entertainment Industry", "category_code_parent": 3 }, { "category_code": 1116, "category_name": "Film & TV Industry", "category_code_parent": 612 }, { "category_code": 1108, "category_name": "Film & TV Awards", "category_code_parent": 1116 }, { "category_code": 1117, "category_name": "Film & TV Production", "category_code_parent": 1116 }, { "category_code": 1115, "category_name": "Recording Industry", "category_code_parent": 612 } ] } ] }
By calling this API you will receive the list of categories supported by Google Trends API.
As a response of the API server, you will receive JSON-encoded data containing a tasks
array with the information about available categories.
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 |
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 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 parameters passed in the URL of the GET request |
result |
array | array of results |
category_code |
integer | unique google trends category identifier |
category_name |
string | name of the google trends category |
category_code_parent |
integer | the code of the superordinate category example: "category_code": 1100, "category_name": "Superhero Films", "category_code_parent": 1097 where category_code_parent corresponds to:"category_code": 1097, "category_name": "Action & Adventure Films" |