Skip to content

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.

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.

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.