KFC API endpoint
Returns KFC restaurants near a latitude/longitude, nearest first. A coordinate with no nearby KFC returns an empty list rather than an error. Each restaurant carries its store number, full address with coordinates, phone, whether it currently accepts online orders, its timezone, and its distance from the search point in miles. occasion restricts results to restaurants that offer a given order channel (e.g. only drive-thru locations).
/kfc/nearbyQuery parameters:
latitude (required) — search center latitude.longitude (required) — search center longitude.radius_miles (optional, default 10) — search radius in miles, 0.1-100.occasion (optional) — restrict to restaurants offering this order channel, one of DELIVERY, CARRYOUT, DINE_IN, DRIVE_THRU, CATERING_CARRYOUT. Unfiltered by default.max_results (optional, default 20) — maximum restaurants to return, 1-50.Response includes stores[], count, has_more, source_url, and fetched_at. Each store has every field /kfc/stores returns plus distance_miles, the store's distance from the search point.
| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| store_number | 15 | “Y052023” and 14 other values |
| name | 15 | “KFC 1911 W Broadway St” and 14 other values |
| address | 15 | |
| accepting_online_orders | 15 | true in 13 of 15 |
| archived | 15 | true in 0 of 15 |
| timezone | 15 | America/New_York in all 15 |
| distance_miles | 15 | 1.41 to 9.24, median 6.97 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| latitude | number | Yes | Search center latitude | 38.2527 | |
| longitude | number | Yes | Search center longitude | -85.7585 | |
| radius_miles | number | No | Search radius in miles, 0.1-100 (default 10) | 10 | |
| occasion | string | No | Restrict to restaurants offering this order channel Allowed values: DELIVERY, CARRYOUT, DINE_IN, DRIVE_THRU, CATERING_CARRYOUT. | DRIVE_THRU | |
| max_results | integer | No | Maximum restaurants to return, 1-50 (default 20) | 20 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/kfc/nearby?latitude=38.2527&longitude=-85.7585&occasion=DELIVERY" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"stores": [
{
"store_number": "Y052023",
"name": "KFC 1911 W Broadway St",
"address": {
"address1": "1911 W Broadway St",
"city": "Louisville",
"state": "KY",
"postal_code": "40203",
"country_code": "US",
"phone": "+15027755811",
"latitude": 38.2492,
"longitude": -85.784
},
"accepting_online_orders": false,
"archived": false,
"timezone": "America/New_York",
"distance_miles": 1.408
}
],
"count": 5,
"has_more": false,
"source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
"fetched_at": "2026-09-03T00:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/kfc.nearbyResponseDoc
| 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 | kfc.NearbyResponse | No | ||||
| data.count | integer | No | 20 | |||
| data.fetched_at | string | No | ||||
| data.has_more | boolean | No | true | |||
| data.source_url | string | No | ||||
| data.stores | array | No | ||||
| data.stores[].accepting_online_orders | boolean | No | true | |||
| data.stores[].address | kfc.Address | No | Address record, 9 fields: address1, address2, city, country_code, latitude, longitude, phone, postal_code, state. Described under KFC Store API. | |||
| data.stores[].archived | boolean | No | false | |||
| data.stores[].distance_miles | number | No | 1.408 | |||
| data.stores[].name | string | No | KFC 600 Terminal Drive | |||
| data.stores[].store_number | string | No | I824001 | |||
| data.stores[].timezone | string | No | America/New_York | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/kfc/nearby?latitude=38.2527&longitude=-85.7585&occasion=DELIVERY" \
-H "x-api-key: $CRAWLORA_API_KEY"