CPC-категории
The canonical category catalog used to target CPC widgets: top-level groups (Age, Ethnicity, Body Type, …), each with its pickable tags. Only active entries are returned, in display order.
Mirror it into your own DB. version is a fingerprint of the whole catalog and changes only when the catalog changes, so poll it and re-sync only when it differs from the one you stored.
No parameters, no pagination: the full catalog is returned in one response.
- Группы (
categories[]): группы верхнего уровня, например Age, Ethnicity или Body Type. Саму группу выбрать нельзя. - Теги (
categories[].tags[]): значения внутри каждой группы, которые можно выбрать.
Поля тега
Синхронизация вашей копии
Зеркалируйте каталог в свою базу данных, а не запрашивайте его при каждой загрузке страницы:- Получите каталог и сохраните его вместе с
version. - Периодически опрашивайте эндпоинт и сравнивайте полученный
versionс сохранённым. - Синхронизируйте заново только когда
versionотличается. Он меняется только при изменении самого каталога.
slug, а не по name. Названия могут редактироваться, slug остаётся прежним.Авторизации
API key from the partner cabinet, Tools -> API (https://partners.onlytraffic.com/tools/api): up to 5 named keys per account, each Full or Read-only, ot_partners_ prefix, shown once at creation. Raw value or Bearer form. Read-only keys cannot call the POST endpoints (403 This API key is read-only); expired or revoked keys get 403 Error! Access denied.