Pricing
Your account will not be charged for using this API
This endpoint will provide you with a full list of app categories available on Apple App Store.
You can also download the full list of supported categories in the CSV format (last updated 2023-05-02).
Your account will not be charged for using this API
By calling this API you will receive the list of categories supported by App Data 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 |
string | name of the supported app category |
count |
integer | number of app listings that make up the supported app category |
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
# 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/app_data/apple/app_listings/categories"
--header "Authorization: Basic ${cred}"
--header "Content-Type: application/json"<?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/app_data/apple/app_listings/categories
// in addition to 'apple' you can also set other search engine
// the full list of possible parameters is available in documentation
$result = $client->get('/v3/app_data/apple/app_listings/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;
?>const axios = require('axios');
axios({
method: 'get',
url: 'https://api.dataforseo.com/v3/app_data/apple/app_listings/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);
});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/app_data/apple/app_listings/categories
# in addition to 'apple' you can also set other search engine
# the full list of possible parameters is available in documentation
response = client.get("/v3/app_data/apple/app_listings/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"]))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 app_data_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/app_data/apple/app_listings/categories
// in addition to 'apple' you can also set other search engine
// the full list of possible parameters is available in documentation
var response = await httpClient.GetAsync("/v3/app_data/apple/app_listings/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:
{
"version": "0.1.20221214",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1562 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "06161845-1535-0552-0000-20b8b02898c6",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0301 sec.",
"cost": 0,
"result_count": 54,
"path": [
"v3",
"app_data",
"apple",
"app_listings",
"categories"
],
"data": {
"api": "app_data",
"function": "categories",
"se": "apple"
},
"result": [
{
"category": "Business",
"count": 116019
},
{
"category": "Education",
"count": 114472
},
{
"category": "Utilities",
"count": 98643
},
{
"category": "Lifestyle",
"count": 83976
},
{
"category": "Health & Fitness",
"count": 69260
},
{
"category": "Food & Drink",
"count": 68103
},
{
"category": "Shopping",
"count": 56584
},
{
"category": "Productivity",
"count": 56501
},
{
"category": "Entertainment",
"count": 50946
},
{
"category": "Finance",
"count": 49696
},
{
"category": "Travel",
"count": 42808
},
{
"category": "Sports",
"count": 37386
},
{
"category": "Music",
"count": 30304
},
{
"category": "Medical",
"count": 26956
},
{
"category": "Casual",
"count": 26831
},
{
"category": "Social Networking",
"count": 26393
},
{
"category": "Puzzle",
"count": 25967
},
{
"category": "Photo & Video",
"count": 23912
},
{
"category": "Games",
"count": 21880
},
{
"category": "News",
"count": 21022
},
{
"category": "Action",
"count": 20740
},
{
"category": "Reference",
"count": 18469
},
{
"category": "Simulation",
"count": 15480
},
{
"category": "Navigation",
"count": 12879
},
{
"category": "Books",
"count": 12262
},
{
"category": "Adventure",
"count": 10977
},
{
"category": "Family",
"count": 9434
},
{
"category": "Board",
"count": 7299
},
{
"category": "Role Playing",
"count": 6893
},
{
"category": "Racing",
"count": 6877
},
{
"category": "Word",
"count": 5942
},
{
"category": "Card",
"count": 5614
},
{
"category": "Trivia",
"count": 5575
},
{
"category": "Strategy",
"count": 5460
},
{
"category": "Weather",
"count": 4200
},
{
"category": "Graphics & Design",
"count": 3550
},
{
"category": "Emoji & Expressions",
"count": 2893
},
{
"category": "Casino",
"count": 2407
},
{
"category": "Animals & Nature",
"count": 2066
},
{
"category": "Magazines & Newspapers",
"count": 1910
},
{
"category": "Developer Tools",
"count": 1544
},
{
"category": "Celebrations",
"count": 1250
},
{
"category": "Comics & Cartoons",
"count": 972
},
{
"category": "Stickers",
"count": 592
},
{
"category": "Art",
"count": 431
},
{
"category": "Eating & Drinking",
"count": 361
},
{
"category": "People",
"count": 326
},
{
"category": "Places & Objects",
"count": 324
},
{
"category": "Sports & Activities",
"count": 275
},
{
"category": "Gaming",
"count": 167
},
{
"category": "Kids & Family",
"count": 152
},
{
"category": "Celebrities",
"count": 114
},
{
"category": "Movies & TV",
"count": 96
},
{
"category": "Fashion",
"count": 87
}
]
}
]
}