Core APIs
Categories API
Overview
2min
categories api overview target have a large product hierachy and to make navigating this easier redcircle api provides the categories api to allow you to retrieve category id values for different levels of the target hierarchy category id values returned by the categories api can be used in subsequent category https //docs trajectdata com/redcircleapi/target product data api/parameters/category api requests to show category listings from the given category this is useful for use cases such as "iterating all of the products in a category" whilst most of the time the category id 's returned by the categories api are "static", it's expected that target's category hierarchy will change over time redcircle api continuously updates the categories api dataset to capture these changes it's advised that, if your code relies on showing the category hierarchy to users, you periodically refresh your cached hierarchy from the categories api categories api cost & rate limits each request to the categories api counts against your monthly request quota so it's recommended that you cache the categories api response locally and use your local copy for lookups within your app the categories api has a rate limit of 2000 requests per minute as well as interacting with the categories api programmatically redcircle api provides a visual categories browser https //app redcircleapi com/categories on the dashboard, as shown below you can use this to visually explore the target hierarchy and generate sample category https //docs trajectdata com/redcircleapi/target product data api/parameters/category api requests you can browse the category hierarchy visually using the categories browser https //app redcircleapi com/categories next steps listing & searching categories https //docs trajectdata com/redcircleapi/categories api/list and search