Endpoint Playground

Try the KFC Promotion API

Test Crawlora's KFC Promotion API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /kfc/promotion
Platform: KFC
Auth: apiKey
Credits: 1 credit/request
Required params: None
Common optional params: code, serialized_code

KFC Promotion API documentation KFC platform page Crawlora API pricing Try KFC Delivery Estimate API Try KFC Menu API Try KFC Nearby API Try KFC Promotions API Try KFC Store API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/kfc/promotion" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
code	string	No		The redemption code as a customer would type it in at checkout. Exactly one of code or serialized_code is required
serialized_code	string	No		A unique per-print serialized/QR code that resolves to a shared redemption code. Exactly one of code or serialized_code is required

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promotion_id": "6815f409-5b1e-44dc-9f99-26b1c1a2699a",
    "name": "Digital-Q324 - 50% off Chicken Sandwich",
    "display_name": "50% off Chicken Sandwich",
    "description": "Digital - .Q324 - Get 50% off the purchase of a Chicken Sandwich. ",
    "automatic": false,
    "source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestkfc.promotionResponseDocKFC

GET /kfc/promotion

Look up one KFC promotion by its redemption code or serialized code

Returns one promotion by its redemption code (the code a customer types in at checkout) or its serialized code (a unique per-print QR/serial code, e.g. from a printed coupon, that resolves to a shared redemption code and its promotion). Exactly one of code or serialized_code is required. A serialized-code lookup additionally returns that code's own usage metadata (redemption_code, times_used, code_status, group_status, effective_date, expiration_date) alongside the promotion. An unknown or expired code returns a 404 rather than a null success payload.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promotion_id": "6815f409-5b1e-44dc-9f99-26b1c1a2699a",
    "name": "Digital-Q324 - 50% off Chicken Sandwich",
    "display_name": "50% off Chicken Sandwich",
    "description": "Digital - .Q324 - Get 50% off the purchase of a Chicken Sandwich. ",
    "automatic": false,
    "source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

Endpoint details

Method: GET
Path: /kfc/promotion
Authentication: apiKey
Credit cost: 1 credit/request
Platform: KFC
Parameters: 3 documented fields

Request parameters

code:queryserialized_code:queryx-api-key:header

Response schema fields

codedatadata.automaticdata.code_statusdata.descriptiondata.display_namedata.effective_datedata.expiration_datedata.fetched_atdata.group_statusdata.namedata.promotion_id

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promotion_id": "6815f409-5b1e-44dc-9f99-26b1c1a2699a",
    "name": "Digital-Q324 - 50% off Chicken Sandwich",
    "display_name": "50% off Chicken Sandwich",
    "description": "Digital - .Q324 - Get 50% off the purchase of a Chicken Sandwich. ",
    "automatic": false,
    "source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/kfc/promotion" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Check KFC delivery serviceability and estimated fee for one store and address Get one KFC restaurant's full priced menu Find KFC restaurants near a location Get one KFC restaurant's current public promotions Get one KFC restaurant by its store number

Endpoint Playground

Try the KFC Promotion API

Endpoint facts

Method: GET
API path: /kfc/promotion
Platform: KFC
Auth: apiKey
Credits: 1 credit/request
Required params: None
Common optional params: code, serialized_code

KFC Promotion API documentation KFC platform page Crawlora API pricing Try KFC Delivery Estimate API Try KFC Menu API Try KFC Nearby API Try KFC Promotions API Try KFC Store API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/kfc/promotion" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
code	string	No		The redemption code as a customer would type it in at checkout. Exactly one of code or serialized_code is required
serialized_code	string	No		A unique per-print serialized/QR code that resolves to a shared redemption code. Exactly one of code or serialized_code is required

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promotion_id": "6815f409-5b1e-44dc-9f99-26b1c1a2699a",
    "name": "Digital-Q324 - 50% off Chicken Sandwich",
    "display_name": "50% off Chicken Sandwich",
    "description": "Digital - .Q324 - Get 50% off the purchase of a Chicken Sandwich. ",
    "automatic": false,
    "source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestkfc.promotionResponseDocKFC

GET /kfc/promotion

Look up one KFC promotion by its redemption code or serialized code

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promotion_id": "6815f409-5b1e-44dc-9f99-26b1c1a2699a",
    "name": "Digital-Q324 - 50% off Chicken Sandwich",
    "display_name": "50% off Chicken Sandwich",
    "description": "Digital - .Q324 - Get 50% off the purchase of a Chicken Sandwich. ",
    "automatic": false,
    "source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

Endpoint details

Method: GET
Path: /kfc/promotion
Authentication: apiKey
Credit cost: 1 credit/request
Platform: KFC
Parameters: 3 documented fields

Request parameters

code:queryserialized_code:queryx-api-key:header

Response schema fields

codedatadata.automaticdata.code_statusdata.descriptiondata.display_namedata.effective_datedata.expiration_datedata.fetched_atdata.group_statusdata.namedata.promotion_id

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "promotion_id": "6815f409-5b1e-44dc-9f99-26b1c1a2699a",
    "name": "Digital-Q324 - 50% off Chicken Sandwich",
    "display_name": "50% off Chicken Sandwich",
    "description": "Digital - .Q324 - Get 50% off the purchase of a Chicken Sandwich. ",
    "automatic": false,
    "source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/kfc/promotion" \
  -H "x-api-key: $CRAWLORA_API_KEY"