---
type: "firecrawl-provider"
description: "Canadian Pizza Hut store, menu, builder and promotion data from the public Yum storefront."
use_when: "Find a store, inspect its menu, and retrieve product options and prices."
categories: "Restaurant"
capabilities: 9
credits_per_call: 5
---
# Pizza Hut Canada on Firecrawl Alexandria

Canadian Pizza Hut store, menu, builder and promotion data from the public Yum storefront.

- Categories: Restaurant
- Category index: [Restaurant category](https://firecrawl.dev/alexandria/agents/categories/restaurant)
- Provider key: `pizzahut-ca`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/pizzahut-ca)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/openapi.json)

## Capabilities

- [Find nearby stores](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/stores): Find nearby and delivering Pizza Hut Canada stores by coordinates or postal anchor.
- [Store directory](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/directory): List Pizza Hut Canada stores, optionally by province, walking the source connection.
- [Store details](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/store): Read one store profile, address, occasions and service hours.
- [Menu categories](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/categories): Read the store menu category index.
- [Category products](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/category): Read items in one category and optional subcategories.
- [Product options](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/modifiers): Read a product builder with variants, slots, modifiers and prices.
- [Full menu](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/menu): Read the full menu query with deduplicated products, variants and bundles. Products and variants are paginated (default and maximum 10 each); category/bundle metadata and total counts repeat on each page.
- [Deal bundles](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/bundles): Read deal bundles, optionally selected by code.
- [Promotions](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/promotions): Read public promotions and their requirements and effects.

## 1. Choose this provider when

Find a store, inspect its menu, and retrieve product options and prices.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "pizzahut-ca",
  "capability": "restaurants/stores",
  "options": {
    "latitude": 45.499,
    "longitude": -73.577,
    "max_distance_km": 20,
    "occasion": "CARRYOUT"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `latitude` (number): latitude Example: `10`
- `longitude` (number): longitude Example: `10`
- `max_distance_km` (number): max_distance_km Example: `10`
- `occasion` (string): Pattern: ^([Cc][Aa][Rr][Rr][Yy][Oo][Uu][Tt]|[Dd][Ee][Ll][Ii][Vv][Ee][Rr][Yy])$. Example: `<occasion>`
- `postal_code` (string): postal_code Example: `<postal_code>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "pizzahut-ca",
    capability: "restaurants/stores",
    options: {
      latitude: 45.499,
      longitude: -73.577,
      max_distance_km: 20,
      occasion: "CARRYOUT",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "pizzahut-ca",
  "capability": "restaurants/stores",
  "options": {
    "latitude": 45.499,
    "longitude": -73.577,
    "max_distance_km": 20,
    "occasion": "CARRYOUT"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "pizzahut-ca",
    "capability": "restaurants/stores",
    "options": {
      "latitude": 45.499,
      "longitude": -73.577,
      "max_distance_km": 20,
      "occasion": "CARRYOUT"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'pizzahut-ca/restaurants/stores' \
  --options '{"latitude":45.499,"longitude":-73.577,"max_distance_km":20,"occasion":"CARRYOUT"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "pizzahut-ca",
  "capability": "restaurants/stores",
  "options": {
    "latitude": 45.499,
    "longitude": -73.577,
    "max_distance_km": 20,
    "occasion": "CARRYOUT"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "pizzahut-ca",
  "capability": "restaurants/stores",
  "options": {
    "latitude": 45.499,
    "longitude": -73.577,
    "max_distance_km": 20,
    "occasion": "CARRYOUT"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "delivering": [
    {
      "accepting_online_orders": true,
      "address": {
        "city": "Montreal",
        "country": "CA",
        "line1": "1431A Bishop Street",
        "line2": null,
        "postal_code": "H3G 2E4",
        "state": "QC"
      },
      "allows_future_orders": true,
      "appears_in_search": true,
      "archived": false,
      "delivery_providers": [
        {
          "__typename": "StoreDeliveryProvider",
          "deliveryProvider": "INTERNAL",
          "enabled": true
        }
      ],
      "delivery_zones": [
        {
          "__typename": "DeliveryZone",
          "deliveryZoneId": "04608899-5f61-41d4-9df8-af42dffb5a56",
          "fees": [
            {
              "__typename": "DeliveryZoneFee",
              "amount": {
                "__typename": "Money",
                "amount": 519,
                "currencyCode": "CAD"
              },
              "name": "deliverySupplement"
            }
          ]
        }
      ],
      "future_order_days": 1,
      "handoff_modes": null,
      "latitude": 45.4969889,
      "longitude": -73.5775401,
      "metafields": {
        "hideNutrition": "1"
      },
      "name": "Montreal - 1431A Bishop Street",
      "occasions": [
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -16,
              "offsetOpen": 16,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -16,
              "offsetOpen": 16,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "14:30:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "CARRYOUT",
          "service_time_minutes": 16
        },
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "14:30:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "DELIVERY",
          "service_time_minutes": 30
        }
      ],
      "phone": "+15142826463",
      "store_number": "R34601",
      "timezone": "America/Toronto"
    }
  ],
  "delivering_count": 1,
  "nearby": [
    {
      "accepting_online_orders": true,
      "address": {
        "city": "Montreal",
        "country": "CA",
        "line1": "1431A Bishop Street",
        "line2": null,
        "postal_code": "H3G 2E4",
        "state": "QC"
      },
      "allows_future_orders": true,
      "appears_in_search": true,
      "archived": false,
      "delivery_providers": [
        {
          "__typename": "StoreDeliveryProvider",
          "deliveryProvider": "INTERNAL",
          "enabled": true
        }
      ],
      "future_order_days": 1,
      "handoff_modes": null,
      "latitude": 45.4969889,
      "longitude": -73.5775401,
      "metafields": {
        "hideNutrition": "1"
      },
      "name": "Montreal - 1431A Bishop Street",
      "occasions": [
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -16,
              "offsetOpen": 16,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -16,
              "offsetOpen": 16,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "14:30:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "CARRYOUT",
          "service_time_minutes": 16
        },
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "14:30:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "DELIVERY",
          "service_time_minutes": 30
        }
      ],
      "phone": "+15142826463",
      "store_number": "R34601",
      "timezone": "America/Toronto"
    },
    {
      "accepting_online_orders": true,
      "address": {
        "city": "Montreal",
        "country": "CA",
        "line1": "3547 St. Laurent Blvd",
        "line2": null,
        "postal_code": "H2X 2T6",
        "state": "QC"
      },
      "allows_future_orders": true,
      "appears_in_search": true,
      "archived": false,
      "delivery_providers": [
        {
          "__typename": "StoreDeliveryProvider",
          "deliveryProvider": "INTERNAL",
          "enabled": true
        }
      ],
      "future_order_days": 1,
      "handoff_modes": null,
      "latitude": 45.513927,
      "longitude": -73.571786,
      "metafields": {
        "hideNutrition": "1"
      },
      "name": "Montreal - 3547 St. Laurent Blvd",
      "occasions": [
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -17,
              "offsetOpen": 17,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  5,
                  6
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -17,
              "offsetOpen": 17,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "12:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "CARRYOUT",
          "service_time_minutes": 17
        },
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -35,
              "offsetOpen": 35,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "12:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -35,
              "offsetOpen": 35,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  5,
                  6
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "DELIVERY",
          "service_time_minutes": 35
        }
      ],
      "phone": "+15148429944",
      "store_number": "R43001",
      "timezone": "America/Toronto"
    }
  ],
  "nearby_count": 2,
  "query": {
    "latitude": 45.499,
    "longitude": -73.577,
    "max_distance_km": 20,
    "occasion": "CARRYOUT",
    "resolved_from": null
  }
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Find nearby stores

- Capability: `restaurants/stores`
- Description: Find nearby and delivering Pizza Hut Canada stores by coordinates or postal anchor.
- Instructions: Find nearby and delivering Pizza Hut Canada stores by coordinates or postal anchor.
- Cost: 5 credits per call
- Capability file: [Find nearby stores](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/stores)

Accepted options:
- `latitude` (number): latitude Example: `10`
- `longitude` (number): longitude Example: `10`
- `max_distance_km` (number): max_distance_km Example: `10`
- `occasion` (string): Pattern: ^([Cc][Aa][Rr][Rr][Yy][Oo][Uu][Tt]|[Dd][Ee][Ll][Ii][Vv][Ee][Rr][Yy])$. Example: `<occasion>`
- `postal_code` (string): postal_code Example: `<postal_code>`

Response schema example:
```json
{
  "delivering": [
    {
      "accepting_online_orders": true,
      "address": {
        "city": "Montreal",
        "country": "CA",
        "line1": "1431A Bishop Street",
        "line2": null,
        "postal_code": "H3G 2E4",
        "state": "QC"
      },
      "allows_future_orders": true,
      "appears_in_search": true,
      "archived": false,
      "delivery_providers": [
        {
          "__typename": "StoreDeliveryProvider",
          "deliveryProvider": "INTERNAL",
          "enabled": true
        }
      ],
      "delivery_zones": [
        {
          "__typename": "DeliveryZone",
          "deliveryZoneId": "04608899-5f61-41d4-9df8-af42dffb5a56",
          "fees": [
            {
              "__typename": "DeliveryZoneFee",
              "amount": {
                "__typename": "Money",
                "amount": 519,
                "currencyCode": "CAD"
              },
              "name": "deliverySupplement"
            }
          ]
        }
      ],
      "future_order_days": 1,
      "handoff_modes": null,
      "latitude": 45.4969889,
      "longitude": -73.5775401,
      "metafields": {
        "hideNutrition": "1"
      },
      "name": "Montreal - 1431A Bishop Street",
      "occasions": [
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -16,
              "offsetOpen": 16,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -16,
              "offsetOpen": 16,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "14:30:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "CARRYOUT",
          "service_time_minutes": 16
        },
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "14:30:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "DELIVERY",
          "service_time_minutes": 30
        }
      ],
      "phone": "+15142826463",
      "store_number": "R34601",
      "timezone": "America/Toronto"
    }
  ],
  "delivering_count": 1,
  "nearby": [
    {
      "accepting_online_orders": true,
      "address": {
        "city": "Montreal",
        "country": "CA",
        "line1": "1431A Bishop Street",
        "line2": null,
        "postal_code": "H3G 2E4",
        "state": "QC"
      },
      "allows_future_orders": true,
      "appears_in_search": true,
      "archived": false,
      "delivery_providers": [
        {
          "__typename": "StoreDeliveryProvider",
          "deliveryProvider": "INTERNAL",
          "enabled": true
        }
      ],
      "future_order_days": 1,
      "handoff_modes": null,
      "latitude": 45.4969889,
      "longitude": -73.5775401,
      "metafields": {
        "hideNutrition": "1"
      },
      "name": "Montreal - 1431A Bishop Street",
      "occasions": [
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -16,
              "offsetOpen": 16,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -16,
              "offsetOpen": 16,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "14:30:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "CARRYOUT",
          "service_time_minutes": 16
        },
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "14:30:00",
                "endDate": null,
                "intervalStartTime": "10:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "DELIVERY",
          "service_time_minutes": 30
        }
      ],
      "phone": "+15142826463",
      "store_number": "R34601",
      "timezone": "America/Toronto"
    },
    {
      "accepting_online_orders": true,
      "address": {
        "city": "Montreal",
        "country": "CA",
        "line1": "3547 St. Laurent Blvd",
        "line2": null,
        "postal_code": "H2X 2T6",
        "state": "QC"
      },
      "allows_future_orders": true,
      "appears_in_search": true,
      "archived": false,
      "delivery_providers": [
        {
          "__typename": "StoreDeliveryProvider",
          "deliveryProvider": "INTERNAL",
          "enabled": true
        }
      ],
      "future_order_days": 1,
      "handoff_modes": null,
      "latitude": 45.513927,
      "longitude": -73.571786,
      "metafields": {
        "hideNutrition": "1"
      },
      "name": "Montreal - 3547 St. Laurent Blvd",
      "occasions": [
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -17,
              "offsetOpen": 17,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  5,
                  6
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -17,
              "offsetOpen": 17,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "12:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "CARRYOUT",
          "service_time_minutes": 17
        },
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -35,
              "offsetOpen": 35,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "12:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -35,
              "offsetOpen": 35,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  5,
                  6
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "DELIVERY",
          "service_time_minutes": 35
        }
      ],
      "phone": "+15148429944",
      "store_number": "R43001",
      "timezone": "America/Toronto"
    }
  ],
  "nearby_count": 2,
  "query": {
    "latitude": 45.499,
    "longitude": -73.577,
    "max_distance_km": 20,
    "occasion": "CARRYOUT",
    "resolved_from": null
  }
}
```

### Store directory

- Capability: `restaurants/directory`
- Description: List Pizza Hut Canada stores, optionally by province, walking the source connection.
- Instructions: List Pizza Hut Canada stores, optionally by province, walking the source connection.
- Cost: 5 credits per call
- Capability file: [Store directory](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/directory)

Accepted options:
- `province` (string): province Example: `<province>`

Response schema example:
```json
{
  "count": 2,
  "province": "QC",
  "stores": [
    {
      "accepting_online_orders": true,
      "address": {
        "city": "Laval",
        "country": "CA",
        "line1": "1700 boul. des Laurentides",
        "line2": null,
        "postal_code": "H7M 2P4",
        "state": "QC"
      },
      "allows_future_orders": true,
      "appears_in_search": true,
      "archived": false,
      "delivery_providers": [
        {
          "__typename": "StoreDeliveryProvider",
          "deliveryProvider": "INTERNAL",
          "enabled": true
        }
      ],
      "future_order_days": 1,
      "handoff_modes": null,
      "latitude": 45.581599019761704,
      "longitude": -73.70694244076962,
      "metafields": {
        "hideNutrition": "1"
      },
      "name": "Pont-Viau - 1700 boul. des Laurentides",
      "occasions": [
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -15,
              "offsetOpen": 15,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "12:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -15,
              "offsetOpen": 15,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "11:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "CARRYOUT",
          "service_time_minutes": 15
        },
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  4,
                  5
                ],
                "duration": "12:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "11:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "DELIVERY",
          "service_time_minutes": 30
        }
      ],
      "phone": "+14509758357",
      "store_number": "R29601",
      "timezone": "America/Toronto"
    },
    {
      "accepting_online_orders": true,
      "address": {
        "city": "Montreal",
        "country": "CA",
        "line1": "2800 rue Rachel E",
        "line2": null,
        "postal_code": "H2H 1S8",
        "state": "QC"
      },
      "allows_future_orders": true,
      "appears_in_search": true,
      "archived": false,
      "delivery_providers": [
        {
          "__typename": "StoreDeliveryProvider",
          "deliveryProvider": "INTERNAL",
          "enabled": true
        }
      ],
      "future_order_days": 1,
      "handoff_modes": null,
      "latitude": 45.539732,
      "longitude": -73.561438,
      "metafields": {
        "hideNutrition": "1"
      },
      "name": "Montreal - 2800 rue Rachel E",
      "occasions": [
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -15,
              "offsetOpen": 15,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "11:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -15,
              "offsetOpen": 15,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  5,
                  6
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "CARRYOUT",
          "service_time_minutes": 15
        },
        {
          "enabled": true,
          "hours": [
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  1,
                  2
                ],
                "duration": "11:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            },
            {
              "__typename": "StoreOccasionTimeFrame",
              "offsetClose": -30,
              "offsetOpen": 30,
              "timeFrame": {
                "__typename": "TimeFrame",
                "blackout": false,
                "days": [
                  5,
                  6
                ],
                "duration": "13:00:00",
                "endDate": null,
                "intervalStartTime": "11:00:00",
                "startDate": null,
                "weight": 1
              }
            }
          ],
          "max_future_order_days": null,
          "min_future_order_days": null,
          "occasion": "DELIVERY",
          "service_time_minutes": 30
        }
      ],
      "phone": "+15145214551",
      "store_number": "R29605",
      "timezone": "America/Toronto"
    }
  ],
  "total_reported": 81
}
```

### Store details

- Capability: `restaurants/store`
- Description: Read one store profile, address, occasions and service hours.
- Instructions: Read one store profile, address, occasions and service hours.
- Cost: 5 credits per call
- Capability file: [Store details](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/store)

Accepted options:
- `store_number` (string, required): Pattern: ^[A-Za-z0-9]{1,16}$. Example: `<store_number>`

Response schema example:
```json
{
  "accepting_online_orders": true,
  "address": {
    "city": "Montreal",
    "country": "CA",
    "line1": "1431A Bishop Street",
    "line2": null,
    "postal_code": "H3G 2E4",
    "state": "QC"
  },
  "allows_future_orders": true,
  "appears_in_search": true,
  "archived": false,
  "delivery_providers": [
    {
      "__typename": "StoreDeliveryProvider",
      "deliveryProvider": "INTERNAL",
      "enabled": true
    }
  ],
  "future_order_days": 1,
  "handoff_modes": null,
  "latitude": 45.4969889,
  "longitude": -73.5775401,
  "metafields": {
    "hideNutrition": "1"
  },
  "name": "Montreal - 1431A Bishop Street",
  "occasions": [
    {
      "enabled": true,
      "hours": [
        {
          "__typename": "StoreOccasionTimeFrame",
          "offsetClose": -16,
          "offsetOpen": 16,
          "timeFrame": {
            "__typename": "TimeFrame",
            "blackout": false,
            "days": [
              1,
              2
            ],
            "duration": "13:00:00",
            "endDate": null,
            "intervalStartTime": "10:00:00",
            "startDate": null,
            "weight": 1
          }
        },
        {
          "__typename": "StoreOccasionTimeFrame",
          "offsetClose": -16,
          "offsetOpen": 16,
          "timeFrame": {
            "__typename": "TimeFrame",
            "blackout": false,
            "days": [
              4,
              5
            ],
            "duration": "14:30:00",
            "endDate": null,
            "intervalStartTime": "10:00:00",
            "startDate": null,
            "weight": 1
          }
        }
      ],
      "max_future_order_days": null,
      "min_future_order_days": null,
      "occasion": "CARRYOUT",
      "service_time_minutes": 16
    },
    {
      "enabled": true,
      "hours": [
        {
          "__typename": "StoreOccasionTimeFrame",
          "offsetClose": -30,
          "offsetOpen": 30,
          "timeFrame": {
            "__typename": "TimeFrame",
            "blackout": false,
            "days": [
              1,
              2
            ],
            "duration": "13:00:00",
            "endDate": null,
            "intervalStartTime": "10:00:00",
            "startDate": null,
            "weight": 1
          }
        },
        {
          "__typename": "StoreOccasionTimeFrame",
          "offsetClose": -30,
          "offsetOpen": 30,
          "timeFrame": {
            "__typename": "TimeFrame",
            "blackout": false,
            "days": [
              4,
              5
            ],
            "duration": "14:30:00",
            "endDate": null,
            "intervalStartTime": "10:00:00",
            "startDate": null,
            "weight": 1
          }
        }
      ],
      "max_future_order_days": null,
      "min_future_order_days": null,
      "occasion": "DELIVERY",
      "service_time_minutes": 30
    }
  ],
  "phone": "+15142826463",
  "store_number": "R34601",
  "timezone": "America/Toronto"
}
```

### Menu categories

- Capability: `restaurants/categories`
- Description: Read the store menu category index.
- Instructions: Read the store menu category index.
- Cost: 5 credits per call
- Capability file: [Menu categories](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/categories)

Accepted options:
- `channel` (string): Pattern: ^([Ww][Ee][Bb]|[Ii][Oo][Ss]|[Aa][Nn][Dd][Rr][Oo][Ii][Dd])$. Example: `WEB`
- `store_number` (string, required): Pattern: ^[A-Za-z0-9]{1,16}$. Example: `<store_number>`

Response schema example:
```json
{
  "categories": [
    {
      "code": "deals",
      "first_item": {
        "code": "CPN-800",
        "name": "PPP 3-Topp or Recipe",
        "type": "bundle"
      },
      "subcategories": []
    },
    {
      "code": "groupmeals",
      "first_item": null,
      "subcategories": []
    }
  ],
  "channel": "WEB",
  "count": 2,
  "menu_code": null,
  "menu_name": null,
  "store_number": "R34601"
}
```

### Category products

- Capability: `restaurants/category`
- Description: Read items in one category and optional subcategories.
- Instructions: Read items in one category and optional subcategories.
- Cost: 5 credits per call
- Capability file: [Category products](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/category)

Accepted options:
- `category_code` (string, required): category_code Example: `<category_code>`
- `channel` (string): Pattern: ^([Ww][Ee][Bb]|[Ii][Oo][Ss]|[Aa][Nn][Dd][Rr][Oo][Ii][Dd])$. Example: `WEB`
- `include_subcategories` (boolean): include_subcategories Example: `false`
- `store_number` (string, required): Pattern: ^[A-Za-z0-9]{1,16}$. Example: `<store_number>`

Response schema example:
```json
{
  "channel": "WEB",
  "code": "deals",
  "counts": {
    "bundles": 2,
    "products": 0,
    "variants": 0
  },
  "items": [
    {
      "availability": {
        "schedule": []
      },
      "blackout_expiry": null,
      "choices": [
        {
          "code": null,
          "name": null,
          "variants": [
            {
              "product_code": "pizza.product.create-your-own-3-topp",
              "upcharge": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "variant_code": null
            },
            {
              "product_code": "pizza.product.veggie-delight",
              "upcharge": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "variant_code": null
            }
          ]
        }
      ],
      "code": "CPN-800",
      "description": "Personal pan 3-topping or recipe",
      "max_cart_quantity": null,
      "metafields": {},
      "name": "PPP 3-Topp or Recipe",
      "price": {
        "amount": 0,
        "currency": "CAD",
        "decimal": 0
      },
      "type": "bundle"
    },
    {
      "availability": {
        "schedule": []
      },
      "blackout_expiry": null,
      "choices": [
        {
          "code": null,
          "name": null,
          "variants": [
            {
              "product_code": "side.product.breadsticks",
              "upcharge": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "variant_code": null
            },
            {
              "product_code": "side.product.waffle-fries",
              "upcharge": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "variant_code": null
            }
          ]
        },
        {
          "code": null,
          "name": null,
          "variants": [
            {
              "product_code": "drink.product.pepsi",
              "upcharge": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "variant_code": null
            },
            {
              "product_code": "drink.product.diet-pepsi",
              "upcharge": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "variant_code": null
            }
          ]
        }
      ],
      "code": "CPN-214",
      "description": "Choice of a side (regular breadsticks, regular fries, 2pc garlic bread) and 2 cans of pop. Upcharges: Bubly, Rockstar",
      "max_cart_quantity": null,
      "metafields": {},
      "name": "Side and 2 Cans",
      "price": {
        "amount": 500,
        "currency": "CAD",
        "decimal": 5
      },
      "type": "bundle"
    }
  ],
  "store_number": "R34601",
  "subcategories": []
}
```

### Product options

- Capability: `restaurants/modifiers`
- Description: Read a product builder with variants, slots, modifiers and prices.
- Instructions: Read a product builder with variants, slots, modifiers and prices.
- Cost: 5 credits per call
- Capability file: [Product options](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/modifiers)

Accepted options:
- `channel` (string): Pattern: ^([Ww][Ee][Bb]|[Ii][Oo][Ss]|[Aa][Nn][Dd][Rr][Oo][Ii][Dd])$. Example: `WEB`
- `product_code` (string, required): product_code Example: `<product_code>`
- `store_number` (string, required): Pattern: ^[A-Za-z0-9]{1,16}$. Example: `<store_number>`

Response schema example:
```json
{
  "availability": {
    "dayparts": [],
    "schedule": []
  },
  "blackout_expiry": null,
  "brand_tags": [
    "halvable"
  ],
  "categories": [],
  "channel": "WEB",
  "code": "pizza.product.create-your-own-3-topp",
  "default_variant_code": "ITEM-1P32Y1P_3T",
  "description": "Create Your Own 3-Topp",
  "metafields": {
    "createYourOwn": "1"
  },
  "name": "Create Your Own 3-Topp",
  "options": [
    {
      "name": "Pizza Size",
      "type_code": "pizza.option.size",
      "values": [
        {
          "blackout_expiry": null,
          "code": "pizza.option.size.school-personal",
          "name": "School Personal"
        },
        {
          "blackout_expiry": null,
          "code": "pizza.option.size.school-medium",
          "name": "School Medium"
        }
      ]
    },
    {
      "name": "Pizza Crust",
      "type_code": "pizza.option.crust",
      "values": [
        {
          "blackout_expiry": null,
          "code": "pizza.option.crust.thin-n-crispy",
          "name": "Thin n crispy"
        },
        {
          "blackout_expiry": null,
          "code": "pizza.option.crust.stuffed",
          "name": "Stuffed"
        }
      ]
    }
  ],
  "promo_tags": [
    "Pizza"
  ],
  "store_number": "R34601",
  "type": "product",
  "variants": [
    {
      "available_in_bundle_only": false,
      "blackout_expiry": null,
      "code": "ITEM-1P22Y1P_3T",
      "default_modifiers": [
        {
          "modifiers": [
            {
              "code": "TOP-41_tomato-sauce",
              "metafields": {},
              "name": "Tomato Sauce.regular",
              "price": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "weight_code": "pizza.weight.sauce.single",
              "weight_value": 1
            }
          ],
          "slot_code": "pizza.slot.sauces"
        },
        {
          "modifiers": [
            {
              "code": "TOP-7W_regular-cheese",
              "metafields": {},
              "name": "Regular Cheese",
              "price": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "weight_code": "pizza.weight.cheese.single",
              "weight_value": 1
            }
          ],
          "slot_code": "pizza.slot.cheeses"
        }
      ],
      "metafields": {},
      "name": "Create Your Own 3-Topp | 12 medium | Pan",
      "nutrition": [
        "calories:1800-2140",
        "serves:8"
      ],
      "price": {
        "amount": 1569,
        "currency": "CAD",
        "decimal": 15.69
      },
      "selected_options": [
        {
          "type_code": "pizza.option.size",
          "type_name": "Pizza Size",
          "value_code": "pizza.option.size.12-medium",
          "value_name": "12 medium"
        },
        {
          "type_code": "pizza.option.crust",
          "type_name": "Pizza Crust",
          "value_code": "pizza.option.crust.pan",
          "value_name": "Pan"
        }
      ],
      "slots": [
        {
          "code": "pizza.slot.sauces",
          "max_weight": 1,
          "metafields": {},
          "min_weight": 1,
          "modifiers": [
            {
              "blackout_expiry": null,
              "code": "TOP-41_tomato-sauce",
              "metafields": {},
              "name": "Tomato Sauce.regular",
              "weights": [
                {
                  "code": "pizza.weight.sauce.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            },
            {
              "blackout_expiry": null,
              "code": "TOP-4172_tomato-sauce",
              "metafields": {},
              "name": "Tomato Sauce.light",
              "weights": [
                {
                  "code": "pizza.weight.sauce.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            }
          ],
          "name": "Pizza Sauces",
          "price_ranges": []
        },
        {
          "code": "pizza.slot.cheeses",
          "max_weight": 1,
          "metafields": {},
          "min_weight": 1,
          "modifiers": [
            {
              "blackout_expiry": null,
              "code": "TOP-7W_regular-cheese",
              "metafields": {},
              "name": "Regular Cheese",
              "weights": [
                {
                  "code": "pizza.weight.cheese.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            },
            {
              "blackout_expiry": null,
              "code": "TOP-3X_extra-cheese",
              "metafields": {},
              "name": "Extra cheese 7",
              "weights": [
                {
                  "code": "pizza.weight.cheese.single",
                  "name": null,
                  "price": {
                    "amount": 200,
                    "currency": "CAD",
                    "decimal": 2
                  },
                  "value": 1
                }
              ]
            }
          ],
          "name": "Pizza Cheese",
          "price_ranges": []
        }
      ]
    },
    {
      "available_in_bundle_only": false,
      "blackout_expiry": null,
      "code": "ITEM-1P22Y1H_3T",
      "default_modifiers": [
        {
          "modifiers": [
            {
              "code": "TOP-41_tomato-sauce",
              "metafields": {},
              "name": "Tomato Sauce.regular",
              "price": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "weight_code": "pizza.weight.sauce.single",
              "weight_value": 1
            }
          ],
          "slot_code": "pizza.slot.sauces"
        },
        {
          "modifiers": [
            {
              "code": "TOP-7W_regular-cheese",
              "metafields": {},
              "name": "Regular Cheese",
              "price": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "weight_code": "pizza.weight.cheese.single",
              "weight_value": 1
            }
          ],
          "slot_code": "pizza.slot.cheeses"
        }
      ],
      "metafields": {},
      "name": "Create Your Own 3-Topp | 12 medium | Handcrafted",
      "nutrition": [
        "calories:1780-2120",
        "serves:8"
      ],
      "price": {
        "amount": 1569,
        "currency": "CAD",
        "decimal": 15.69
      },
      "selected_options": [
        {
          "type_code": "pizza.option.size",
          "type_name": "Pizza Size",
          "value_code": "pizza.option.size.12-medium",
          "value_name": "12 medium"
        },
        {
          "type_code": "pizza.option.crust",
          "type_name": "Pizza Crust",
          "value_code": "pizza.option.crust.handcrafted",
          "value_name": "Handcrafted"
        }
      ],
      "slots": [
        {
          "code": "pizza.slot.sauces",
          "max_weight": 1,
          "metafields": {},
          "min_weight": 1,
          "modifiers": [
            {
              "blackout_expiry": null,
              "code": "TOP-41_tomato-sauce",
              "metafields": {},
              "name": "Tomato Sauce.regular",
              "weights": [
                {
                  "code": "pizza.weight.sauce.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            },
            {
              "blackout_expiry": null,
              "code": "TOP-4172_tomato-sauce",
              "metafields": {},
              "name": "Tomato Sauce.light",
              "weights": [
                {
                  "code": "pizza.weight.sauce.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            }
          ],
          "name": "Pizza Sauces",
          "price_ranges": []
        },
        {
          "code": "pizza.slot.cheeses",
          "max_weight": 1,
          "metafields": {},
          "min_weight": 1,
          "modifiers": [
            {
              "blackout_expiry": null,
              "code": "TOP-7W_regular-cheese",
              "metafields": {},
              "name": "Regular Cheese",
              "weights": [
                {
                  "code": "pizza.weight.cheese.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            },
            {
              "blackout_expiry": null,
              "code": "TOP-3X_extra-cheese",
              "metafields": {},
              "name": "Extra cheese 7",
              "weights": [
                {
                  "code": "pizza.weight.cheese.single",
                  "name": null,
                  "price": {
                    "amount": 200,
                    "currency": "CAD",
                    "decimal": 2
                  },
                  "value": 1
                }
              ]
            }
          ],
          "name": "Pizza Cheese",
          "price_ranges": []
        }
      ]
    }
  ]
}
```

### Full menu

- Capability: `restaurants/menu`
- Description: Read the full menu query with deduplicated products, variants and bundles. Products and variants are paginated (default and maximum 10 each); category/bundle metadata and total counts repeat on each page.
- Instructions: Read the full menu query with deduplicated products, variants and bundles. Products and variants are paginated (default and maximum 10 each); category/bundle metadata and total counts repeat on each page.
- Cost: 5 credits per call
- Capability file: [Full menu](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/menu)

Accepted options:
- `channel` (string): Pattern: ^([Ww][Ee][Bb]|[Ii][Oo][Ss]|[Aa][Nn][Dd][Rr][Oo][Ii][Dd])$. Example: `WEB`
- `page` (number): page Example: `1`
- `page_size` (number): page_size Example: `10`
- `store_number` (string, required): Pattern: ^[A-Za-z0-9]{1,16}$. Example: `<store_number>`

Response schema example:
```json
{
  "bundles": [
    {
      "availability": {
        "__typename": "ItemAvailability",
        "schedule": []
      },
      "blackout_expiry": null,
      "choices": [],
      "code": "CPN-214",
      "description": null,
      "max_cart_quantity": null,
      "metafields": {},
      "name": "Side and 2 Cans",
      "price": {
        "amount": 500,
        "currency": "CAD",
        "decimal": 5
      },
      "type": "bundle"
    },
    {
      "availability": {
        "__typename": "ItemAvailability",
        "schedule": []
      },
      "blackout_expiry": null,
      "choices": [],
      "code": "CPN-800",
      "description": null,
      "max_cart_quantity": null,
      "metafields": {},
      "name": "PPP 3-Topp or Recipe",
      "price": {
        "amount": 0,
        "currency": "CAD",
        "decimal": 0
      },
      "type": "bundle"
    }
  ],
  "categories": [
    {
      "code": "deals",
      "item_count": 2,
      "items": [
        {
          "code": "CPN-800",
          "type": "bundle"
        },
        {
          "code": "CPN-214",
          "type": "bundle"
        }
      ],
      "name": "Deals"
    },
    {
      "code": "groupmeals",
      "item_count": 0,
      "items": [],
      "name": "Group Meals"
    }
  ],
  "channel": "WEB",
  "counts": {
    "bundles": 2,
    "categories": 2,
    "products": 2,
    "slot_modifier_entries": 8,
    "variants": 2
  },
  "menu_code": "menu.ca.online",
  "menu_name": "CA Online Menu",
  "pagination": {
    "next_page": null,
    "page": 1,
    "page_size": 10,
    "returned_products": 2,
    "returned_variants": 2,
    "total_pages": 1
  },
  "products": [
    {
      "availability": {
        "__typename": "ItemAvailability",
        "schedule": []
      },
      "blackout_expiry": null,
      "brand_tags": [
        "popular",
        "hideOptionOnProductCard"
      ],
      "categories": [],
      "code": "dessert.product.cinnabon-mini-rolls-triple-treat",
      "default_variant_code": "ITEM-1E125",
      "description": "Cinnabon Mini Rolls Triple Treat",
      "metafields": {},
      "name": "Cinnabon Mini Rolls Triple Treat",
      "options": [],
      "promo_tags": [],
      "type": "product",
      "variants": [
        {
          "available_in_bundle_only": null,
          "blackout_expiry": null,
          "code": "ITEM-1E125",
          "default_modifiers": [],
          "metafields": {},
          "name": null,
          "nutrition": [
            "calories:900",
            "serves:10"
          ],
          "price": {
            "amount": 899,
            "currency": "CAD",
            "decimal": 8.99
          },
          "selected_options": [
            {
              "type_code": "dessert.option.size",
              "type_name": "Dessert Size",
              "value_code": "dessert.option.size.regular",
              "value_name": "Regular"
            }
          ],
          "slots": []
        }
      ]
    },
    {
      "availability": {
        "__typename": "ItemAvailability",
        "schedule": []
      },
      "blackout_expiry": null,
      "brand_tags": [],
      "categories": [],
      "code": "pizza.product.classic-supreme",
      "default_variant_code": "ITEM-1P22F1P",
      "description": "Classic Supreme",
      "metafields": {},
      "name": "Classic Supreme",
      "options": [],
      "promo_tags": [
        "Pizza",
        "Recipe Pizza"
      ],
      "type": "product",
      "variants": [
        {
          "available_in_bundle_only": null,
          "blackout_expiry": null,
          "code": "ITEM-1P42F1P",
          "default_modifiers": [
            {
              "modifiers": [
                {
                  "code": "TOP-7W_regular-cheese",
                  "metafields": {},
                  "name": "Regular Cheese",
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "weight_code": "pizza.weight.cheese.single",
                  "weight_value": 1
                }
              ],
              "slot_code": "pizza.slot.cheeses"
            },
            {
              "modifiers": [
                {
                  "code": "TOP-41_tomato-sauce",
                  "metafields": {},
                  "name": "Tomato Sauce.regular",
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "weight_code": "pizza.weight.sauce.single",
                  "weight_value": 1
                }
              ],
              "slot_code": "pizza.slot.sauces"
            }
          ],
          "metafields": {},
          "name": null,
          "nutrition": [],
          "price": {
            "amount": 599,
            "currency": "CAD",
            "decimal": 5.99
          },
          "selected_options": [
            {
              "type_code": "pizza.option.size",
              "type_name": "Pizza Size",
              "value_code": "pizza.option.size.6-personal",
              "value_name": "6 personal"
            },
            {
              "type_code": "pizza.option.crust",
              "type_name": "Pizza Crust",
              "value_code": "pizza.option.crust.pan",
              "value_name": "Pan"
            }
          ],
          "slots": [
            {
              "code": "pizza.slot.cheeses",
              "max_weight": 1,
              "metafields": {},
              "min_weight": 1,
              "modifiers": [
                {
                  "blackout_expiry": null,
                  "code": "TOP-7W_regular-cheese",
                  "metafields": {},
                  "name": null,
                  "weights": [
                    {
                      "code": "pizza.weight.cheese.single",
                      "name": null,
                      "price": {
                        "amount": 0,
                        "currency": null,
                        "decimal": 0
                      },
                      "value": 1
                    }
                  ]
                },
                {
                  "blackout_expiry": null,
                  "code": "TOP-3X_extra-cheese",
                  "metafields": {},
                  "name": null,
                  "weights": [
                    {
                      "code": "pizza.weight.cheese.single",
                      "name": null,
                      "price": {
                        "amount": 0,
                        "currency": null,
                        "decimal": 0
                      },
                      "value": 1
                    }
                  ]
                }
              ],
              "name": null,
              "price_ranges": []
            },
            {
              "code": "pizza.slot.sauces",
              "max_weight": 1,
              "metafields": {},
              "min_weight": 1,
              "modifiers": [
                {
                  "blackout_expiry": null,
                  "code": "TOP-41_tomato-sauce",
                  "metafields": {},
                  "name": null,
                  "weights": [
                    {
                      "code": "pizza.weight.sauce.single",
                      "name": null,
                      "price": {
                        "amount": 0,
                        "currency": null,
                        "decimal": 0
                      },
                      "value": 1
                    }
                  ]
                },
                {
                  "blackout_expiry": null,
                  "code": "TOP-4172_tomato-sauce",
                  "metafields": {},
                  "name": null,
                  "weights": [
                    {
                      "code": "pizza.weight.sauce.single",
                      "name": null,
                      "price": {
                        "amount": 0,
                        "currency": null,
                        "decimal": 0
                      },
                      "value": 1
                    }
                  ]
                }
              ],
              "name": null,
              "price_ranges": []
            }
          ]
        },
        {
          "available_in_bundle_only": null,
          "blackout_expiry": null,
          "code": "ITEM-1P12F1P",
          "default_modifiers": [
            {
              "modifiers": [
                {
                  "code": "TOP-7W_regular-cheese",
                  "metafields": {},
                  "name": "Regular Cheese",
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "weight_code": "pizza.weight.cheese.single",
                  "weight_value": 1
                }
              ],
              "slot_code": "pizza.slot.cheeses"
            },
            {
              "modifiers": [
                {
                  "code": "TOP-41_tomato-sauce",
                  "metafields": {},
                  "name": "Tomato Sauce.regular",
                  "price": {
                    "amount": 0,
                    "currency": "CAD",
                    "decimal": 0
                  },
                  "weight_code": "pizza.weight.sauce.single",
                  "weight_value": 1
                }
              ],
              "slot_code": "pizza.slot.sauces"
            }
          ],
          "metafields": {},
          "name": null,
          "nutrition": [],
          "price": {
            "amount": 1299,
            "currency": "CAD",
            "decimal": 12.99
          },
          "selected_options": [
            {
              "type_code": "pizza.option.size",
              "type_name": "Pizza Size",
              "value_code": "pizza.option.size.9-small",
              "value_name": "9 small"
            },
            {
              "type_code": "pizza.option.crust",
              "type_name": "Pizza Crust",
              "value_code": "pizza.option.crust.pan",
              "value_name": "Pan"
            }
          ],
          "slots": [
            {
              "code": "pizza.slot.cheeses",
              "max_weight": 1,
              "metafields": {},
              "min_weight": 1,
              "modifiers": [
                {
                  "blackout_expiry": null,
                  "code": "TOP-7W_regular-cheese",
                  "metafields": {},
                  "name": null,
                  "weights": [
                    {
                      "code": "pizza.weight.cheese.single",
                      "name": null,
                      "price": {
                        "amount": 0,
                        "currency": null,
                        "decimal": 0
                      },
                      "value": 1
                    }
                  ]
                },
                {
                  "blackout_expiry": null,
                  "code": "TOP-3X_extra-cheese",
                  "metafields": {},
                  "name": null,
                  "weights": [
                    {
                      "code": "pizza.weight.cheese.single",
                      "name": null,
                      "price": {
                        "amount": 0,
                        "currency": null,
                        "decimal": 0
                      },
                      "value": 1
                    }
                  ]
                }
              ],
              "name": null,
              "price_ranges": []
            },
            {
              "code": "pizza.slot.sauces",
              "max_weight": 1,
              "metafields": {},
              "min_weight": 1,
              "modifiers": [
                {
                  "blackout_expiry": null,
                  "code": "TOP-41_tomato-sauce",
                  "metafields": {},
                  "name": null,
                  "weights": [
                    {
                      "code": "pizza.weight.sauce.single",
                      "name": null,
                      "price": {
                        "amount": 0,
                        "currency": null,
                        "decimal": 0
                      },
                      "value": 1
                    }
                  ]
                },
                {
                  "blackout_expiry": null,
                  "code": "TOP-4172_tomato-sauce",
                  "metafields": {},
                  "name": null,
                  "weights": [
                    {
                      "code": "pizza.weight.sauce.single",
                      "name": null,
                      "price": {
                        "amount": 0,
                        "currency": null,
                        "decimal": 0
                      },
                      "value": 1
                    }
                  ]
                }
              ],
              "name": null,
              "price_ranges": []
            }
          ]
        }
      ]
    }
  ],
  "store_number": "R34601",
  "uncategorized": {
    "bundles": [],
    "products": [
      "pizza.product.classic-supreme",
      "dessert.product.cinnabon-mini-rolls-triple-treat"
    ],
    "variants": [
      "ITEM-1P42F1P",
      "ITEM-1P12F1P"
    ]
  },
  "variants": [
    {
      "available_in_bundle_only": null,
      "blackout_expiry": null,
      "code": "ITEM-1P12F1P",
      "default_modifiers": [
        {
          "modifiers": [
            {
              "code": "TOP-7W_regular-cheese",
              "metafields": {},
              "name": "Regular Cheese",
              "price": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "weight_code": "pizza.weight.cheese.single",
              "weight_value": 1
            }
          ],
          "slot_code": "pizza.slot.cheeses"
        },
        {
          "modifiers": [
            {
              "code": "TOP-41_tomato-sauce",
              "metafields": {},
              "name": "Tomato Sauce.regular",
              "price": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "weight_code": "pizza.weight.sauce.single",
              "weight_value": 1
            }
          ],
          "slot_code": "pizza.slot.sauces"
        }
      ],
      "metafields": {},
      "name": null,
      "nutrition": [],
      "price": {
        "amount": 1299,
        "currency": "CAD",
        "decimal": 12.99
      },
      "selected_options": [
        {
          "type_code": "pizza.option.size",
          "type_name": "Pizza Size",
          "value_code": "pizza.option.size.9-small",
          "value_name": "9 small"
        },
        {
          "type_code": "pizza.option.crust",
          "type_name": "Pizza Crust",
          "value_code": "pizza.option.crust.pan",
          "value_name": "Pan"
        }
      ],
      "slots": [
        {
          "code": "pizza.slot.cheeses",
          "max_weight": 1,
          "metafields": {},
          "min_weight": 1,
          "modifiers": [
            {
              "blackout_expiry": null,
              "code": "TOP-7W_regular-cheese",
              "metafields": {},
              "name": null,
              "weights": [
                {
                  "code": "pizza.weight.cheese.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": null,
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            },
            {
              "blackout_expiry": null,
              "code": "TOP-3X_extra-cheese",
              "metafields": {},
              "name": null,
              "weights": [
                {
                  "code": "pizza.weight.cheese.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": null,
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            }
          ],
          "name": null,
          "price_ranges": []
        },
        {
          "code": "pizza.slot.sauces",
          "max_weight": 1,
          "metafields": {},
          "min_weight": 1,
          "modifiers": [
            {
              "blackout_expiry": null,
              "code": "TOP-41_tomato-sauce",
              "metafields": {},
              "name": null,
              "weights": [
                {
                  "code": "pizza.weight.sauce.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": null,
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            },
            {
              "blackout_expiry": null,
              "code": "TOP-4172_tomato-sauce",
              "metafields": {},
              "name": null,
              "weights": [
                {
                  "code": "pizza.weight.sauce.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": null,
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            }
          ],
          "name": null,
          "price_ranges": []
        }
      ]
    },
    {
      "available_in_bundle_only": null,
      "blackout_expiry": null,
      "code": "ITEM-1P42F1P",
      "default_modifiers": [
        {
          "modifiers": [
            {
              "code": "TOP-7W_regular-cheese",
              "metafields": {},
              "name": "Regular Cheese",
              "price": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "weight_code": "pizza.weight.cheese.single",
              "weight_value": 1
            }
          ],
          "slot_code": "pizza.slot.cheeses"
        },
        {
          "modifiers": [
            {
              "code": "TOP-41_tomato-sauce",
              "metafields": {},
              "name": "Tomato Sauce.regular",
              "price": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "weight_code": "pizza.weight.sauce.single",
              "weight_value": 1
            }
          ],
          "slot_code": "pizza.slot.sauces"
        }
      ],
      "metafields": {},
      "name": null,
      "nutrition": [],
      "price": {
        "amount": 599,
        "currency": "CAD",
        "decimal": 5.99
      },
      "selected_options": [
        {
          "type_code": "pizza.option.size",
          "type_name": "Pizza Size",
          "value_code": "pizza.option.size.6-personal",
          "value_name": "6 personal"
        },
        {
          "type_code": "pizza.option.crust",
          "type_name": "Pizza Crust",
          "value_code": "pizza.option.crust.pan",
          "value_name": "Pan"
        }
      ],
      "slots": [
        {
          "code": "pizza.slot.cheeses",
          "max_weight": 1,
          "metafields": {},
          "min_weight": 1,
          "modifiers": [
            {
              "blackout_expiry": null,
              "code": "TOP-7W_regular-cheese",
              "metafields": {},
              "name": null,
              "weights": [
                {
                  "code": "pizza.weight.cheese.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": null,
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            },
            {
              "blackout_expiry": null,
              "code": "TOP-3X_extra-cheese",
              "metafields": {},
              "name": null,
              "weights": [
                {
                  "code": "pizza.weight.cheese.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": null,
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            }
          ],
          "name": null,
          "price_ranges": []
        },
        {
          "code": "pizza.slot.sauces",
          "max_weight": 1,
          "metafields": {},
          "min_weight": 1,
          "modifiers": [
            {
              "blackout_expiry": null,
              "code": "TOP-41_tomato-sauce",
              "metafields": {},
              "name": null,
              "weights": [
                {
                  "code": "pizza.weight.sauce.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": null,
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            },
            {
              "blackout_expiry": null,
              "code": "TOP-4172_tomato-sauce",
              "metafields": {},
              "name": null,
              "weights": [
                {
                  "code": "pizza.weight.sauce.single",
                  "name": null,
                  "price": {
                    "amount": 0,
                    "currency": null,
                    "decimal": 0
                  },
                  "value": 1
                }
              ]
            }
          ],
          "name": null,
          "price_ranges": []
        }
      ]
    }
  ]
}
```

### Deal bundles

- Capability: `restaurants/bundles`
- Description: Read deal bundles, optionally selected by code.
- Instructions: Read deal bundles, optionally selected by code.
- Cost: 5 credits per call
- Capability file: [Deal bundles](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/bundles)

Accepted options:
- `bundle_codes` (string[]): bundle_codes Example: `[]`
- `channel` (string): Pattern: ^([Ww][Ee][Bb]|[Ii][Oo][Ss]|[Aa][Nn][Dd][Rr][Oo][Ii][Dd])$. Example: `WEB`
- `store_number` (string, required): Pattern: ^[A-Za-z0-9]{1,16}$. Example: `<store_number>`

Response schema example:
```json
{
  "bundles": [
    {
      "availability": {
        "schedule": [
          {
            "occasion": "DINE_IN",
            "timeFrame": {
              "blackout": false,
              "days": [
                6
              ],
              "duration": "24:00:00",
              "endDate": "2030-01-31",
              "intervalStartTime": "00:00:00",
              "startDate": "2026-04-13",
              "weight": 1
            }
          },
          {
            "occasion": "DELIVERY",
            "timeFrame": {
              "blackout": false,
              "days": [
                6
              ],
              "duration": "24:00:00",
              "endDate": "2030-01-31",
              "intervalStartTime": "00:00:00",
              "startDate": "2026-04-13",
              "weight": 1
            }
          }
        ]
      },
      "blackout_expiry": null,
      "choices": [
        {
          "code": null,
          "name": null,
          "variants": [
            {
              "product_code": "pizza.product.veggie-lovers",
              "upcharge": {
                "amount": 100,
                "currency": "CAD",
                "decimal": 1
              },
              "variant_code": null
            },
            {
              "product_code": "pizza.product.veggie-lovers",
              "upcharge": {
                "amount": 100,
                "currency": "CAD",
                "decimal": 1
              },
              "variant_code": null
            }
          ]
        },
        {
          "code": null,
          "name": null,
          "variants": [
            {
              "product_code": "side.product.boneless-bites",
              "upcharge": {
                "amount": 1199,
                "currency": "CAD",
                "decimal": 11.99
              },
              "variant_code": null
            },
            {
              "product_code": "side.product.boneless-bites",
              "upcharge": {
                "amount": 1199,
                "currency": "CAD",
                "decimal": 11.99
              },
              "variant_code": null
            }
          ]
        }
      ],
      "code": "CPN-837",
      "description": "Saturday Pizza of the Day: Veggie Lover's® or Classic Veggie or Handcrafted Cheddar Bacon Ranch. Upcharges: large pizza, stuffed crust",
      "max_cart_quantity": null,
      "metafields": {
        "choicesLocked": "1"
      },
      "name": "Pizza Of The Day - Veggie Lovers / Classic Veggie / CBR (Saturday)",
      "price": {
        "amount": 1099,
        "currency": "CAD",
        "decimal": 10.99
      },
      "type": "bundle"
    },
    {
      "availability": {
        "schedule": []
      },
      "blackout_expiry": null,
      "choices": [
        {
          "code": null,
          "name": null,
          "variants": [
            {
              "product_code": "pizza.product.create-your-own-2T-max",
              "upcharge": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "variant_code": null
            },
            {
              "product_code": "pizza.product.create-your-own-2T-max",
              "upcharge": {
                "amount": 0,
                "currency": "CAD",
                "decimal": 0
              },
              "variant_code": null
            }
          ]
        }
      ],
      "code": "CPN-901",
      "description": "Hut Rewards (5 points): Free medium 2-topping pizza or regular pasta.",
      "max_cart_quantity": null,
      "metafields": {},
      "name": "Hut Rewards: Free Medium 2-Topp Pizza or Regular Pasta",
      "price": {
        "amount": 0,
        "currency": "CAD",
        "decimal": 0
      },
      "type": "bundle"
    }
  ],
  "channel": "WEB",
  "count": 2,
  "store_number": "R34601"
}
```

### Promotions

- Capability: `restaurants/promotions`
- Description: Read public promotions and their requirements and effects.
- Instructions: Read public promotions and their requirements and effects.
- Cost: 5 credits per call
- Capability file: [Promotions](https://firecrawl.dev/alexandria/agents/providers/pizzahut-ca/restaurants/promotions)

Accepted options:
- `store_number` (string, required): Pattern: ^[A-Za-z0-9]{1,16}$. Example: `<store_number>`

Response schema example:
```json
{
  "count": 2,
  "promotions": [
    {
      "brand_tags": [],
      "description": "Hut Drops: $1 Regular Breadsticks with $15 Minimum",
      "display_name": "Hut Drops: $1 Regular Breadsticks with $15 Minimum",
      "effects": [
        {
          "__typename": "ItemLevelPromotionEffect",
          "items": [
            {
              "__typename": "PromotedItemProductVariant",
              "productCode": "side.product.breadsticks",
              "productVariantCode": "ITEM-2B1"
            }
          ],
          "pricingEffect": {
            "__typename": "FixedPricePromotion",
            "amount": {
              "__typename": "Money",
              "amount": 100
            }
          }
        }
      ],
      "id": "8811a06e-d6a6-40b5-963e-6249fd128c47",
      "metafields": {
        " redirectToCategory": "sides"
      },
      "name": "974 - Hut Drops: $1 Regular Breadsticks with $15 Minimum",
      "redemption_codes": [],
      "requirements": [
        {
          "__typename": "SalesChannelRequirement",
          "salesChannels": [
            "MOBILE",
            "WEB"
          ]
        },
        {
          "__typename": "SubtotalRequirement"
        }
      ]
    },
    {
      "brand_tags": [],
      "description": "Hut Drops: $1 Waffle Fries with $15 Minimum",
      "display_name": "Hut Drops: $1 Waffle Fries with $15 Minimum",
      "effects": [
        {
          "__typename": "ItemLevelPromotionEffect",
          "items": [
            {
              "__typename": "PromotedItemProductVariant",
              "productCode": "side.product.waffle-fries",
              "productVariantCode": "ITEM-2F22W"
            }
          ],
          "pricingEffect": {
            "__typename": "FixedPricePromotion",
            "amount": {
              "__typename": "Money",
              "amount": 100
            }
          }
        }
      ],
      "id": "d1c12a31-7d7e-463b-a76d-b7633ce7c9dd",
      "metafields": {},
      "name": "977 - Hut Drops: $1 Waffle Fries with $15 Minimum",
      "redemption_codes": [],
      "requirements": [
        {
          "__typename": "SalesChannelRequirement",
          "salesChannels": [
            "MOBILE",
            "WEB"
          ]
        },
        {
          "__typename": "SubtotalRequirement"
        }
      ]
    }
  ],
  "store_number": "R34601"
}
```
