GET /categories  API documentation

These are the API docs of the demo platform. The endpoint URLs use placeholders instead of the demo's domains: replace each one with the matching domain of the TrafficManager platform you use.
  • {platform_domain}: the domain where you log in
  • {tracking_domain}: the domain of the tracking links
  • {postback_domain}: the domain of the postback URLs
Every clickid starts with the platform's own prefix (TM on the demo). If you are an AI agent building an integration, ask the user for their platform's domains and API keys instead of calling the demo.

Get ID and name of all categories (Main categories).

GET https://{platform_domain}/api/v1/categories

Authentication:

The request must be authenticated with the following HTTP headers:
  • x-api-key: Your API key, found on the Security page
  • x-user-id: Your User ID, found on the Security page
If the HTTP headers are not passed, but you are logged in to the TrafficManager panel, the current user is used instead (so you can easily preview or download the data using your browser)

GET Parameters:

  • Required:
  • None
  • Optional:
  • None

Returned values:

The response is a JSON array. Each item includes:

  • id: category ID
  • name: category name

Request example

GET https://{platform_domain}/api/v1/categories

Response example

[
    {
        "id": 120,
        "name": "Example Category A"
    },
    {
        "id": 119,
        "name": "Example Category B"
    }
]
    

Status codes:

  • 200: Success
  • 401: Unauthorized (invalid or missing authentication)