Docs menu
RetailMeNot API endpoint
RetailMeNot blog tags API
Returns one page of RetailMeNot blog tags ordered by post count, with slug, name, post count, and URL, plus total and total pages; optionally only tags matching a query. Use a slug as the tag filter of /retailmenot/blog-posts.
GETapiKey2 credits/requestRetailMeNotretailmenot.blogTagsResponseDoc
RetailMeNot/retailmenot/blog-tagsEndpoint facts
- Method
- GET
- API path
- /retailmenot/blog-tags
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- RetailMeNot
- Response schema
- #/definitions/retailmenot.blogTagsResponseDoc
How this endpoint behaves
Query parameters:
query(optional): only tags whose name matches this text.page(optional, default1): page number.page_size(optional, default20,1-100): tags per page.
Returns one page of blog tags ordered by post count (each with id, slug, name, count, url), plus total and total_pages (935 tags on 2026-10-03). Use a slug as the tag filter of /api/v1/retailmenot/blog-posts. A page past the end returns an empty list; invalid paging values return 400.
Live monitoring
- Monitored request
- GET /retailmenot/blog-tags?query=black+friday
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 4.68 s
Sampled response
- Request, 14 Oct 2026
- GET /retailmenot/blog-tags?query=black+friday&page_size=20
- Items in tags
- 3
- Fields filled in every checked item
- 4
- Fields empty in some or all items
- 1
| Field | Filled in, of 3 checked | Values in the sample |
|---|---|---|
| id | 3 | |
| slug | 3 | |
| name | 3 | “Black Friday” and 2 other values |
| count | 1 | 24 |
| url | 3 | retailmenot.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| query | string | No | Match tag names | black friday | |
| page | integer | No | Page number, starting at 1 | ||
| page_size | integer | No | Tags per page (1-100) | ||
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/retailmenot/blog-tags?query=coffee&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 0,
"message": "success",
"data": {
"query": "black friday",
"page": 1,
"page_size": 20,
"total": 3,
"total_pages": 1,
"tags": [
{
"id": 29,
"slug": "black-friday",
"name": "Black Friday",
"count": 23,
"url": "https://www.retailmenot.com/blog/tag/black-friday"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/retailmenot.blogTagsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | retailmenot.BlogTagsResponse | No | ||||
| data.page | integer | No | ||||
| data.page_size | integer | No | ||||
| data.query | string | No | ||||
| data.tags | array | No | BlogTerm record, 5 fields: count, id, name, slug, url. Described under RetailMeNot blog post API. | |||
| data.total | integer | No | ||||
| data.total_pages | integer | 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/blog-tags?query=coffee&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"Shared guides
Related
More RetailMeNot endpoint docsRetailMeNot Scraper APIRetailMeNot search autocomplete API documentationRetailMeNot blog categories API documentationRetailMeNot blog post API documentationRetailMeNot blog posts API documentationRetailMeNot cash back API documentationRetailMeNot categories API documentation