{
  "object": "doc",
  "title": "Reference data: retailers and categories",
  "description": "Free endpoints listing covered retailers, categories and brands.",
  "section": "API reference",
  "url": "https://cart-route.com/docs/api/reference",
  "updated": "2026-09-23",
  "prev": "https://cart-route.com/docs/api/coupons",
  "next": "https://cart-route.com/docs/api/account",
  "text": "`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.\n\r\n\r\nGET https://cart-route.com/api/v1/retailers\n\r\nGET https://cart-route.com/api/v1/categories\n\r\n\r\n\n## Which retailers are covered?\n\r\n\r\n  \r\n\n| id | Name | Membership | Free shipping over | Returns | Refresh | \r\n    \r\n      \r\n\n| `amazon` | Amazon | No | $35 | 30 days | 360 min | \r\n      \r\n\n| `bestbuy` | Best Buy | No | $35 | 15 days | 360 min | \r\n      \r\n\n| `ebay` | eBay | No | pickup only |  days | 360 min | \r\n      \r\n    \r\n\n\r\n\n\r\n\r\n\n## What does /retailers return?\n\r\n\n```\n{\n  \"object\": \"retailer_list\",\n  \"count\": 3,\n  \"retailers\": [\n    {\n      \"id\": \"amazon\",\n      \"name\": \"Amazon\",\n      \"domain\": \"amazon.com\",\n      \"membership_required\": false,\n      \"free_shipping_over_usd\": 35,\n      \"returns_window_days\": 30,\n      \"refresh_interval_seconds\": 21600,\n      \"coverage_note\": \"Listings from Amazon search, sold by Amazon or marketplace sellers. Renewed listings are included and labelled.\",\n      \"url\": \"https://cart-route.com/retailers/amazon\"\n    }\n  ]\n}\n```\n\r\n\r\n\n## Which categories exist?\n\r\nAppliances (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.\n\r\n\r\n\n## How often should I call these?\n\r\nThey 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`."
}