API reference

List the category taxonomy

GET/v1/categories

Response

Field	Type	Description
`request_id`required	string	Unique ID of this request.
`categories`required	object[]
`id`required	string
`name`required	string
`subcategories`required	object[]
`id`required	string
`name`required	string

Status codes

200
Top-level categories with their subcategories.
401
Missing, invalid or revoked API key, or a suspended account.
Error code unauthorized
429
Too many requests per second. Retry after the number of seconds in Retry-After.
Error code rate_limited

Try it

Runs through the playground, no key needed

Request

curl https://api.descriptorapi.com/v1/categories \
  -H "Authorization: Bearer $DESCRIPTORAPI_KEY"

req, _ := http.NewRequest("GET", "https://api.descriptorapi.com/v1/categories", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("DESCRIPTORAPI_KEY"))
resp, err := http.DefaultClient.Do(req)

const res = await fetch("https://api.descriptorapi.com/v1/categories", {
  headers: {
    Authorization: `Bearer ${process.env.DESCRIPTORAPI_KEY}`,
  },
});
const data = await res.json();

import os, requests

res = requests.yget(
    "https://api.descriptorapi.com/v1/categories",
    headers={"Authorization": f"Bearer {os.environ['DESCRIPTORAPI_KEY']}"},
    timeout=10,
)
data = res.json()

$ch = curl_init("https://api.descriptorapi.com/v1/categories");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('DESCRIPTORAPI_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Response · 200 OK

{
  "request_id": "req_01JABCDEF0123456789ABCDEFG",
  "categories": [
    {
      "id": "transportation",
      "name": "Transportation",
      "subcategories": [
        {
          "id": "ride_hailing",
          "name": "Ride hailing"
        }
      ]
    }
  ]
}