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 | 10 min |
bhphoto | B&H Photo | No | $49 | 30 days | 30 min |
bestbuy | Best Buy | No | $35 | 15 days | 15 min |
costco | Costco | Required | always | 90 days | 30 min |
lowes | Lowe's | No | $45 | 90 days | 30 min |
microcenter | Micro Center | No | pickup only | 30 days | 10 min |
newegg | Newegg | No | $25 | 30 days | 10 min |
samsclub | Sam's Club | Required | always | 90 days | 30 min |
staples | Staples | No | $35 | 14 days | 30 min |
target | Target | No | $35 | 90 days | 15 min |
homedepot | The Home Depot | No | $45 | 90 days | 30 min |
walmart | Walmart | No | $35 | 90 days | 15 min |
What does /retailers return?
{
"object": "retailer_list",
"count": 12,
"retailers": [
{
"id": "costco",
"name": "Costco",
"domain": "costco.com",
"membership_required": true,
"free_shipping_over_usd": 0,
"returns_window_days": 90,
"refresh_interval_seconds": 1800,
"coverage_note": "Membership required to purchase. Bundle contents often differ from the equivalent SKU elsewhere.",
"url": "https://cart-route.com/retailers/costco"
}
]
}
Which categories exist?
Appliances (2), Audio (4), Computing (4), Fitness (1), Gaming (5), Home (3), Kitchen (4), Laptops (4), Office (1), Outdoor (2), Phones (3), TVs (3), Tools (2), Wearables (2). /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.