Docs menu

RetailMeNot API endpoint

RetailMeNot deal event API

Returns one seasonal deal event page's offers grouped into the page's sections (top deals and per-category sections). Use a slug from /retailmenot/deal-events.

GETapiKey2 credits/requestRetailMeNotretailmenot.dealEventResponseDoc/retailmenot/deal-event

Endpoint facts

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

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

How this endpoint behaves

Query parameters:

slug (required): event slug from /api/v1/retailmenot/deal-events (for example black-friday).

Returns the event name and its offers grouped into the page's sections (a top-deals section plus per-category sections; category_slug links a section to /api/v1/retailmenot/category). Each offer has its store, offer_type (observed COUPON, SALE, REWARD, returned as data), discount, and title. Unknown events return 404.

Live monitoring

Monitored request: GET /retailmenot/deal-event?slug=fall
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 3.95 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /retailmenot/deal-event?slug=fall
Items in sections: 8
Fields filled in every checked item: 2
Fields empty in some or all items: 1

Field	Filled in, of 8 checked	Values in the sample
name	8	“Best Fall Sales & Deals 2026” and 7 other values
offers	8	median 5 entries
category_slug	6

Request parameters

Parameter	Type	Required	Default	Description	Example
slug	string	Yes		Event slug from /retailmenot/deal-events	black-friday
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/retailmenot/deal-event?slug=black-friday" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "slug": "fall",
    "name": "Fall Deals",
    "url": "https://www.retailmenot.com/shop/deals/fall",
    "sections": [
      {
        "name": "Best Clothing, Shoes & Accessories Deals",
        "category_slug": "clothing-shoes-accessories",
        "offers": [
          {
            "id": "UCOTBEJEUVE3TJ26XWBIRKJEGE",
            "position": 1,
            "store_name": "Amazon",
            "store_domain": "amazon.com",
            "store_url": "https://www.retailmenot.com/view/amazon.com",
            "offer_type": "SALE",
            "discount": "50% Off",
            "title": "Shop Early Prime Big Deal Days! Up To 50% Off"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/retailmenot.dealEventResponseDoc

Field	Type	Required	Description
data	retailmenot.DealEventResponse	No
data.name	string	No
data.sections	array	No	OfferSection record, 12 fields: category_slug, name, offers. Described under RetailMeNot homepage offers API.
data.slug	string	No
data.url	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
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-event?slug=black-friday" \
  -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 event API

Returns one seasonal deal event page's offers grouped into the page's sections (top deals and per-category sections). Use a slug from /retailmenot/deal-events.

GETapiKey2 credits/requestRetailMeNotretailmenot.dealEventResponseDoc/retailmenot/deal-event

Endpoint facts

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

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

How this endpoint behaves

Query parameters:

slug (required): event slug from /api/v1/retailmenot/deal-events (for example black-friday).

Live monitoring

Monitored request: GET /retailmenot/deal-event?slug=fall
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 3.95 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /retailmenot/deal-event?slug=fall
Items in sections: 8
Fields filled in every checked item: 2
Fields empty in some or all items: 1

Field	Filled in, of 8 checked	Values in the sample
name	8	“Best Fall Sales & Deals 2026” and 7 other values
offers	8	median 5 entries
category_slug	6

Request parameters

Parameter	Type	Required	Default	Description	Example
slug	string	Yes		Event slug from /retailmenot/deal-events	black-friday
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/retailmenot/deal-event?slug=black-friday" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "slug": "fall",
    "name": "Fall Deals",
    "url": "https://www.retailmenot.com/shop/deals/fall",
    "sections": [
      {
        "name": "Best Clothing, Shoes & Accessories Deals",
        "category_slug": "clothing-shoes-accessories",
        "offers": [
          {
            "id": "UCOTBEJEUVE3TJ26XWBIRKJEGE",
            "position": 1,
            "store_name": "Amazon",
            "store_domain": "amazon.com",
            "store_url": "https://www.retailmenot.com/view/amazon.com",
            "offer_type": "SALE",
            "discount": "50% Off",
            "title": "Shop Early Prime Big Deal Days! Up To 50% Off"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/retailmenot.dealEventResponseDoc

Field	Type	Required	Description
data	retailmenot.DealEventResponse	No
data.name	string	No
data.sections	array	No	OfferSection record, 12 fields: category_slug, name, offers. Described under RetailMeNot homepage offers API.
data.slug	string	No
data.url	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
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-event?slug=black-friday" \
  -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 event 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 event 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