Countries & categories
Directory endpoints return a JSON collection. Use them to discover country codes and store-specific category IDs before building a data request.
| Method | Route | Returns |
|---|---|---|
GET |
/api/countries |
Supported countries. |
GET |
/api/:store/categories |
Categories for the selected store. |
GET |
/api/tags |
Available tags; see the Tag library. |
No query parameters are required for countries or categories. Send your session token in the Authorization header.
Read the response
Section titled “Read the response”Countries are returned as an array of strings. Categories are returned as an array of objects with these fields:
| Field | Description |
|---|---|
id |
Integer, store-specific category ID. |
name |
String, category name. |
parent_id |
Integer or null, parent category ID; null when the category has no parent. |
Try it
Section titled “Try it”Start with the country list. Select Store categories to retrieve categories for a specific app store. The code tabs generate equivalent requests in cURL, Node.js, and Python.