Docs menu
RetailMeNot API endpoint
RetailMeNot categories API
Lists RetailMeNot's coupon category tree as a flat list with no parameters. Each entry has `name`, `slug`, `url` and `level` (1 parent, 2 child, 3 grandchild); levels 2 and 3 also carry `parent_slug`. The `slug` is what RetailMeNot's category endpoint takes.
GETapiKey2 credits/requestRetailMeNotretailmenot.categoriesResponseDoc
RetailMeNot/retailmenot/categoriesEndpoint facts
- Method
- GET
- API path
- /retailmenot/categories
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- RetailMeNot
- Response schema
- #/definitions/retailmenot.categoriesResponseDoc
How this endpoint behaves
No query parameters.
Returns RetailMeNot's full coupon category tree as a flat list. level is 1 (parent), 2 (child), or 3 (grandchild); levels 2 and 3 carry parent_slug. Use slug with /api/v1/retailmenot/category.
Live monitoring
- Monitored request
- GET /retailmenot/categories
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 2.23 s
Sampled response
- Request, 14 Oct 2026
- GET /retailmenot/categories
- Items in categories
- 269
- Fields filled in every checked item
- 4
- Fields empty in some or all items
- 1
| Field | Filled in, of 269 checked | Values in the sample |
|---|---|---|
| name | 269 | “Automotive” and 264 other values |
| slug | 269 | |
| url | 269 | retailmenot.com |
| level | 269 | 1 to 3, median 2 |
| parent_slug | 248 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/retailmenot/categories" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 0,
"message": "success",
"data": {
"categories": [
{
"name": "Automotive",
"slug": "auto",
"url": "https://www.retailmenot.com/coupons/auto",
"level": 1
},
{
"name": "Motorcycles",
"slug": "motorcycleparts",
"url": "https://www.retailmenot.com/coupons/motorcycleparts",
"level": 2,
"parent_slug": "auto"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/retailmenot.categoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | retailmenot.CategoriesResponse | No | ||||
| data.categories | array | No | ||||
| data.categories[].level | integer | No | ||||
| data.categories[].name | string | No | ||||
| data.categories[].parent_slug | string | No | ||||
| data.categories[].slug | string | No | ||||
| data.categories[].url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/retailmenot/categories" \
-H "x-api-key: $CRAWLORA_API_KEY"Shared guides
Related
More RetailMeNot endpoint docsRetailMeNot Scraper APIRetailMeNot search autocomplete API documentationRetailMeNot blog categories API documentationRetailMeNot blog post API documentationRetailMeNot blog posts API documentationRetailMeNot blog tags API documentationRetailMeNot cash back API documentation