RetailMeNot API endpoint
Returns RetailMeNot's search-box suggestions for a free-text term: matching stores (with domains usable with /retailmenot/store) and cash-back offers. Group names are returned as data.
/retailmenot/autocompleteQuery parameters:
term (required): store or brand search term; maximum 100 characters.Returns RetailMeNot's search suggestions grouped by kind (observed group names store and rebates, returned as data). Store items carry the domain to pass to /api/v1/retailmenot/store; cash-back items carry an offer_id.
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| name | 2 | “store” and 1 other value |
| label | 2 | “Stores” and 1 other value |
| items | 2 | median 1 entry |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| term | string | Yes | Store or brand search term | nike | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/retailmenot/autocomplete?term=nike" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 0,
"message": "success",
"data": {
"groups": [
{
"name": "store",
"label": "Stores",
"items": [
{
"title": "Nike",
"domain": "nike.com",
"url": "https://www.retailmenot.com/view/nike.com"
}
]
},
{
"name": "rebates",
"label": "Cash Back Offers",
"items": [
{
"title": "Nike Online Cash Back",
"meta_info": "4% Back",
"offer_id": "CNXPABEHZVAKBN5XWLNOAVU75U"
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/retailmenot.autocompleteResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | retailmenot.AutocompleteResponse | No | ||||
| data.groups | array | No | ||||
| data.groups[].items | array | No | ||||
| data.groups[].items[].category_slug | string | No | CategorySlug is set on category suggestions; use it with GET /retailmenot/category. | |||
| data.groups[].items[].domain | string | No | ||||
| data.groups[].items[].meta_info | string | No | ||||
| data.groups[].items[].offer_id | string | No | ||||
| data.groups[].items[].title | string | No | ||||
| data.groups[].items[].url | string | No | ||||
| data.groups[].label | string | No | ||||
| data.groups[].name | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/retailmenot/autocomplete?term=nike" \
-H "x-api-key: $CRAWLORA_API_KEY"