--- type: "firecrawl-provider" description: "Disney Store US (www.disneystore.com, formerly shopDisney): current sale/deals listings, keyword search and category listings with sale price, original price and discount, and product detail with per-size variants, availability and the offer's price validity, read from the storefront's server-rendered pages." use_when: "Disney Store US (www.disneystore.com, formerly shopDisney): current sale/deals listings, keyword search and category listings with sale price, original price and discount, and product detail with per-size variants, availability and the offer's price validity, read from the storefront's server-rendered pages." categories: "Retail" capabilities: 4 credits_per_call: 5 --- # Disney Store US (shopDisney) on Firecrawl Alexandria Disney Store US (www.disneystore.com, formerly shopDisney): current sale/deals listings, keyword search and category listings with sale price, original price and discount, and product detail with per-size variants, availability and the offer's price validity, read from the storefront's server-rendered pages. - Categories: Retail - Category index: [Retail category](https://alexandria.firecrawl.dev/agents/categories/retail) - Provider key: `disneystore-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/disneystore-com) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/disneystore-com/openapi.json) ## Capabilities - [Get product](https://alexandria.firecrawl.dev/agents/providers/disneystore-com/products/get_product): One Disney Store product page: title, brand, category, characters, images, current and original price with discount, availability, the offer's priceValidUntil, rating, and per-size or per-option variants with their prices. - [List deals](https://alexandria.firecrawl.dev/agents/providers/disneystore-com/products/list_deals): The Disney Store sale section (/sale/ or one of its subcategories): one page of marked-down products with sale price, original price, discount amount and percent, availability, rating and badge, plus the total number of sale items. - [List products](https://alexandria.firecrawl.dev/agents/providers/disneystore-com/products/list_products): Any Disney Store category, character, franchise or collection listing by URL or path (e.g. /characters/disney/stitch/, /toys/plush/, /sale/clothing/): one page of products with prices and discounts. - [Search products](https://alexandria.firecrawl.dev/agents/providers/disneystore-com/products/search_products): Keyword search of the Disney Store US catalogue. Returns one page of products with current price, original price, discount and availability. Queries the site maps to a category (e.g. a character name) return that category's listing, reported in source_url. ## 1. Choose this provider when Disney Store US (www.disneystore.com, formerly shopDisney): current sale/deals listings, keyword search and category listings with sale price, original price and discount, and product detail with per-size variants, availability and the offer's price validity, read from the storefront's server-rendered pages. ## 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": "disneystore-com", "capability": "products/get_product", "options": { "product_id": "433111351059" } } ``` ## 3. Add provider options Use only the options needed for the task: - `product_id` (string): Storefront product id, e.g. 434080892291 or 5101057751322M. Pattern: ^[0-9]{6,16}[Mm]?$. Example: `` - `url` (string): A disneystore.com or shopdisney.com product page URL ending in -.html. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "disneystore-com", capability: "products/get_product", options: { product_id: "433111351059", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "disneystore-com", "capability": "products/get_product", "options": { "product_id": "433111351059" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "disneystore-com", "capability": "products/get_product", "options": { "product_id": "433111351059" } } }' ``` ### CLI ```sh firecrawl scrape 'disneystore-com/products/get_product' \ --options '{"product_id":"433111351059"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "disneystore-com", "capability": "products/get_product", "options": { "product_id": "433111351059" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "disneystore-com", "capability": "products/get_product", "options": { "product_id": "433111351059" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "availability": "in_stock", "brand": "Disney", "breadcrumb": [ { "name": "Disney Store", "url": "https://www.disneystore.com" }, { "name": "Home", "url": "https://www.disneystore.com/home/" }, { "name": "Drinkware", "url": "https://www.disneystore.com/home/drinkware/" }, { "name": "Mugs", "url": "https://www.disneystore.com/home/drinkware/mugs/" } ], "category": "Mugs", "characters": [ "Stitch" ], "country": "US", "currency": "USD", "department": "Home", "discount_amount": 0, "discount_percent": 0, "images": [ "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-1", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-2", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-3", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-4", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-5" ], "in_stock": true, "list_price": 16.99, "observed_at_ms": 1793897175515, "on_sale": false, "price": 16.99, "price_valid_until": "2100-01-01T06:59:59Z", "product_id": "433111351059", "rating": null, "target_age": "Adults", "title": "Stitch Two Faced Mug – Lilo & Stitch", "url": "https://www.disneystore.com/stitch-two-faced-mug-lilo-stitch-433111351059.html", "variants": [] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get product - Capability: `products/get_product` - Description: One Disney Store product page: title, brand, category, characters, images, current and original price with discount, availability, the offer's priceValidUntil, rating, and per-size or per-option variants with their prices. - Instructions: After list_deals, search_products or list_products, or when the user pastes a product URL, to confirm a deal's price, stock and sizes. - Cost: 5 credits per call - Capability file: [Get product](https://alexandria.firecrawl.dev/agents/providers/disneystore-com/products/get_product) Accepted options: - `product_id` (string): Storefront product id, e.g. 434080892291 or 5101057751322M. Pattern: ^[0-9]{6,16}[Mm]?$. Example: `` - `url` (string): A disneystore.com or shopdisney.com product page URL ending in -.html. Example: `` Response schema example: ```json { "availability": "in_stock", "brand": "Disney", "breadcrumb": [ { "name": "Disney Store", "url": "https://www.disneystore.com" }, { "name": "Home", "url": "https://www.disneystore.com/home/" }, { "name": "Drinkware", "url": "https://www.disneystore.com/home/drinkware/" }, { "name": "Mugs", "url": "https://www.disneystore.com/home/drinkware/mugs/" } ], "category": "Mugs", "characters": [ "Stitch" ], "country": "US", "currency": "USD", "department": "Home", "discount_amount": 0, "discount_percent": 0, "images": [ "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-1", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-2", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-3", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-4", "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931-5" ], "in_stock": true, "list_price": 16.99, "observed_at_ms": 1793897175515, "on_sale": false, "price": 16.99, "price_valid_until": "2100-01-01T06:59:59Z", "product_id": "433111351059", "rating": null, "target_age": "Adults", "title": "Stitch Two Faced Mug – Lilo & Stitch", "url": "https://www.disneystore.com/stitch-two-faced-mug-lilo-stitch-433111351059.html", "variants": [] } ``` ### List deals - Capability: `products/list_deals` - Description: The Disney Store sale section (/sale/ or one of its subcategories): one page of marked-down products with sale price, original price, discount amount and percent, availability, rating and badge, plus the total number of sale items. - Instructions: Start here for Disney Store deals, Black Friday or holiday sales. Follow a product_id into get_product for sizes and the offer's price validity. - Cost: 5 credits per call - Capability file: [List deals](https://alexandria.firecrawl.dev/agents/providers/disneystore-com/products/list_deals) Accepted options: - `category` (string): Sale subcategory; omit for the whole sale section. Example: `accessories` - `page` (number): 1-based page number. Example: `1` - `page_size` (number): Products per page (the site's sz; the UI uses 24). Example: `24` - `sort` (string): Sort rule from the site's sort menu; omit for the site's default order. Example: `most-popular` Response schema example: ```json { "count": 24, "country": "US", "currency": "USD", "next_page": 2, "observed_at_ms": 1793897093481, "on_sale_only": false, "page": 1, "page_size": 24, "products": [ { "availability": "in_stock", "badges": [ "New Markdown" ], "brand": null, "category": "Home Accents", "characters": [ "Minnie Mouse" ], "currency": "USD", "discount_amount": 25.01, "discount_percent": 42, "image_url": "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3408058290351", "list_price": 59.99, "on_sale": true, "price": 34.98, "price_max": null, "product_id": "434080892291", "rating": 5, "title": "Minnie Mouse Cutie Ghost Light-Up Decor – Medium 16''", "url": "https://www.disneystore.com/minnie-mouse-cutie-ghost-light-up-decor-medium-16-434080892291.html" }, { "availability": "in_stock", "badges": [ "New Markdown" ], "brand": null, "category": "Shoes & Socks", "characters": [ "Mickey Mouse" ], "currency": "USD", "discount_amount": 35.01, "discount_percent": 50, "image_url": "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/4202105851120", "list_price": 69.99, "on_sale": true, "price": 34.98, "price_max": null, "product_id": "4202105851120M", "rating": 4.8333, "title": "Mickey Mouse Halloween Clogs for Adults by Crocs", "url": "https://www.disneystore.com/mickey-mouse-halloween-clogs-for-adults-by-crocs-4202105851120M.html" }, { "availability": "in_stock", "badges": [ "Personalize", "New Markdown" ], "brand": null, "category": "Jackets & Sweaters", "characters": [ "Disney Princess" ], "currency": "USD", "discount_amount": 20.01, "discount_percent": 40, "image_url": null, "list_price": 49.99, "on_sale": true, "price": 29.98, "price_max": null, "product_id": "5004108221194M", "rating": 5, "title": "Disney Princess Bomber Jacket for Girls – Personalized", "url": "https://www.disneystore.com/disney-princess-bomber-jacket-for-girls-personalized-5004108221194M.html" } ], "query": null, "sort": null, "source_url": "https://www.disneystore.com/sale/?start=0&sz=24", "title": "Disney Store Sales", "total_count": 953 } ``` ### List products - Capability: `products/list_products` - Description: Any Disney Store category, character, franchise or collection listing by URL or path (e.g. /characters/disney/stitch/, /toys/plush/, /sale/clothing/): one page of products with prices and discounts. - Instructions: When the user pastes a disneystore.com or shopdisney.com listing URL, or to browse a category. Price and attribute filter parameters (pmin, pmax, prefn, prefv) are dropped. - Cost: 5 credits per call - Capability file: [List products](https://alexandria.firecrawl.dev/agents/providers/disneystore-com/products/list_products) Accepted options: - `page` (number): 1-based page number. Example: `1` - `page_size` (number): Products per page (the site's sz; the UI uses 24). Example: `24` - `sort` (string): Sort rule from the site's sort menu; omit for the site's default order. Example: `most-popular` - `url` (string, required): A disneystore.com or shopdisney.com listing URL, or a path starting with /. Example: `` Response schema example: ```json { "count": 24, "country": "US", "currency": "USD", "next_page": 2, "observed_at_ms": 1793897108125, "on_sale_only": false, "page": 1, "page_size": 24, "products": [ { "availability": "in_stock", "badges": [ "New" ], "brand": null, "category": "Mugs", "characters": [ "Stitch" ], "currency": "USD", "discount_amount": 0, "discount_percent": 0, "image_url": "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931", "list_price": 16.99, "on_sale": false, "price": 16.99, "price_max": null, "product_id": "433111351059", "rating": null, "title": "Stitch Two Faced Mug – Lilo & Stitch", "url": "https://www.disneystore.com/stitch-two-faced-mug-lilo-stitch-433111351059.html" }, { "availability": "in_stock", "badges": [ "New" ], "brand": null, "category": "Mugs", "characters": [], "currency": "USD", "discount_amount": 0, "discount_percent": 0, "image_url": "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690932", "list_price": 16.99, "on_sale": false, "price": 16.99, "price_max": null, "product_id": "433111351134", "rating": null, "title": "The Lion King Mug", "url": "https://www.disneystore.com/the-lion-king-mug-433111351134.html" }, { "availability": "in_stock", "badges": [ "New" ], "brand": null, "category": "Mugs", "characters": [ "Eeyore" ], "currency": "USD", "discount_amount": 0, "discount_percent": 0, "image_url": "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690934", "list_price": 16.99, "on_sale": false, "price": 16.99, "price_max": null, "product_id": "433111351394", "rating": null, "title": "Eeyore Floral Mug – Winnie the Pooh", "url": "https://www.disneystore.com/eeyore-floral-mug-winnie-the-pooh-433111351394.html" } ], "query": null, "sort": null, "source_url": "https://www.disneystore.com/home/drinkware/mugs/?start=0&sz=24", "title": "Disney Mugs & Coffee Cups", "total_count": 109 } ``` ### Search products - Capability: `products/search_products` - Description: Keyword search of the Disney Store US catalogue. Returns one page of products with current price, original price, discount and availability. Queries the site maps to a category (e.g. a character name) return that category's listing, reported in source_url. - Instructions: When the user names a character, franchise or product in free text. Set on_sale_only to keep only discounted items on the page. - Cost: 5 credits per call - Capability file: [Search products](https://alexandria.firecrawl.dev/agents/providers/disneystore-com/products/search_products) Accepted options: - `on_sale_only` (boolean): Drop products that are not marked down from the returned page. Filtering is per page; total_count and next_page still describe the unfiltered results. Example: `false` - `page` (number): 1-based page number. Example: `1` - `page_size` (number): Products per page (the site's sz; the UI uses 24). Example: `24` - `query` (string, required): Search words, as typed into the site's search box. Example: `` - `sort` (string): Sort rule from the site's sort menu; omit for the site's default order. Example: `most-popular` Response schema example: ```json { "count": 24, "country": "US", "currency": "USD", "next_page": 2, "observed_at_ms": 1793897137135, "on_sale_only": false, "page": 1, "page_size": 24, "products": [ { "availability": "in_stock", "badges": [ "Toys for Tots", "Limited Time Offer" ], "brand": null, "category": "Plush", "characters": [ "Stitch" ], "currency": "USD", "discount_amount": 3, "discount_percent": 10, "image_url": "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/1515055006293", "list_price": 29.99, "on_sale": true, "price": 26.99, "price_max": null, "product_id": "415152300548", "rating": null, "title": "Stitch Plush – Lilo & Stitch – Medium 15 3/4'' – Toys for Tots Donation Item", "url": "https://www.disneystore.com/stitch-plush-lilo-stitch-medium-15-34-toys-for-tots-donation-item-415152300548.html" }, { "availability": "in_stock", "badges": [ "New" ], "brand": null, "category": "Mugs", "characters": [ "Stitch" ], "currency": "USD", "discount_amount": 0, "discount_percent": 0, "image_url": "https://cdn-ssl.s7.shopdisney.com/is/image/DisneyShopping/3311056690931", "list_price": 16.99, "on_sale": false, "price": 16.99, "price_max": null, "product_id": "433111351059", "rating": null, "title": "Stitch Two Faced Mug – Lilo & Stitch", "url": "https://www.disneystore.com/stitch-two-faced-mug-lilo-stitch-433111351059.html" }, { "availability": "in_stock", "badges": [ "New" ], "brand": null, "category": "Mugs", "characters": [ "Stitch" ], "currency": "USD", "discount_amount": 0, "discount_percent": 0, "image_url": null, "list_price": 24.99, "on_sale": false, "price": 24.99, "price_max": null, "product_id": "433111351967", "rating": null, "title": "Stitch Sculpted Mug – Lilo & Stitch", "url": "https://www.disneystore.com/stitch-sculpted-mug-lilo-stitch-433111351967.html" } ], "query": "stitch", "sort": null, "source_url": "https://www.disneystore.com/characters/disney/stitch/?originalTerm=stitch&searchType=redirect&pdpRedirect=0", "title": "Disney Stitch Merchandise", "total_count": 197 } ```