Endpoint Playground
Returns one restaurant's current public promotions -- current deals and offers KFC's storefront marks as public, with each promotion's id, internal and display name, description, whether it applies automatically, and active redemption codes when KFC exposes them. The returned codes can be passed to kfc-promotion. A store with no active public promotions returns an empty list rather than an error.
14 Oct 2026: 15 promotions; 6 fields had a value in every checked item.
Sample value profiles: name: “Digital - 2026_Q4_1101_Partnership_Buy Two $25 gift cards a…” and 14 other values; automatic: true in 0 of 15; redemption_codes: median 1 entry.
curl 'https://api.crawlora.net/api/v1/kfc/promotions?store_number=I824001' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| store_number | string | Yes | I824001 | KFC's alphanumeric store number, from /kfc/stores or /kfc/nearby |
{
"code": 200,
"msg": "OK",
"data": {
"store_number": "I824001",
"promotions": [
{
"promotion_id": "d8da51c0-3497-485a-b68d-a8aa464da799",
"name": "Digital - 2026_Q4_1101_Partnership_Buy Two $25 gift cards and get $5 off your next digital purchase",
"display_name": "$5 off",
"description": "$5 off",
"automatic": false,
"redemption_codes": [
"WALMART5DOLLARSOFF"
]
}
],
"count": 15,
"source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
"fetched_at": "2026-09-21T03:38:05Z"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.