Skip to main content
GET
CPC category catalog
Каталог категорий для таргетинга CPC-виджетов. В нём два уровня:
  • Группы (categories[]): группы верхнего уровня, например Age, Ethnicity или Body Type. Саму группу выбрать нельзя.
  • Теги (categories[].tags[]): значения внутри каждой группы, которые можно выбрать.
Возвращаются только активные записи, в порядке отображения. Эндпоинт не принимает параметров и не имеет пагинации: весь каталог приходит одним ответом.

Поля тега

Синхронизация вашей копии

Зеркалируйте каталог в свою базу данных, а не запрашивайте его при каждой загрузке страницы:
  1. Получите каталог и сохраните его вместе с version.
  2. Периодически опрашивайте эндпоинт и сравнивайте полученный version с сохранённым.
  3. Синхронизируйте заново только когда version отличается. Он меняется только при изменении самого каталога.
Сопоставляйте группы и теги по slug, а не по name. Названия могут редактироваться, slug остаётся прежним.

Авторизации

Authorization
string
header
обязательно

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.

Ответ

200 - application/json

Success

status
enum<string>
Доступные опции:
success
version
string

Catalog fingerprint (16 hex chars). Changes only when the catalog changes.

Pattern: ^[0-9a-f]{16}$
count
integer

Number of top-level groups in categories.

categories
object[]