CPC Categories
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.
- Groups (
categories[]): top-level groups such as Age, Ethnicity or Body Type. A group itself can’t be picked. - Tags (
categories[].tags[]): the pickable values inside each group.
Tag fields
Keeping your copy in sync
Mirror the catalog into your own database instead of requesting it on every page load:- Fetch the catalog and store it together with
version. - Poll the endpoint periodically and compare the returned
versionwith the one you stored. - Re-sync only when
versiondiffers. It changes only when the catalog itself changes.
slug, not by name. Names can be edited, slugs stay the same.Authorizations
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.