Docs menu

RetailMeNot API endpoint

RetailMeNot deal events API

Lists the seasonal and holiday deal events linked from RetailMeNot's deals hub, such as Black Friday or Back-to-School, each with `name`, `slug` and `url`. The `slug` feeds the deal-event endpoint. Out-of-season events may list fewer offers. It takes no parameters.

GETapiKey2 credits/requestRetailMeNotretailmenot.dealEventsResponseDoc/retailmenot/deal-events

Endpoint facts

Method: GET
API path: /retailmenot/deal-events
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: RetailMeNot
Response schema: #/definitions/retailmenot.dealEventsResponseDoc

RetailMeNot Scraper API Try RetailMeNot deal events API in Playground RetailMeNot API documentation

How this endpoint behaves

No query parameters.

Returns every seasonal and holiday deal event linked from RetailMeNot's deals hub, with the slug to pass to /api/v1/retailmenot/deal-event. Events cover the whole calendar; out-of-season event pages may list fewer offers.

Live monitoring

Monitored request: GET /retailmenot/deal-events
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.85 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /retailmenot/deal-events
Items in events: 29
Fields filled in every checked item: 3

Field	Filled in, of 29 checked	Values in the sample
name	29	“Fall Deals” and 28 other values
slug	29
url	29	retailmenot.com

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/deal-events" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "events": [
      {
        "name": "Black Friday",
        "slug": "black-friday",
        "url": "https://www.retailmenot.com/shop/deals/black-friday"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/retailmenot.dealEventsResponseDoc

Field	Type	Required
data	retailmenot.DealEventsResponse	No
data.events	array	No
data.events[].name	string	No
data.events[].slug	string	No
data.events[].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/deal-events" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More RetailMeNot endpoint docs RetailMeNot Scraper API RetailMeNot search autocomplete API documentation RetailMeNot blog categories API documentation RetailMeNot blog post API documentation RetailMeNot blog posts API documentation RetailMeNot blog tags API documentation RetailMeNot cash back API documentation

Open in Playground Back to group

Docs menu

RetailMeNot API endpoint

RetailMeNot deal events API

GETapiKey2 credits/requestRetailMeNotretailmenot.dealEventsResponseDoc/retailmenot/deal-events

Endpoint facts

Method: GET
API path: /retailmenot/deal-events
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: RetailMeNot
Response schema: #/definitions/retailmenot.dealEventsResponseDoc

RetailMeNot Scraper API Try RetailMeNot deal events API in Playground RetailMeNot API documentation

How this endpoint behaves

No query parameters.

Live monitoring

Monitored request: GET /retailmenot/deal-events
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.85 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /retailmenot/deal-events
Items in events: 29
Fields filled in every checked item: 3

Field	Filled in, of 29 checked	Values in the sample
name	29	“Fall Deals” and 28 other values
slug	29
url	29	retailmenot.com

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/deal-events" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "events": [
      {
        "name": "Black Friday",
        "slug": "black-friday",
        "url": "https://www.retailmenot.com/shop/deals/black-friday"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/retailmenot.dealEventsResponseDoc

Field	Type	Required
data	retailmenot.DealEventsResponse	No
data.events	array	No
data.events[].name	string	No
data.events[].slug	string	No
data.events[].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/deal-events" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

RetailMeNot deal events API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

RetailMeNot deal events API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related