Skip to main content
Query events use Google Topics-style category paths like /Shopping/Apparel/Footwear.
If you only need first-level categories, use the list below.

Authentication

GET /v1/sync/categories requires:
  • Authorization: Bearer <api_token>

First-level categories

Endpoint

Use GET /v1/sync/categories with a table value:
  • searches
  • browsing
  • youtube
  • ads
  • receipts

Response example

Example implementation

Gotchas

  • Category filters are subtree matches. /Shopping includes /Shopping/....
  • category can be null on some records. Handle missing values in downstream logic.
  • Keep filtering server-side where possible to reduce payload size.