--- type: "firecrawl-provider" description: "Discover Pizza Hut US stores and read menus, products, modifiers, bundles and the paginated store directory." use_when: "Discover Pizza Hut US stores and read menus, products, modifiers, bundles and the paginated store directory." categories: "Restaurant" capabilities: 7 credits_per_call: 5 --- # Pizza Hut US on Firecrawl Alexandria Discover Pizza Hut US stores and read menus, products, modifiers, bundles and the paginated store directory. - Categories: Restaurant - Category index: [Restaurant category](https://firecrawl.dev/alexandria/agents/categories/restaurant) - Provider key: `pizzahut-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/pizzahut-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/openapi.json) ## Capabilities - [Bundles](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/bundles): Read Pizza Hut US bundles and their choices; optionally filter by bundle codes. The list is the store's raw point-of-sale bundle set; each bundle carries the store's redeemable_online and visible_online flags, and bundles with either flag false are not orderable or shown on pizzahut.com. - [Categories](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/categories): List menu categories and subcategories for a Pizza Hut US store, with the first item in each. - [Category](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/category): Read products, variants and bundles in a Pizza Hut US menu category. Categories such as deals return the store's raw point-of-sale bundle list; each bundle carries the store's redeemable_online and visible_online flags, and bundles with either flag false (POS-only, employee and other offline-only bundles) are not orderable or shown on pizzahut.com. - [Directory](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/directory): Page through the Pizza Hut US store directory, optionally filtered by state. Resume with next_cursor when has_more is true. - [Modifiers](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/modifiers): Read a Pizza Hut US product with variants, options, modifier slots, weights and prices. - [Store](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/store): Read one Pizza Hut US store, including address, hours, order availability and tax configuration. - [Stores](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/stores): Find Pizza Hut US stores near a five-digit postal code for carryout, or the stores that deliver to a street address (occasion DELIVERY with address). Upstream returns the nearest stores regardless of distance: check postal_code_match, nearest_distance_miles and warnings before treating the first store as local. ## 1. Choose this provider when Discover Pizza Hut US stores and read menus, products, modifiers, bundles and the paginated store directory. ## 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-com", "capability": "restaurants/bundles", "options": { "bundle_codes": [ "MEALM82I7" ], "store_number": "040588" } } ``` ## 3. Add provider options Use only the options needed for the task: - `bundle_codes` (string[]): bundle_codes Example: `[]` - `channel` (string): channel Example: `WEB` - `store_number` (string, required): Zero-padded Pizza Hut US store number returned by stores or directory. Pattern: ^[0-9]{1,20}$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "pizzahut-com", capability: "restaurants/bundles", options: { bundle_codes: [ "MEALM82I7", ], store_number: "040588", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "pizzahut-com", "capability": "restaurants/bundles", "options": { "bundle_codes": [ "MEALM82I7" ], "store_number": "040588" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "pizzahut-com", "capability": "restaurants/bundles", "options": { "bundle_codes": [ "MEALM82I7" ], "store_number": "040588" } } }' ``` ### CLI ```sh firecrawl scrape 'pizzahut-com/restaurants/bundles' \ --options '{"bundle_codes":["MEALM82I7"],"store_number":"040588"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "pizzahut-com", "capability": "restaurants/bundles", "options": { "bundle_codes": [ "MEALM82I7" ], "store_number": "040588" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "pizzahut-com", "capability": "restaurants/bundles", "options": { "bundle_codes": [ "MEALM82I7" ], "store_number": "040588" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "bundles": [ { "availability": { "schedule": [] }, "blackout_expiry": null, "choices": [ { "code": null, "name": null, "variants": [ { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 200, "currency": "USD", "decimal": 2 }, "variant_code": null }, { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 300, "currency": "USD", "decimal": 3 }, "variant_code": null } ] }, { "code": null, "name": null, "variants": [ { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null } ] }, { "code": null, "name": null, "variants": [ { "product_code": "CLSS070A|PROD496CS", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null } ] } ], "code": "MEALM82I7", "description": null, "max_cart_quantity": null, "metafields": { "strategy-description": "I7 YA" }, "name": "Large 1-Top + 6pc WS Trad Wings + Cheese Sticks", "price": { "amount": 3099, "currency": "USD", "decimal": 30.99 }, "redeemable_online": true, "type": "bundle", "visible_online": false } ], "channel": "WEB", "count": 1, "store_number": "040588" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Bundles - Capability: `restaurants/bundles` - Description: Read Pizza Hut US bundles and their choices; optionally filter by bundle codes. The list is the store's raw point-of-sale bundle set; each bundle carries the store's redeemable_online and visible_online flags, and bundles with either flag false are not orderable or shown on pizzahut.com. - Instructions: Read Pizza Hut US bundles and their choices; optionally filter by bundle codes. For online deals and prices, keep only bundles whose redeemable_online and visible_online are true. - Cost: 5 credits per call - Capability file: [Bundles](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/bundles) Accepted options: - `bundle_codes` (string[]): bundle_codes Example: `[]` - `channel` (string): channel Example: `WEB` - `store_number` (string, required): Zero-padded Pizza Hut US store number returned by stores or directory. Pattern: ^[0-9]{1,20}$. Example: `` Response schema example: ```json { "bundles": [ { "availability": { "schedule": [] }, "blackout_expiry": null, "choices": [ { "code": null, "name": null, "variants": [ { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 200, "currency": "USD", "decimal": 2 }, "variant_code": null }, { "product_code": "CLSS001P|PROD010B_CYO1T", "upcharge": { "amount": 300, "currency": "USD", "decimal": 3 }, "variant_code": null } ] }, { "code": null, "name": null, "variants": [ { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null }, { "product_code": "CLSS010WS|BASE831TD", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null } ] }, { "code": null, "name": null, "variants": [ { "product_code": "CLSS070A|PROD496CS", "upcharge": { "amount": 0, "currency": "USD", "decimal": 0 }, "variant_code": null } ] } ], "code": "MEALM82I7", "description": null, "max_cart_quantity": null, "metafields": { "strategy-description": "I7 YA" }, "name": "Large 1-Top + 6pc WS Trad Wings + Cheese Sticks", "price": { "amount": 3099, "currency": "USD", "decimal": 30.99 }, "redeemable_online": true, "type": "bundle", "visible_online": false } ], "channel": "WEB", "count": 1, "store_number": "040588" } ``` ### Categories - Capability: `restaurants/categories` - Description: List menu categories and subcategories for a Pizza Hut US store, with the first item in each. - Instructions: List menu categories and subcategories for a Pizza Hut US store, with the first item in each. - Cost: 5 credits per call - Capability file: [Categories](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/categories) Accepted options: - `channel` (string): channel Example: `WEB` - `store_number` (string, required): Zero-padded Pizza Hut US store number returned by stores or directory. Pattern: ^[0-9]{1,20}$. Example: `` Response schema example: ```json { "categories": [ { "code": "hut_remix", "first_item": null, "subcategories": [ { "code": " hut_remix_pizza", "first_item": null }, { "code": "hut_remix_wings", "first_item": null }, { "code": "hut_remix_sticks", "first_item": null }, { "code": "hut_remix_melts", "first_item": null }, { "code": " hut_remix_pasta", "first_item": null }, { "code": "hut_remix_desserts", "first_item": null } ] }, { "code": "throwbackmenu", "first_item": null, "subcategories": [] }, { "code": "deals", "first_item": { "code": "MEALP36PP", "name": "PPP 1-Top (Carryout) Limit 6", "type": "bundle" }, "subcategories": [] }, { "code": "pizza", "first_item": { "code": "CLSS001P|PROD660SB", "name": "Chicken Sausage Bacon Classic Pizza", "type": "product" }, "subcategories": [] }, { "code": "melts", "first_item": { "code": "CLSS001P|PROD233BC", "name": "Buffalo Chicken Melt", "type": "product" }, "subcategories": [] }, { "code": "wings", "first_item": { "code": "CLSS010WS|BASE515BO", "name": "Boneless Wings", "type": "product" }, "subcategories": [] }, { "code": "partyofone", "first_item": { "code": "variant_CLSS001_010B_SIZE020P_BASE015P", "name": "Personal Pan Pizza®", "type": "variant" }, "subcategories": [] }, { "code": "sides", "first_item": { "code": "CLSS070A|PROD528ND", "name": "Bacon Cheddar Cheese Sticks", "type": "product" }, "subcategories": [] }, { "code": "sandwiches", "first_item": null, "subcategories": [] }, { "code": "pasta", "first_item": { "code": "CLSS060PS|PROD276FM", "name": "Buffet Triple Cheese Mac Pasta", "type": "product" }, "subcategories": [] }, { "code": "salads", "first_item": { "code": "CLSS050SL|PROD461GN", "name": "Garden Salad", "type": "product" }, "subcategories": [] }, { "code": "desserts", "first_item": { "code": "CLSS080D|PROD804B", "name": "Triple Chocolate Brownie", "type": "product" }, "subcategories": [] }, { "code": "dips", "first_item": { "code": "CLSS070A|PROD871AN", "name": "Ranch Dip Cup", "type": "product" }, "subcategories": [] }, { "code": "drinks", "first_item": { "code": "CLSS032CB|PROD670LF", "name": "Lipton Fusions Strawberry Lemonade Tea", "type": "product" }, "subcategories": [] }, { "code": "lineup", "first_item": { "code": "CLSS001P|PROD010B_CYO1T", "name": "CYO 1-Top Pizza", "type": "product" }, "subcategories": [] }, { "code": "Alcohol", "first_item": null, "subcategories": [] }, { "code": "Buffet", "first_item": { "code": "CLSS070A|PROD063BF", "name": "Buffet Sticks", "type": "product" }, "subcategories": [] }, { "code": "Donation/Fees", "first_item": { "code": "CLSS110PA|PROD0365D", "name": "$5 Donation", "type": "product" }, "subcategories": [] }, { "code": "Gift Card", "first_item": { "code": "CLSS135GC|PROD020GC", "name": "Gift Card", "type": "product" }, "subcategories": [] }, { "code": "KFC", "first_item": null, "subcategories": [] }, { "code": "promo", "first_item": null, "subcategories": [] } ], "channel": "WEB", "count": 21, "menu_code": null, "menu_name": null, "store_number": "040588" } ``` ### Category - Capability: `restaurants/category` - Description: Read products, variants and bundles in a Pizza Hut US menu category. Categories such as deals return the store's raw point-of-sale bundle list; each bundle carries the store's redeemable_online and visible_online flags, and bundles with either flag false (POS-only, employee and other offline-only bundles) are not orderable or shown on pizzahut.com. - Instructions: Read products, variants and bundles in a Pizza Hut US menu category. For online deals and prices, keep only bundles whose redeemable_online and visible_online are true. - Cost: 5 credits per call - Capability file: [Category](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/category) Accepted options: - `category_code` (string, required): category_code Example: `` - `channel` (string): channel Example: `WEB` - `include_modifiers` (boolean): Include each variant's default-modifier tree (names, weights, prices, metafields). Off by default: default_modifiers is then null and the payload is a fraction of the size; use modifiers for the full tree of one product. Example: `false` - `include_subcategories` (boolean): include_subcategories Example: `false` - `store_number` (string, required): Zero-padded Pizza Hut US store number returned by stores or directory. Pattern: ^[0-9]{1,20}$. Example: `` Response schema example: ```json { "channel": "WEB", "code": "pizza", "counts": { "bundles": 0, "products": 20, "variants": 349 }, "items": [ { "availability": { "dayparts": [], "schedule": [] }, "blackout_expiry": null, "brand_tags": [ "PIZZA", "AUTO_MODIFY" ], "categories": [ "pizza" ], "code": "CLSS001P|PROD660SB", "default_variant_code": "variant_CLSS001_660SB_SIZE060L_BASE435TV", "description": "A savory-sweet combination of sweet marinara, chicken sausage, bacon & tomatoes. Try it on our Tavern Style crust. Prices, partic., & avail. may vary. Addtl. charge for extra cheese & toppings. ", "metafields": { "long-description": "Chicken Sausage Bacon Classic", "short-description": "ckSau Bcn" }, "name": "Chicken Sausage Bacon Classic Pizza", "options": [ { "name": "Pizza Crust", "type_code": "option_pizza_crust", "values": [ { "blackout_expiry": null, "code": "CLSS001P|BASE020H", "name": "Hand-Tossed Pizza" } ] }, { "name": "Pizza Size", "type_code": "option_pizza_size", "values": [ { "blackout_expiry": null, "code": "CLSS001P|SIZE964MH", "name": "My Hut Box" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE165DD", "name": "Deep Dish" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE133XT", "name": "Xtra Large" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE020P", "name": "Personal Pan" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE040S", "name": "Small" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE050M", "name": "Medium" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE060L", "name": "Large" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE170HT", "name": "Heart" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE988TR", "name": "Medium" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE135EL", "name": "Extra Large" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE214GF", "name": "Gluten Free 10 inch" }, { "blackout_expiry": null, "code": "CLSS001P|SIZE835TT", "name": "Take Two" } ] } ], "promo_tags": [ "4 All Specialties", "103 All Pizzas" ], "type": "product", "variants": [ { "available_in_bundle_only": false, "blackout_expiry": null, "code": "variant_CLSS001_660SB_SIZE040S_BASE010T", "default_modifiers": null, "metafields": {}, "name": "Small Thin 'N Crispy® Chicken Sausage Bacon Classic Pizza", "nutrition": [ "name:", "calories:120", "servings:8", "unit:slice", "units:slices", "portion:0" ], "price": { "amount": 1169, "currency": "USD", "decimal": 11.69 }, "selected_options": [ { "type_code": "option_pizza_crust", "type_name": "Pizza Crust", "value_code": "CLSS001P|BASE010T", "value_name": "Thin 'N Crispy®" }, { "type_code": "option_pizza_size", "type_name": "Pizza Size", "value_code": "CLSS001P|SIZE040S", "value_name": "Small" } ] } ] } ], "store_number": "040588", "subcategories": [] } ``` ### Directory - Capability: `restaurants/directory` - Description: Page through the Pizza Hut US store directory, optionally filtered by state. Resume with next_cursor when has_more is true. - Instructions: Page through the Pizza Hut US store directory, optionally filtered by state. Resume with next_cursor when has_more is true. - Cost: 5 credits per call - Capability file: [Directory](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/directory) Accepted options: - `cursor` (string): cursor Example: `` - `max_pages` (number): max_pages Example: `3` - `state` (string): Pattern: ^[A-Z]{2}$. Example: `` Response schema example: ```json { "count": 144, "has_more": false, "next_cursor": null, "pages_fetched": 2, "state": "NY", "stores": [ { "accepting_online_orders": true, "address": { "city": "Newark", "country": "US", "line1": "1 Menu Management Dr", "line2": "", "postal_code": "14513", "state": "NY" }, "allows_future_orders": true, "appears_in_search": false, "archived": false, "delivery_providers": [ { "__typename": "StoreDeliveryProvider", "deliveryProvider": "INTERNAL", "enabled": true } ], "future_order_days": 7, "handoff_modes": null, "latitude": -22.1, "longitude": 79.3019, "metafields": { "manuallyOffline": "false" }, "name": "000001", "occasions": [ { "enabled": true, "hours": [ { "__typename": "StoreOccasionTimeFrame", "offsetClose": 0, "offsetOpen": 0, "timeFrame": { "__typename": "TimeFrame", "blackout": false, "days": [ 1, 2, 3, 7 ], "duration": "15:00:00", "endDate": null, "intervalStartTime": "08:00:00", "startDate": null, "weight": 0 } }, { "__typename": "StoreOccasionTimeFrame", "offsetClose": 0, "offsetOpen": 0, "timeFrame": { "__typename": "TimeFrame", "blackout": false, "days": [ 4 ], "duration": "17:00:00", "endDate": null, "intervalStartTime": "08:00:00", "startDate": null, "weight": 0 } }, { "__typename": "StoreOccasionTimeFrame", "offsetClose": 0, "offsetOpen": 0, "timeFrame": { "__typename": "TimeFrame", "blackout": false, "days": [ 5, 6 ], "duration": "16:00:00", "endDate": null, "intervalStartTime": "08:00:00", "startDate": null, "weight": 0 } } ], "max_future_order_days": null, "min_future_order_days": null, "occasion": "CARRYOUT", "service_time_minutes": 15 }, { "enabled": true, "hours": [ { "__typename": "StoreOccasionTimeFrame", "offsetClose": 0, "offsetOpen": 0, "timeFrame": { "__typename": "TimeFrame", "blackout": false, "days": [ 1, 2, 3, 4, 7 ], "duration": "15:00:00", "endDate": null, "intervalStartTime": "08:00:00", "startDate": null, "weight": 0 } }, { "__typename": "StoreOccasionTimeFrame", "offsetClose": 0, "offsetOpen": 0, "timeFrame": { "__typename": "TimeFrame", "blackout": false, "days": [ 5, 6 ], "duration": "16:00:00", "endDate": null, "intervalStartTime": "08:00:00", "startDate": null, "weight": 0 } } ], "max_future_order_days": null, "min_future_order_days": null, "occasion": "DELIVERY", "service_time_minutes": 30 } ], "phone": "+18001234567", "store_number": "000001", "timezone": "America/New_York" }, { "accepting_online_orders": true, "address": { "city": "Newark", "country": "US", "line1": "99 Menu Management Dr", "line2": "", "postal_code": "14513", "state": "NY" }, "allows_future_orders": true, "appears_in_search": false, "archived": false, "delivery_providers": [ { "__typename": "StoreDeliveryProvider", "deliveryProvider": "INTERNAL", "enabled": true } ], "future_order_days": 7, "handoff_modes": null, "latitude": -22.1, "longitude": 79.30191, "metafields": { "manuallyOffline": "false" }, "name": "000002", "occasions": [ { "enabled": true, "hours": [ { "__typename": "StoreOccasionTimeFrame", "offsetClose": 0, "offsetOpen": 0, "timeFrame": { "__typename": "TimeFrame", "blackout": false, "days": [ 1, 2, 3, 4, 7 ], "duration": "16:45:00", "endDate": null, "intervalStartTime": "06:15:00", "startDate": null, "weight": 0 } }, { "__typename": "StoreOccasionTimeFrame", "offsetClose": 0, "offsetOpen": 0, "timeFrame": { "__typename": "TimeFrame", "blackout": false, "days": [ 5, 6 ], "duration": "17:45:00", "endDate": null, "intervalStartTime": "06:15:00", "startDate": null, "weight": 0 } } ], "max_future_order_days": null, "min_future_order_days": null, "occasion": "CARRYOUT", "service_time_minutes": 15 }, { "enabled": true, "hours": [ { "__typename": "StoreOccasionTimeFrame", "offsetClose": 0, "offsetOpen": 0, "timeFrame": { "__typename": "TimeFrame", "blackout": false, "days": [ 1, 2, 3, 4, 7 ], "duration": "16:45:00", "endDate": null, "intervalStartTime": "06:15:00", "startDate": null, "weight": 0 } }, { "__typename": "StoreOccasionTimeFrame", "offsetClose": 0, "offsetOpen": 0, "timeFrame": { "__typename": "TimeFrame", "blackout": false, "days": [ 5, 6 ], "duration": "17:45:00", "endDate": null, "intervalStartTime": "06:15:00", "startDate": null, "weight": 0 } } ], "max_future_order_days": null, "min_future_order_days": null, "occasion": "DELIVERY", "service_time_minutes": 30 } ], "phone": "+18001234567", "store_number": "000002", "timezone": "America/Chicago" } ], "total_reported": 144 } ``` ### Modifiers - Capability: `restaurants/modifiers` - Description: Read a Pizza Hut US product with variants, options, modifier slots, weights and prices. - Instructions: Read a Pizza Hut US product with variants, options, modifier slots, weights and prices. - Cost: 5 credits per call - Capability file: [Modifiers](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/modifiers) Accepted options: - `channel` (string): channel Example: `WEB` - `product_code` (string, required): product_code Example: `` - `store_number` (string, required): Zero-padded Pizza Hut US store number returned by stores or directory. Pattern: ^[0-9]{1,20}$. Example: `` Response schema example: ```json { "availability": { "dayparts": [], "schedule": [] }, "blackout_expiry": null, "brand_tags": [ "PIZZA" ], "categories": [ "pizza" ], "channel": "WEB", "code": "CLSS001P|PROD660SB", "default_variant_code": "variant_CLSS001_660SB_SIZE060L_BASE435TV", "description": "A savory-sweet combination of sweet marinara, chicken sausage, bacon & tomatoes. Try it on our Tavern Style crust. Prices, partic., & avail. may vary. Addtl. charge for extra cheese & toppings. ", "metafields": { "long-description": "Chicken Sausage Bacon Classic", "short-description": "ckSau Bcn" }, "name": "Chicken Sausage Bacon Classic Pizza", "options": [ { "name": "Pizza Crust", "type_code": "option_pizza_crust", "values": [ { "blackout_expiry": null, "code": "CLSS001P|BASE020H", "name": "Hand-Tossed Pizza" } ] } ], "promo_tags": [ "4 All Specialties" ], "store_number": "040588", "type": "product", "variants": [ { "available_in_bundle_only": false, "blackout_expiry": null, "code": "variant_CLSS001_660SB_SIZE040S_BASE010T", "default_modifiers": [ { "modifiers": [ { "code": "CLSS001P|TOPP732SW", "metafields": { "short-description": "SWeet Sce" }, "name": "Sweet Marinara", "price": { "amount": 0, "currency": "USD", "decimal": 0 }, "weight_code": "WHOLE_REGULAR", "weight_value": 1 } ], "slot_code": "slot_pizza_sauce" } ], "metafields": {}, "name": "Small Thin 'N Crispy® Chicken Sausage Bacon Classic Pizza", "nutrition": [ "name:" ], "price": { "amount": 1169, "currency": "USD", "decimal": 11.69 }, "selected_options": [ { "type_code": "option_pizza_crust", "type_name": "Pizza Crust", "value_code": "CLSS001P|BASE010T", "value_name": "Thin 'N Crispy®" } ], "slots": [ { "code": "slot_pizza_sauce", "max_weight": 1, "metafields": {}, "min_weight": 0, "modifiers": [ { "blackout_expiry": null, "code": "CLSS001P|TOPP721PS", "metafields": { "short-description": "Pizza Sc" }, "name": "Classic Marinara", "weights": [ { "code": "CLSS001P|TOPP701EZ", "name": "Light Sauce", "price": { "amount": 0, "currency": "USD", "decimal": 0 }, "value": 1 } ] } ], "name": "Pizza Sauce", "price_ranges": [] } ] } ] } ``` ### Store - Capability: `restaurants/store` - Description: Read one Pizza Hut US store, including address, hours, order availability and tax configuration. - Instructions: Read one Pizza Hut US store, including address, hours, order availability and tax configuration. - Cost: 5 credits per call - Capability file: [Store](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/store) Accepted options: - `store_number` (string, required): Zero-padded Pizza Hut US store number returned by stores or directory. Pattern: ^[0-9]{1,20}$. Example: `` Response schema example: ```json { "address": "1242 NEWPORT AVENUE", "allows_future_orders": true, "availability": [ { "days": [ 1, 2, 3, 4, 7 ], "duration": "13:00:00", "interval_start_time": "10:00:00", "occasion_id": "CARRYOUT" }, { "days": [ 5, 6 ], "duration": "14:00:00", "interval_start_time": "10:00:00", "occasion_id": "CARRYOUT" }, { "days": [ 1 ], "duration": "13:00:00", "interval_start_time": "10:00:00", "occasion_id": "CARRYOUT", "weight": 1 }, { "days": [ 1, 2, 3, 4, 7 ], "duration": "13:00:00", "interval_start_time": "10:00:00", "occasion_id": "DELIVERY" }, { "days": [ 5, 6 ], "duration": "14:00:00", "interval_start_time": "10:00:00", "occasion_id": "DELIVERY" }, { "days": [ 1 ], "duration": "13:00:00", "interval_start_time": "10:00:00", "occasion_id": "DELIVERY", "weight": 1 } ], "base_delivery_charge": null, "city": "PAWTUCKET", "country": "USA", "distance": null, "future_order_days": 7, "hours": [ { "days": [ 1, 2, 3, 4, 7 ], "duration": "13:00:00", "interval_start_time": "10:00:00", "occasion_id": "CARRYOUT" }, { "days": [ 5, 6 ], "duration": "14:00:00", "interval_start_time": "10:00:00", "occasion_id": "CARRYOUT" }, { "days": [ 1 ], "duration": "13:00:00", "interval_start_time": "10:00:00", "occasion_id": "CARRYOUT", "weight": 1 }, { "days": [ 1, 2, 3, 4, 7 ], "duration": "13:00:00", "interval_start_time": "10:00:00", "occasion_id": "DELIVERY" }, { "days": [ 5, 6 ], "duration": "14:00:00", "interval_start_time": "10:00:00", "occasion_id": "DELIVERY" }, { "days": [ 1 ], "duration": "13:00:00", "interval_start_time": "10:00:00", "occasion_id": "DELIVERY", "weight": 1 } ], "landmark": null, "latitude": null, "longitude": null, "occasions": [ { "allow_tip": true, "apply_discount_to_net": true, "max_order": 100000, "name": "Carryout", "occasion_id": "CARRYOUT", "service_time": 15 }, { "allow_tip": true, "apply_discount_to_net": true, "display_order": 1, "is_min_with_discount": true, "max_order": 100000, "min_order": 1500, "name": "Delivery", "occasion_id": "DELIVERY", "service_time": 30 } ], "online_status": "online", "payment_types": [ { "max_order": 100000, "metadata": { "accepted_cc_types": [ "VISA", "MC", "DISC", "AMEX" ] }, "name": "APPLEPAY", "occasions": [ "CARRYOUT", "DELIVERY" ], "type": "applepay" }, { "max_order": 100000, "metadata": { "accepted_cc_types": [ "VISA", "MC", "DISC", "AMEX" ] }, "name": "CARD_ON_DELIVERY", "occasions": [ "CARRYOUT" ], "type": "card_on_delivery" }, { "max_order": 100000, "name": "CASH", "occasions": [ "CARRYOUT" ], "type": "cash" }, { "max_order": 100000, "metadata": { "accepted_cc_types": [ "VISA", "MC", "DISC", "AMEX" ] }, "name": "CREDITCARD", "occasions": [ "CARRYOUT", "DELIVERY" ], "type": "creditcard" }, { "max_order": 100000, "name": "GIFTCARD", "occasions": [ "CARRYOUT", "DELIVERY" ], "type": "giftcard" }, { "max_order": 100000, "metadata": { "accepted_cc_types": [ "VISA", "MC", "DISC", "AMEX" ] }, "name": "GOOGLEPAY", "occasions": [ "CARRYOUT", "DELIVERY" ], "type": "googlepay" }, { "max_order": 100000, "metadata": { "accepted_cc_types": [ "VISA", "MC", "DISC", "AMEX" ] }, "name": "PAYPAL", "occasions": [ "CARRYOUT", "DELIVERY" ], "type": "paypal" }, { "max_order": 100000, "metadata": { "accepted_cc_types": [ "VISA", "MC", "DISC", "AMEX" ] }, "name": "VENMO", "occasions": [ "CARRYOUT", "DELIVERY" ], "type": "venmo" } ], "phone": "(401) 722-4222", "postal_code": "02861", "start_of_day": "00:00:00", "state": "RI", "status": "DC", "store_id": "040588", "store_number": "040588", "taxes": [ { "application_stage": 1, "name": "Sales Tax", "tax_id": "desc1", "tax_rate": -1 }, { "application_stage": 1, "name": "desc2", "tax_id": "desc2", "tax_rate": -1 }, { "application_stage": 1, "name": "desc3", "tax_id": "desc3", "tax_rate": -1 }, { "application_stage": 1, "name": "desc4", "tax_id": "desc4", "tax_rate": -1 } ], "timezone": "America/New_York" } ``` ### Stores - Capability: `restaurants/stores` - Description: Find Pizza Hut US stores near a five-digit postal code for carryout, or the stores that deliver to a street address (occasion DELIVERY with address). Upstream returns the nearest stores regardless of distance: check postal_code_match, nearest_distance_miles and warnings before treating the first store as local. - Instructions: Discover nearby Pizza Hut stores and their store numbers, addresses, hours and supported occasions. - Cost: 5 credits per call - Capability file: [Stores](https://firecrawl.dev/alexandria/agents/providers/pizzahut-com/restaurants/stores) Accepted options: - `address` (string): Street address to deliver to (e.g. `400 Pine St`); required with occasion DELIVERY and refused with CARRYOUT. Example: `400 Pine St` - `occasion` (string): CARRYOUT (default) finds the nearest stores to postal_code. DELIVERY finds the stores that deliver to address in postal_code and requires address. Example: `CARRYOUT` - `postal_code` (string, required): Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "count": 30, "nearest_distance_miles": 0.605042, "postal_code_match": false, "query": { "address": null, "occasion": "CARRYOUT", "postal_code": "10001" }, "stores": [ { "address": "264 WEST 23RD STREET", "allows_future_orders": true, "base_delivery_charge": 599, "city": "NEW YORK", "country": "USA", "distance": { "unit": "mi", "value": "0.605042" }, "distance_miles": 0.605042, "future_order_days": 7, "hours": [ { "days": [ 7, 1, 2, 3 ], "duration": "13:00:00", "interval_start_time": "11:00:00", "occasion_id": "CARRYOUT" }, { "days": [ 6, 4, 5 ], "duration": "16:00:00", "interval_start_time": "11:00:00", "occasion_id": "CARRYOUT" }, { "days": [ 7, 1, 2, 3 ], "duration": "12:45:00", "interval_start_time": "11:00:00", "occasion_id": "DELIVERY" }, { "days": [ 6, 4, 5 ], "duration": "15:45:00", "interval_start_time": "11:00:00", "occasion_id": "DELIVERY" } ], "landmark": null, "latitude": 40.74496, "longitude": -73.998193, "occasions": [ { "allow_tip": true, "apply_discount_to_net": true, "max_order": 100000, "name": "Carryout", "occasion_id": "CARRYOUT", "service_time": 15 }, { "allow_tip": true, "apply_discount_to_net": true, "display_order": 1, "is_min_with_discount": true, "max_order": 100000, "min_order": 1099, "name": "Delivery", "occasion_id": "DELIVERY", "service_time": 45 } ], "online_status": "online", "payment_types": null, "phone": "(646) 532-6486", "postal_code": "10011", "state": "NY", "status": "DC", "store_id": "041923", "store_number": "041923", "timezone": "America/New_York" }, { "address": "932 8TH AVE", "allows_future_orders": true, "base_delivery_charge": 599, "city": "NEW YORK", "country": "USA", "distance": { "unit": "mi", "value": "1.156951" }, "distance_miles": 1.156951, "future_order_days": 7, "hours": [ { "days": [ 6, 7, 1, 2, 3, 4, 5 ], "duration": "16:00:00", "interval_start_time": "11:00:00", "occasion_id": "CARRYOUT" }, { "days": [ 6, 7, 1, 3, 4, 5 ], "duration": "15:45:00", "interval_start_time": "11:00:00", "occasion_id": "DELIVERY" }, { "days": [ 2 ], "duration": "16:00:00", "interval_start_time": "11:00:00", "occasion_id": "DELIVERY" } ], "landmark": null, "latitude": 40.7655, "longitude": -73.9835, "occasions": [ { "allow_tip": true, "apply_discount_to_net": true, "max_order": 100000, "name": "Carryout", "occasion_id": "CARRYOUT", "service_time": 15 }, { "allow_tip": true, "apply_discount_to_net": true, "display_order": 1, "is_min_with_discount": true, "max_order": 100000, "min_order": 1099, "name": "Delivery", "occasion_id": "DELIVERY", "service_time": 45 } ], "online_status": "online", "payment_types": null, "phone": "(929) 645-2154", "postal_code": "10019", "state": "NY", "status": "DC", "store_id": "040937", "store_number": "040937", "timezone": "America/New_York" } ], "warnings": [ "No returned store is in postal code 10001; the nearest, store 041923, is 0.61 mi away in 10011." ] } ```