Raising Cane's API endpoint
Returns Raising Cane's full promotions index: every current and past sweepstakes, giveaway, and other promotion the site links to, grouped under Raising Cane's own category headings (e.g. "Sweepstakes & Giveaways", "Lucky Promotions", "First Promotions"). Each entry's path chains into GET /raisingcanes/promotion for that promotion's full official-rules text. Some entries carry an empty path -- Raising Cane's own index links a since-expired promotion back to the homepage rather than removing the entry; treat an empty path as no longer resolvable rather than a bug.
/raisingcanes/promotionsReturns Raising Cane's full promotions index: every current and past sweepstakes, giveaway, and other promotion the site links to, grouped under Raising Cane's own category headings (e.g. "Sweepstakes & Giveaways", "Lucky Promotions", "First Promotions", "Other Promotions"). Takes no parameters — the index is one fixed page, not paginated or filterable on the upstream side.
Response includes categories[], count, source_url, and fetched_at.
Each category has heading and promotions[]. Each promotion has name and path. path is a promotion's page slug, usable as the path parameter on GET /raisingcanes/promotion to fetch that promotion's full official-rules text.
| Field | Filled in, of 4 checked | Values in the sample |
|---|---|---|
| heading | 4 | “Sweepstakes & Giveaways” and 3 other values |
| promotions | 4 | median 7 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/raisingcanes/promotions" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"categories": [
{
"heading": "Sweepstakes & Giveaways",
"promotions": [
{
"name": "C1066 - Lemonade with Law Enforcement – 06.18.2026",
"path": "c1066-lemonade-with-law-enforcement-06-18-2026"
}
]
},
{
"heading": "Other Promotions",
"promotions": [
{
"name": "RAISING CANE'S® C220 10 YEAR ANNIVERSARY"
}
]
}
],
"count": 53,
"source_url": "https://www.raisingcanes.com/page-data/promotions/page-data.json",
"fetched_at": "2026-09-02T17:45:15Z"
}
}Request schema
No body schema
Response schema
#/definitions/raisingcanes.promotionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | raisingcanes.PromotionsResponse | No | ||||
| data.categories | array | No | ||||
| data.categories[].heading | string | No | Sweepstakes & Giveaways | |||
| data.categories[].promotions | array | No | ||||
| data.categories[].promotions[].name | string | No | First 50 Promotion Details | |||
| data.categories[].promotions[].path | string | No | first-50-promotion | Path is the promotion's page slug, usable as the path parameter on GET /raisingcanes/promotion. It is empty when Raising Cane's own index links a since-expired promotion back to the homepage instead of removing the entry (a real, observed upstream data quality pattern) -- a caller should treat an empty path as "no longer resolvable" rather than retry it. | ||
| data.count | integer | No | 53 | |||
| data.fetched_at | string | No | ||||
| data.source_url | string | No | ||||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 404 | Not Found | #/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/raisingcanes/promotions" \
-H "x-api-key: $CRAWLORA_API_KEY"