API for Publishers

The Publisher API uses Bearer Token authorization. Add an "Authorization" header with the value "Bearer X" to your request, where "X" is your personal token. The token is issued by your manager; in the publisher dashboard it is visible under "Profile and settings" ("Reset Token" — to reset). The token has no expiration.

Base URL:

Swagger documentation: https://pub.kadam.net/api-doc/
​ Accessible via API: Sources (sites), Places (blocks), Report builder (CustomReports), AdSpyGlass. Finances, payouts, wallets, notifications and referrals are available only via the dashboard (session-based authorization).
​ Terminology:
​

​

To fetch the list of sites with brief statistics, use the method POST /sources/sources-table
Data is equivalent to https://pub.kadam.net/platforms

Example request:
​

To create a site (first step), use the method PUT /sources

Example request:
​

To fetch all settings of a site, use the method GET /sources/{id}
Path parameter: id — site ID (areaID), int. Example request:
​

To add data at the next creation steps, use the method PUT /sources/{id}
Path parameter: id — site ID, int.
The body contains the site fields to update (set depends on the stage). Full schema — see Swagger: https://pub.kadam.net/api-doc/#/sources/put_sources__id_

To change the state of a site, the following methods are used:

Path parameter: id — site ID, int. No request body required. Example request:
​

To fetch the list of blocks on a site with brief statistics, use the method POST /places/places-table/{id}
Path parameter: id — site ID (areaID), int.
Data is equivalent to https://pub.kadam.net/platforms/{id} Request body is the same TableFilters object as for the sites list (page, perPage, sort, filters.dateFrom/dateTo/archive/timezone, tableFilters). Example request:
​

To fetch the list of possible include/exclude values for block table filters, use the method POST /places/places-table/table-filters

To change the state of a block, the following methods are used:

Path parameter: id — block ID (blockID), int. Example request:
​

To fetch updated user info (balance, unread notifications counter), use the method POST /users/check-upd

Example request:
​

To fetch the list of available groupings, metrics, and preconfigured periods, use the method OPTIONS /custom-reports Example request:
​

The main method for building statistics — POST /custom-reports/data

Groupings (groups):

Metrics (metrics):

Example request — statistics by country and SubID for yesterday:
​

Note: block filter — {"id": "webmaster_block", "type": "list", "include": [blockId]}.
Instead of period you can pass "dateFrom": "2026-03-01", "dateTo": "2026-03-07".
Groupings traffic_domain, traffic_macros, traffic_pid are available only from the full table and appear with a delay.

To fetch the list of possible values for a specific filter, use the method POST /custom-reports/filter-data

To fetch the list of active blocks working with AdSpyGlass, use the method GET /partners/asg/blocks

Example request:
​

To fetch data of a specific ad block, use the method GET /partners/asg/block

Example request:
​

{ "success": true, "code": 0, "msg": {}, "data": { ... } }

On error success = false, the msg field contains the error description.

List endpoints accept:

Sorting is specified as an object {"column_key": "asc"|"desc"}. Allowed keys depend on the method.

In the sites and blocks tables, filters are specified as a tableFilters array:

In the report builder — filters.filters array of the form {"id": "key", "type": "list"|"range"|"value"|"value_like"|"value_combined", "include": [...], "exclude": [...], "range": {"from": "...", "to": "..."}}.

Via Bearer Token: Sources (CRUD, activation/archive), Places (activation/archive), Report builder (statistics + filters), AdSpyGlass. Finances, payouts, wallets, notifications, referrals — only via the dashboard.