Docs menu

RetailMeNot API endpoint

RetailMeNot store directory API

Returns every store in one letter of RetailMeNot's A-Z store directory, or of RetailMeNot Canada's store list with market=ca, with the domain to pass to /retailmenot/store (with the same market).

GETapiKey2 credits/requestRetailMeNotretailmenot.storesResponseDoc/retailmenot/stores

Endpoint facts

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

RetailMeNot Scraper API Try RetailMeNot store directory API in Playground RetailMeNot API documentation

How this endpoint behaves

Query parameters:

letter (required): one of a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, 0-9 (stores whose name starts with a digit).
market (optional, default us): us, or ca for RetailMeNot Canada's store list (91 stores on 2026-10-03, filtered by the first character of the store name).

Returns the market and every store RetailMeNot lists under the letter, with the domain to pass to /api/v1/retailmenot/store (with the same market). The directory is not paginated upstream.

Live monitoring

Monitored request: GET /retailmenot/stores?letter=a
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.27 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /retailmenot/stores?letter=a
Items in stores: 379
Fields filled in every checked item: 3

Field	Filled in, of 379 checked	Values in the sample
name	379	“A Beka Book” and 378 other values
domain	379	“abeka.com” and 378 other values
url	379	retailmenot.com

Request parameters

Parameter	Type	Required	Description	Example
letter	string	Yes	Directory letter Allowed values: a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, 0-9.	a
market	string	No	us for RetailMeNot, ca for RetailMeNot Canada Allowed values: us, ca.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/retailmenot/stores?letter=a&market=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "letter": "a",
    "stores": [
      {
        "name": "Adidas",
        "domain": "adidas.com",
        "url": "https://www.retailmenot.com/view/adidas.com"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/retailmenot.storesResponseDoc

Field	Type	Required	Enum
data	retailmenot.StoresResponse	No
data.letter	string	No
data.market	string	No	us, ca
data.stores	array	No
data.stores[].domain	string	No
data.stores[].name	string	No
data.stores[].url	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/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/stores?letter=a&market=us" \
  -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 store directory API

Returns every store in one letter of RetailMeNot's A-Z store directory, or of RetailMeNot Canada's store list with market=ca, with the domain to pass to /retailmenot/store (with the same market).

GETapiKey2 credits/requestRetailMeNotretailmenot.storesResponseDoc/retailmenot/stores

Endpoint facts

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

RetailMeNot Scraper API Try RetailMeNot store directory API in Playground RetailMeNot API documentation

How this endpoint behaves

Query parameters:

letter (required): one of a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, 0-9 (stores whose name starts with a digit).
market (optional, default us): us, or ca for RetailMeNot Canada's store list (91 stores on 2026-10-03, filtered by the first character of the store name).

Returns the market and every store RetailMeNot lists under the letter, with the domain to pass to /api/v1/retailmenot/store (with the same market). The directory is not paginated upstream.

Live monitoring

Monitored request: GET /retailmenot/stores?letter=a
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.27 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /retailmenot/stores?letter=a
Items in stores: 379
Fields filled in every checked item: 3

Field	Filled in, of 379 checked	Values in the sample
name	379	“A Beka Book” and 378 other values
domain	379	“abeka.com” and 378 other values
url	379	retailmenot.com

Request parameters

Parameter	Type	Required	Description	Example
letter	string	Yes	Directory letter Allowed values: a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, 0-9.	a
market	string	No	us for RetailMeNot, ca for RetailMeNot Canada Allowed values: us, ca.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/retailmenot/stores?letter=a&market=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "letter": "a",
    "stores": [
      {
        "name": "Adidas",
        "domain": "adidas.com",
        "url": "https://www.retailmenot.com/view/adidas.com"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/retailmenot.storesResponseDoc

Field	Type	Required	Enum
data	retailmenot.StoresResponse	No
data.letter	string	No
data.market	string	No	us, ca
data.stores	array	No
data.stores[].domain	string	No
data.stores[].name	string	No
data.stores[].url	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/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/stores?letter=a&market=us" \
  -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 store directory 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 store directory 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