Endpoint Playground

Try the KFC Promotions API

Test Crawlora's KFC Promotions 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/promotions
Platform: KFC
Auth: apiKey
Credits: 1 credit/request
Required params: store_number

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

Prefilled cURL

curl "https://api.crawlora.net/api/v1/kfc/promotions?store_number=<store_number>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
store_number	string	Yes		KFC's alphanumeric store number, from /kfc/stores or /kfc/nearby

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "store_number": "I824001",
    "promotions": [
      {
        "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": true
      }
    ],
    "count": 15,
    "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.promotionsResponseDocKFC

GET /kfc/promotions

Get one KFC restaurant's current public promotions

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, and whether it applies automatically or requires a redemption code. A store with no active public promotions returns an empty list rather than an error.

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

Required query parameters

store_number

requiredstring

KFC's alphanumeric store number, from /kfc/stores or /kfc/nearby

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": {
    "store_number": "I824001",
    "promotions": [
      {
        "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": true
      }
    ],
    "count": 15,
    "source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

Endpoint details

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

Request parameters

store_number:queryx-api-key:header

Response schema fields

codedatadata.countdata.fetched_atdata.promotionsdata.promotions[].automaticdata.promotions[].descriptiondata.promotions[].display_namedata.promotions[].namedata.promotions[].promotion_iddata.source_urldata.store_number

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "store_number": "I824001",
    "promotions": [
      {
        "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": true
      }
    ],
    "count": 15,
    "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/promotions?store_number=<store_number>" \
  -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 Look up one KFC promotion by its redemption code or serialized code Get one KFC restaurant by its store number

Endpoint Playground

Try the KFC Promotions API

Endpoint facts

Method: GET
API path: /kfc/promotions
Platform: KFC
Auth: apiKey
Credits: 1 credit/request
Required params: store_number

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

Prefilled cURL

curl "https://api.crawlora.net/api/v1/kfc/promotions?store_number=<store_number>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
store_number	string	Yes		KFC's alphanumeric store number, from /kfc/stores or /kfc/nearby

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "store_number": "I824001",
    "promotions": [
      {
        "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": true
      }
    ],
    "count": 15,
    "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.promotionsResponseDocKFC

GET /kfc/promotions

Get one KFC restaurant's current public promotions

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

Required query parameters

store_number

requiredstring

KFC's alphanumeric store number, from /kfc/stores or /kfc/nearby

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": {
    "store_number": "I824001",
    "promotions": [
      {
        "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": true
      }
    ],
    "count": 15,
    "source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

Endpoint details

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

Request parameters

store_number:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "store_number": "I824001",
    "promotions": [
      {
        "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": true
      }
    ],
    "count": 15,
    "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/promotions?store_number=<store_number>" \
  -H "x-api-key: $CRAWLORA_API_KEY"