CartrouteReference data: retailers and categories
GET /api/v1/retailers and GET /api/v1/categories are free and need no key. They return the valid values for the retailers, category and brand search filters, plus each retailer's membership rule, free-shipping threshold, return window and refresh interval.
GET https://cart-route.com/api/v1/retailers
GET https://cart-route.com/api/v1/categories
Which retailers are covered?
| id | Name | Membership | Free shipping over | Returns | Refresh |
|---|---|---|---|---|---|
amazon | Amazon | No | $35 | 30 days | 360 min |
bestbuy | Best Buy | No | $35 | 15 days | 360 min |
ebay | eBay | No | pickup only | days | 360 min |
What does /retailers return?
{
"object": "retailer_list",
"count": 3,
"retailers": [
{
"id": "amazon",
"name": "Amazon",
"domain": "amazon.com",
"membership_required": false,
"free_shipping_over_usd": 35,
"returns_window_days": 30,
"refresh_interval_seconds": 21600,
"coverage_note": "Listings from Amazon search, sold by Amazon or marketplace sellers. Renewed listings are included and labelled.",
"url": "https://cart-route.com/retailers/amazon"
}
]
}
Which categories exist?
Appliances (2), Audio (167), Computing (5), Fitness (1), Gaming (90), Home (78), Kitchen (97), Laptops (4), Office (1), Other (69), Outdoor (2), Phones (14), TVs (43), Tools (112), Wearables (105). /categories also lists every brand with its product count.
How often should I call these?
They change rarely. Cache them for a day, or read them once when an agent session starts. They are also available as MCP resources (cartroute://retailers, cartroute://categories) and as the free tools list_retailers and list_categories.