keywords_data/google_trends/categories

List of Google Trends Categories

Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access \
login="login" 
password="password" 
cred="$(printf ${login}:${password} | base64)" 
curl --location --request GET "https://api.dataforseo.com/v3/keywords_data/google_trends/categories" \
--header "Authorization: Basic ${cred}"  \
--header "Content-Type: application/json" \
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access \
login="login" 
password="password" 
cred="$(printf ${login}:${password} | base64)" 
curl --location --request GET "https://api.dataforseo.com/v3/keywords_data/google_trends/categories" \
--header "Authorization: Basic ${cred}"  \
--header "Content-Type: application/json" \
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access \
login="login" 
password="password" 
cred="$(printf ${login}:${password} | base64)" 
curl --location --request GET "https://api.dataforseo.com/v3/keywords_data/google_trends/categories" \
--header "Authorization: Basic ${cred}"  \
--header "Content-Type: application/json" \

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
<?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-access
  $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;
?>
<?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-access
  $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;
?>
<?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-access
	$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;
?>

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
from client import RestClient
# You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip
client = RestClient("login", "password")
# using this method you can get a list of categories
# GET /v3/keywords_data/google_trends/categories
response = client.get("/v3/keywords_data/google_trends/categories")
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response["status_code"] == 20000:
    print(response)
    # do something with result
else:
    print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))
from client import RestClient
# You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip
client = RestClient("login", "password")
# using this method you can get a list of categories
# GET /v3/keywords_data/google_trends/categories
response = client.get("/v3/keywords_data/google_trends/categories")
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response["status_code"] == 20000:
    print(response)
    # do something with result
else:
    print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))
from client import RestClient
# You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip
client = RestClient("login", "password")
# using this method you can get a list of categories
# GET /v3/keywords_data/google_trends/categories
response = client.get("/v3/keywords_data/google_trends/categories")
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response["status_code"] == 20000:
    print(response)
    # do something with result
else:
    print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
const axios = require('axios');
axios({
    method: 'get',
    url: 'https://api.dataforseo.com/v3/keywords_data/google_trends/categories',
    auth: {
        username: 'login',
        password: 'password'
    },
    headers: {
        'content-type': 'application/json'
    }
}).then(function (response) {
    var result = response['data']['tasks'][0]['result'];
    // Result data
    console.log(result);
}).catch(function (error) {
    console.log(error);
});
const axios = require('axios');

axios({
    method: 'get',
    url: 'https://api.dataforseo.com/v3/keywords_data/google_trends/categories',
    auth: {
        username: 'login',
        password: 'password'
    },
    headers: {
        'content-type': 'application/json'
    }
}).then(function (response) {
    var result = response['data']['tasks'][0]['result'];
    // Result data
    console.log(result);
}).catch(function (error) {
    console.log(error);
});
const axios = require('axios');

axios({
    method: 'get',
    url: 'https://api.dataforseo.com/v3/keywords_data/google_trends/categories',
    auth: {
        username: 'login',
        password: 'password'
    },
    headers: {
        'content-type': 'application/json'
    }
}).then(function (response) {
    var result = response['data']['tasks'][0]['result'];
    // Result data
    console.log(result);
}).catch(function (error) {
    console.log(error);
});

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
using Newtonsoft.Json;
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace DataForSeoDemos
{
    public static partial class Demos
    {
        public static async Task keywords_data_trends_categories()
        {
            var httpClient = new HttpClient
            {
                BaseAddress = new Uri("https://api.dataforseo.com/"),
                // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
                DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
            };
            // using this method you can get a list of categories
            // GET /v3/keywords_data/google_trends/categories
            var response = await httpClient.GetAsync("/v3/keywords_data/google_trends/categories");
            var result = JsonConvert.DeserializeObject<dynamic>(await response.Content.ReadAsStringAsync());
            // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
            if (result.status_code == 20000)
            {
                // do something with result
                Console.WriteLine(result);
            }
            else
                Console.WriteLine($"error. Code: {result.status_code} Message: {result.status_message}");
        }
    }
}
using Newtonsoft.Json;
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

namespace DataForSeoDemos
{
    public static partial class Demos
    {
        public static async Task keywords_data_trends_categories()
        {
            var httpClient = new HttpClient
            {
                BaseAddress = new Uri("https://api.dataforseo.com/"),
                // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
                DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
            };
            // using this method you can get a list of categories
            // GET /v3/keywords_data/google_trends/categories
            var response = await httpClient.GetAsync("/v3/keywords_data/google_trends/categories");
            var result = JsonConvert.DeserializeObject<dynamic>(await response.Content.ReadAsStringAsync());
            // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
            if (result.status_code == 20000)
            {
                // do something with result
                Console.WriteLine(result);
            }
            else
                Console.WriteLine($"error. Code: {result.status_code} Message: {result.status_message}");
        }
    }
}
using Newtonsoft.Json;
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

namespace DataForSeoDemos
{
    public static partial class Demos
    {
        public static async Task keywords_data_trends_categories()
        {
            var httpClient = new HttpClient
            {
                BaseAddress = new Uri("https://api.dataforseo.com/"),
                // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
                DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
            };
            // using this method you can get a list of categories
            // GET /v3/keywords_data/google_trends/categories
            var response = await httpClient.GetAsync("/v3/keywords_data/google_trends/categories");
            var result = JsonConvert.DeserializeObject<dynamic>(await response.Content.ReadAsStringAsync());
            // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
            if (result.status_code == 20000)
            {
                // do something with result
                Console.WriteLine(result);
            }
            else
                Console.WriteLine($"error. Code: {result.status_code} Message: {result.status_message}");
        }
    }
}

The above command returns JSON structured like this:

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
{
  "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
        }
      ]
    }
  ]
}
{
  "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
        }
      ]
    }
  ]
}
{
  "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"`