Docs menu

RetailMeNot API endpoint

RetailMeNot category offers API

Returns one page of a RetailMeNot category landing page: the featured offers across stores (24 per page, with page and total_pages), offer counts, and similar stores. Use a slug from /retailmenot/categories; a page past the end returns an empty offer list.

GETapiKey2 credits/requestRetailMeNotretailmenot.categoryResponseDoc/retailmenot/category

Endpoint facts

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

RetailMeNot Scraper API Try RetailMeNot category offers API in Playground RetailMeNot API documentation

How this endpoint behaves

Query parameters:

slug (required): category slug from /api/v1/retailmenot/categories (for example clothing).
page (optional, default 1, 1-100): offer page; each page lists 24 offers.

Returns the category name, description, page and total_pages, offer counts, the featured offers across stores (store name and domain, offer type, type label, discount, title), and similar stores. Unknown categories return 404. Observed offer_type values are COUPON, SALE, and REWARD, returned as data.

Categories with an explicit zero offer count, and pages past total_pages, return an empty offers array. Upstream error pages, incomplete category pages, and offer cards that cannot be parsed return 503.

Live monitoring

Monitored request: GET /retailmenot/category?slug=clothing
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 4.93 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /retailmenot/category?slug=clothing
Items in similar_stores: 25
Fields filled in every checked item: 3

Field	Filled in, of 25 checked	Values in the sample
name	25	“New York & Company” and 24 other values
domain	25	“nyandcompany.com” and 24 other values
url	25	retailmenot.com

Request parameters

Parameter	Type	Required	Description	Example
slug	string	Yes	Category slug from /retailmenot/categories	clothing
page	integer	No	Offer page (24 offers per page; see total_pages)
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/retailmenot/category?slug=clothing&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "slug": "clothing",
    "name": "Clothing, Shoes, Accessories",
    "url": "https://www.retailmenot.com/coupons/clothing",
    "stats": [
      {
        "label": "Total Offers",
        "value": 668
      }
    ],
    "offers": [
      {
        "id": "YJVA45OZCNFXFFFFQJ56J2VPNY",
        "position": 1,
        "store_name": "Macy's",
        "store_domain": "macys.com",
        "store_url": "https://www.retailmenot.com/view/macys.com",
        "offer_type": "SALE",
        "discount": "30% Off",
        "title": "Macy's October Deals, Coupons & Promotions! Confirmed By RetailMeNot"
      }
    ],
    "similar_stores": [
      {
        "name": "American Eagle",
        "domain": "ae.com",
        "url": "https://www.retailmenot.com/view/ae.com"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/retailmenot.categoryResponseDoc

Field	Type	Required
data	retailmenot.CategoryResponse	No
data.description	string	No
data.name	string	No
data.offers	array	No
data.offers[].discount	string	No
data.offers[].id	string	No
data.offers[].offer_type	string	No
data.offers[].position	integer	No
data.offers[].store_domain	string	No
data.offers[].store_name	string	No
data.offers[].store_url	string	No
data.offers[].title	string	No
data.offers[].type_label	string	No
data.page	integer	No
data.similar_stores	array	No
data.similar_stores[].domain	string	No
data.similar_stores[].name	string	No
data.similar_stores[].url	string	No
data.slug	string	No
data.stats	array	No
data.stats[].label	string	No
data.stats[].value	integer	No
data.total_pages	integer	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/category?slug=clothing&page=1" \
  -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 category offers API

GETapiKey2 credits/requestRetailMeNotretailmenot.categoryResponseDoc/retailmenot/category

Endpoint facts

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

RetailMeNot Scraper API Try RetailMeNot category offers API in Playground RetailMeNot API documentation

How this endpoint behaves

Query parameters:

slug (required): category slug from /api/v1/retailmenot/categories (for example clothing).
page (optional, default 1, 1-100): offer page; each page lists 24 offers.

Live monitoring

Monitored request: GET /retailmenot/category?slug=clothing
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 4.93 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /retailmenot/category?slug=clothing
Items in similar_stores: 25
Fields filled in every checked item: 3

Field	Filled in, of 25 checked	Values in the sample
name	25	“New York & Company” and 24 other values
domain	25	“nyandcompany.com” and 24 other values
url	25	retailmenot.com

Request parameters

Parameter	Type	Required	Description	Example
slug	string	Yes	Category slug from /retailmenot/categories	clothing
page	integer	No	Offer page (24 offers per page; see total_pages)
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/retailmenot/category?slug=clothing&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "slug": "clothing",
    "name": "Clothing, Shoes, Accessories",
    "url": "https://www.retailmenot.com/coupons/clothing",
    "stats": [
      {
        "label": "Total Offers",
        "value": 668
      }
    ],
    "offers": [
      {
        "id": "YJVA45OZCNFXFFFFQJ56J2VPNY",
        "position": 1,
        "store_name": "Macy's",
        "store_domain": "macys.com",
        "store_url": "https://www.retailmenot.com/view/macys.com",
        "offer_type": "SALE",
        "discount": "30% Off",
        "title": "Macy's October Deals, Coupons & Promotions! Confirmed By RetailMeNot"
      }
    ],
    "similar_stores": [
      {
        "name": "American Eagle",
        "domain": "ae.com",
        "url": "https://www.retailmenot.com/view/ae.com"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/retailmenot.categoryResponseDoc

Field	Type	Required
data	retailmenot.CategoryResponse	No
data.description	string	No
data.name	string	No
data.offers	array	No
data.offers[].discount	string	No
data.offers[].id	string	No
data.offers[].offer_type	string	No
data.offers[].position	integer	No
data.offers[].store_domain	string	No
data.offers[].store_name	string	No
data.offers[].store_url	string	No
data.offers[].title	string	No
data.offers[].type_label	string	No
data.page	integer	No
data.similar_stores	array	No
data.similar_stores[].domain	string	No
data.similar_stores[].name	string	No
data.similar_stores[].url	string	No
data.slug	string	No
data.stats	array	No
data.stats[].label	string	No
data.stats[].value	integer	No
data.total_pages	integer	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/category?slug=clothing&page=1" \
  -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 category offers 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 category offers 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