# US Foods Catalog Scraper | Brands, Specs, Images (`parseforge/us-foods-catalog-scraper`) Actor Scrape the US Foods public product catalog for brands, case sizes, serving sizes, features, and images. Export JSON, CSV, Excel, XML for restaurant procurement. - **URL**: https://apify.com/parseforge/us-foods-catalog-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg) ## ๐Ÿฝ๏ธ US Foods Catalog Scraper > ๐Ÿš€ **Export the US Foods public product catalog in seconds.** Collect titles, brands, case sizes, descriptions, features, benefits, and images for foodservice products. No API key, no registration, no manual CSV wrangling. > ๐Ÿ•’ **Last updated:** 2026-05-23 ยท **๐Ÿ“Š 16 fields** per record ยท **500+ products** ยท **30+ brands** ยท **JSON / CSV / Excel / XML export** US Foods is one of the two largest broadline foodservice distributors in the United States, serving more than **250,000 restaurants, healthcare operations, schools, hotels, and independent kitchens**. Its public product catalog at `usfoods.com/products-we-offer` showcases the proprietary brand lineup that distinguishes the company from rivals like Sysco. This Actor walks that public catalog end-to-end and returns one clean JSON record per product, ready for spreadsheets, dashboards, AI pipelines, or vendor benchmarking workflows. The scraper enumerates every product URL exposed by the official `sitemap.xml`, then parses each detail page server-side. Output includes the **primary image**, **product title**, **internal product ID**, **brand name**, **brand logo**, **rich description**, **case size**, **serving size**, **servings per case**, an **ordered list of features**, an **ordered list of benefits**, optional **regulatory disclaimers**, and a **gallery of all carousel images**. Every record is timestamped with `scrapedAt` so you can run the Actor on a schedule and diff snapshots over time. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | Restaurant owners and executive chefs | Build a unified product database for cross-distributor comparison | | Restaurant group purchasing managers | Track US Foods brand portfolio changes week over week | | Hospital, school, and hotel food service directors | Populate menu engineering tools with case-size and servings data | | Foodservice consultants and procurement analysts | Audit vendor product mix and surface new launches | | Market research and competitive intelligence teams | Map the US Foods proprietary brand catalog by category | | Data engineers building AI agents for hospitality | Feed clean, structured product data into LLM workflows | --- ### ๐Ÿ“‹ What the US Foods Catalog Scraper does - ๐Ÿ“‚ **Crawls the full public catalog.** Walks the official sitemap to discover every product URL in `usfoods.com/products-we-offer/`. - ๐Ÿท๏ธ **Captures brand context.** Extracts brand name and brand logo image for every record so you can group products by proprietary line. - ๐Ÿ“ฆ **Returns pack and yield specs.** Pulls case size, serving size, and servings per case directly from the structured product spec block. - ๐Ÿ“ **Preserves marketing copy verbatim.** Saves the long-form description, features list, benefits list, and any regulatory disclaimer text. - ๐Ÿ–ผ๏ธ **Keeps the entire image gallery.** Stores the hero image plus every carousel image so you can render product cards downstream. - ๐ŸŽฏ **Supports targeted runs.** Pass a list of specific product URLs to skip the sitemap and scrape only what you need. Each record arrives as a flat JSON object with predictable field ordering: image first, identifiers next, then specs, then arrays, then a `scrapedAt` timestamp and `error` slot. The shape is stable across runs, which makes downstream parsing trivial in pandas, BigQuery, Airtable, or any spreadsheet tool. > ๐Ÿ’ก **Why it matters:** restaurants on 3-9% profit margins lose real money when food cost benchmarking is manual. A clean US Foods catalog feed is the missing piece for any procurement workflow that already tracks Sysco, Restaurant Depot, or other broadline distributors. --- ### ๐ŸŽฌ Full Demo ๐Ÿšง Coming soon: a 3-minute walkthrough showing how to launch a run, filter results, and export to Google Sheets. --- ### โš™๏ธ Input
FieldTypeDefaultDescription
productUrlsarray of strings[]Optional. Specific US Foods product URLs to scrape, e.g. https://www.usfoods.com/products-we-offer/product.1-diced-beef.html. Leave empty to crawl the full public catalog from the sitemap.
maxItemsinteger10Hard cap on records returned. Free plans are limited to 10. Paid plans support up to 1,000,000.
Example: crawl 50 products straight from the sitemap. ```json { "maxItems": 50 } ```` Example: scrape only a curated short list. ```json { "productUrls": [ "https://www.usfoods.com/products-we-offer/product.1-diced-beef.html", "https://www.usfoods.com/products-we-offer/product.100-key-lime-juice.html", "https://www.usfoods.com/products-we-offer/product.12-raised-edge-parbaked-pizza-crust.html" ], "maxItems": 3 } ``` > โš ๏ธ **Good to Know:** the US Foods public catalog is a marketing showcase of the proprietary brand portfolio. It does not expose customer-specific contract pricing, which lives behind the ordering portal and varies by account. Treat this Actor as a product specification feed, not a real-time price feed. *** ### ๐Ÿ“Š Output Every product is returned as one flat JSON object. Fields are ordered for predictable downstream parsing: image first, then identifiers, specs, arrays, and a timestamp. #### ๐Ÿงพ Schema | Field | Type | Example | |---|---|---| | ๐Ÿ–ผ `imageUrl` | string | `https://www.usfoods.com/content/dam/products/eb/10750947006746_C1CF_2522811.jpg` | | ๐Ÿ“Œ `title` | string | `1" Diced Beef` | | ๐Ÿ”— `url` | string | `https://www.usfoods.com/products-we-offer/product.1-diced-beef.html` | | ๐Ÿ†” `productId` | string | `2522811` | | ๐Ÿท๏ธ `brand` | string | `STOCK YARDSยฎ` | | ๐ŸŽจ `brandImageUrl` | string | `https://www.usfoods.com/content/dam/.../STOCKYARDS-L-C.svg` | | ๐Ÿ“ `description` | string | `Elevate your comfort food offerings with Stock Yards Diced Beef...` | | ๐Ÿ“ฆ `caseSize` | string | `2/5 LB.` | | ๐Ÿฝ `servingSize` | string | null | `100 g` | | ๐Ÿ”ข `servingsPerCase` | string | null | `45` | | โœจ `features` | array\ | null | `["USDA Choice Grade", "NAMP/MBG: 135A", ...]` | | ๐Ÿ’Ž `benefits` | array\ | null | `["Labor-saving: diced and frozen...", ...]` | | โš–๏ธ `disclaimers` | string | null | `*Processing aids and potential cross-contact...` | | ๐Ÿ–ผ `imageUrls` | array\ | `["https://www.usfoods.com/content/dam/products/.../...jpg"]` | | ๐Ÿ•’ `scrapedAt` | string (ISO 8601) | `2026-05-23T12:15:36.682Z` | | โŒ `error` | string | null | `null` | #### ๐Ÿ“ฆ Sample records
๐Ÿฅฉ Typical product with full spec block (Stock Yards Diced Beef) ```json { "imageUrl": "https://www.usfoods.com/content/dam/products/eb/10750947006746_C1CF_2522811.jpg", "title": "1\" Diced Beef", "url": "https://www.usfoods.com/products-we-offer/product.1-diced-beef.html", "productId": "2522811", "brand": "STOCK YARDSยฎ", "brandImageUrl": "https://www.usfoods.com/content/dam/us-foods/platforms/www/misc/logos/STOCKYARDS-L-C%20copy.svg", "description": "Elevate your comfort food offerings with Stock Yardsยฎ Diced Beef. Cut from premium beef, it brings rich flavor and hearty texture to stews, kabobs, pot pies, and other crowd-pleasing favorites. This versatile, high-quality beef is a perfect addition to any menu, providing a flavorful, revenue-generating option for your operation.", "caseSize": "2/5 LB.", "servingSize": "100 g", "servingsPerCase": "45", "features": [ "USDA Choice Grade", "NAMP/MBG: 135A", "1\" diced from quality cuts of beef" ], "benefits": [ "Labor-saving: diced and frozen, saving your kitchen staff valuable prep time", "Versatile: can be utilized as an ingredient for a variety of crowd-pleasing and classic menu items" ], "disclaimers": null, "imageUrls": [ "https://www.usfoods.com/content/dam/products/eb/10750947006746_C1CF_2522811.jpg" ], "scrapedAt": "2026-05-23T12:15:36.764Z", "error": null } ```
๐Ÿ‹ Edge case: ingredient with high yield and no benefits block (Key Lime Juice) ```json { "imageUrl": "https://www.usfoods.com/content/dam/products/scoop/50758108659068_C1CD.jpg", "title": "100% Key Lime Juice", "url": "https://www.usfoods.com/products-we-offer/product.100-key-lime-juice.html", "productId": "6773402", "brand": "RYKOFF SEXTONยฎ", "brandImageUrl": "https://www.usfoods.com/content/dam/us-foods/platforms/www/misc/logos/RS_S_B_12172013-K%20copy.svg", "description": "Our 100% Key Lime Juice is fresh squeezed, never from concentrate, and gently pasteurized at a lower temperature than most juices for a clean, fresh taste. It is vastly superior to traditional shelf-stable reconstituted lime juices. Our all-natural juices will energize your recipes with delightfully sweet, punchy and tart flavors. Perfect for pies, sauces, cocktails and signature dishes.", "caseSize": "12/32 OZ", "servingSize": "5 ml", "servingsPerCase": "2268", "features": [ "Bold, fresh key lime flavor", "Gently pasteurized for the freshest taste", "All-natural, minimally processed", "Each 32-ounce bottle contains the equivalent of 22 limes", "50 day shelf life from production" ], "benefits": null, "disclaimers": null, "imageUrls": [ "https://www.usfoods.com/content/dam/products/scoop/50758108659068_C1CD.jpg" ], "scrapedAt": "2026-05-23T12:15:36.795Z", "error": null } ```
๐Ÿ“ฆ Sparse non-edible: disposable foam container with no serving info ```json { "imageUrl": "https://www.usfoods.com/content/dam/products/eb/50758108673736_C1CD.jpg", "title": "1-Compartment Dual-Tab Foam Container", "url": "https://www.usfoods.com/products-we-offer/product.1-compartment-dual-tab-foam-container.html", "productId": "7804644", "brand": "VALU+PLUSยฎ", "brandImageUrl": "https://www.usfoods.com/content/dam/us-foods/platforms/www/misc/logos/VALUEPLUS-PRI-M-C%20copy.svg", "description": "Valu+Plus single-compartment foam food containers make it a cinch to transport hot or cold food making carryout possible and complementing any \"to go\" program.", "caseSize": "150 EA", "servingSize": null, "servingsPerCase": null, "features": [ "Height 3.25 in.", "Increased structural strength", "Economy 9 in. x 9 in. foam 1-compartment container", "Sturdy, non-absorbent, insulated and lightweight for easy handling", "Stacking rim design prevents food damage when containers are stacked" ], "benefits": [ "Convenient", "One-way service reduces food costs, transport, labor, breakage and simplifies foodservice operations for takeout", "Single-use sanitary product prevents the spread of germs" ], "disclaimers": null, "imageUrls": [ "https://www.usfoods.com/content/dam/products/eb/50758108673736_C1CD.jpg" ], "scrapedAt": "2026-05-23T12:15:36.682Z", "error": null } ```
*** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐Ÿš€ | **Fast crawl path.** Pure HTTP fetch plus Cheerio parsing. No browser, no proxy lock-in, no captcha dance. | | ๐Ÿงฑ | **Stable field shape.** Every record matches the schema above, so your downstream code never breaks on missing keys. | | ๐Ÿ“ฆ | **Real pack and yield data.** Case size, serving size, and servings per case parsed straight from the spec block. | | ๐Ÿท๏ธ | **Brand grouping ready.** Brand name and brand logo on every record lets you cluster the proprietary portfolio. | | ๐Ÿ–ผ๏ธ | **Image-first ordering.** Hero image is field one, gallery is preserved, so product cards render cleanly. | | ๐ŸŽฏ | **URL targeting.** Pass a list of specific product URLs for incremental updates or quality-control sweeps. | | โฑ๏ธ | **Timestamped output.** `scrapedAt` on every record makes longitudinal tracking and diffing painless. | > ๐Ÿ“Š A full sitemap pass returns roughly **500 products** in under **three minutes** on a single Apify run. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | Manual browsing | Free, but hours per week | One product at a time | Whenever you remember | None | Copy-paste hell | | Official publications | Free, very limited | Marketing PDFs only | Quarterly at best | None | Manual parsing | | Paid live distributor APIs | High monthly fee | Customer-account scoped | Real-time | Account-level | Vendor onboarding | | Legacy community dumps | Free | Stale, often years old | Never | None | Out of date | | **โญ US Foods Catalog Scraper** *(this Actor)* | Pay only for what you run | Full public sitemap | On demand or scheduled | URL list, item cap | One click | The right pick depends on whether you need authoritative, live, public catalog data or a contract-pricing data feed. This Actor covers the first cleanly, no friction. *** ### ๐Ÿš€ How to use 1. ๐Ÿ” **Sign up for Apify.** Create a free account at [console.apify.com](https://console.apify.com/sign-up?fpr=vmoqkp). No credit card needed. 2. ๐Ÿฝ๏ธ **Open the Actor.** Land on the US Foods Catalog Scraper page on the Apify Store. 3. โš™๏ธ **Set your input.** Leave `productUrls` empty for a full crawl, or paste specific product URLs. Set `maxItems` to whatever you need. 4. โ–ถ๏ธ **Hit Start.** The Actor enumerates the sitemap and scrapes each page. Free runs cap at 10 records for preview. 5. ๐Ÿ“ฅ **Export your data.** Download as JSON, CSV, Excel, or XML. Connect to Google Sheets, Airtable, Slack, Make, or your own backend. > โฑ๏ธ Total time from sign-up to first dataset: about **two minutes**. *** ### ๐Ÿ’ผ Business use cases
#### ๐Ÿฝ๏ธ Independent restaurants - Build a US Foods reference list to negotiate pricing with reps - Track new brand launches in the proprietary portfolio - Cross-check case-size and yield specs against menu costing tools - Spot product reformulations by diffing descriptions over time #### ๐Ÿข Group purchasing managers - Maintain a unified product catalog across multiple distributors - Map US Foods proprietary brands to category benchmarks - Feed procurement dashboards with brand and yield context - Generate vendor-side reports for finance and operations leads
#### ๐Ÿฅ Institutional foodservice - Populate dietitian tools with serving size and pack data - Audit broadline distributor coverage for hospital and school menus - Spot supply gaps when planning multi-site catering rotations - Build internal request portals seeded with real product copy #### ๐Ÿ“Š Procurement analysts and consultants - Map the foodservice brand landscape for clients - Generate competitive intelligence reports on broadline product mix - Track product launches and discontinuations between snapshots - Power AI shopping agents with structured catalog data
*** ### ๐ŸŒŸ Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Empirical datasets for papers, thesis work, and coursework - Longitudinal studies tracking changes across snapshots - Reproducible research with cited, versioned data pulls - Classroom exercises on data analysis and ethical scraping #### ๐ŸŽจ Personal and creative - Side projects, portfolio demos, and indie app launches - Data visualizations, dashboards, and infographics - Content research for bloggers, YouTubers, and podcasters - Hobbyist collections and personal trackers
#### ๐Ÿค Non-profit and civic - Transparency reporting and accountability projects - Advocacy campaigns backed by public-interest data - Community-run databases for local issues - Investigative journalism on public records #### ๐Ÿงช Experimentation - Prototype AI and machine-learning pipelines with real data - Validate product-market hypotheses before engineering spend - Train small domain-specific models on niche corpora - Test dashboard concepts with live input
*** ### ๐Ÿ”Œ Automating US Foods Catalog Scraper Trigger and consume runs from any stack. Apify exposes a REST API plus first-party Node.js and Python SDKs. - ๐ŸŸฉ **Node.js SDK:** see the [JavaScript client docs](https://docs.apify.com/api/client/js/) for `runActor`, polling, and dataset streaming. - ๐Ÿ **Python SDK:** the [Python client docs](https://docs.apify.com/api/client/python/) cover the same surface with idiomatic Python. - ๐Ÿ“š **API reference:** the full [Apify REST API](https://docs.apify.com/api/v2) lets you wire runs into any HTTP-capable system. Schedule recurring catalog snapshots with [Apify Schedules](https://docs.apify.com/platform/schedules) and feed deltas into your warehouse, BI tool, or alerting workflow. Daily, weekly, or monthly cadences are all easy to set up from the console. *** ### โ“ Frequently Asked Questions
๐Ÿ“ฆ What exactly does this Actor return? A flat JSON record per product with 16 fields: hero image, title, URL, internal product ID, brand, brand logo, description, case size, serving size, servings per case, features list, benefits list, regulatory disclaimers, full image gallery, `scrapedAt` timestamp, and an `error` slot.
๐Ÿ”ข How many products are in the catalog? The public sitemap exposes roughly 500 proprietary products at any given time. Numbers shift as US Foods launches new SKUs and retires others.
๐Ÿ’ฒ Does the Actor return prices? No. The public catalog is a brand showcase. Customer pricing is account-specific and lives behind the ordering portal. Use this Actor for product specifications, not for live pricing.
๐Ÿ›’ Can I target specific products instead of the full catalog? Yes. Pass a list of product URLs in `productUrls` and the Actor will skip the sitemap and scrape only those URLs.
โฑ๏ธ How fast is a full crawl? A complete sitemap pass over roughly 500 products finishes in about three minutes on default Apify hardware.
๐Ÿ” Can I schedule recurring runs? Yes. Use the built-in [Apify Schedules](https://docs.apify.com/platform/schedules) to run daily, weekly, or monthly snapshots. Diff outputs to track new launches and discontinuations.
๐Ÿ“Š What export formats are supported? JSON, CSV, Excel, XML, RSS, and HTML. Also accessible as a live API endpoint via the dataset URL on every run.
๐Ÿ†“ Is there a free plan? Yes. Free runs cap at 10 records so you can validate the schema and quality before upgrading.
๐Ÿ’ผ Can I use the data commercially? The Actor pulls only publicly available data published by US Foods on their public website. You are responsible for ensuring your specific downstream use aligns with US Foods' published terms and any applicable laws.
๐Ÿ’ณ Do I need a paid Apify plan? A free Apify account is enough to test with up to 10 records. Beyond that, any of Apify's paid plans unlocks the full sitemap and large batches.
๐Ÿ› ๏ธ What if a run fails or returns fewer items than expected? Open the run in the Apify console and check the log. Failures are usually transient and resolve on retry. If issues persist, reach out via the contact form below with your run ID.
โš–๏ธ Is scraping the US Foods public catalog legal? The Actor only fetches publicly available pages, exactly as a normal browser would. Legality depends on your jurisdiction and your specific downstream use. Consult counsel when in doubt.
*** ### ๐Ÿ”Œ Integrate with any app Connect the Actor to whichever tools you already use. Apify Integrations cover the popular automation stack. - [**Make**](https://apify.com/integrations) - drag-and-drop workflows triggered by completed runs - [**Zapier**](https://apify.com/integrations) - push records into thousands of Zapier-supported apps - [**Slack**](https://apify.com/integrations) - post run summaries to a team channel - [**Airbyte**](https://apify.com/integrations) - stream datasets into Snowflake, BigQuery, or Postgres - [**GitHub Actions**](https://apify.com/integrations) - kick off runs from CI pipelines - [**Google Drive**](https://apify.com/integrations) - sync exports to a shared folder *** ### ๐Ÿ”— Recommended Actors - [**๐Ÿฅซ Sysco Food Service Scraper**](https://apify.com/parseforge/sysco-scraper) - the other broadline giant. Pair with this Actor for cross-distributor comparison. - [**๐Ÿณ CHEF'STORE Wholesale Food Price Scraper**](https://apify.com/parseforge/restaurant-depot-sysco-us-foods-chef-store-scraper) - cash-and-carry pricing across all CHEF'STORE locations. - [**๐Ÿ“ฆ Uline Product Catalog Scraper**](https://apify.com/parseforge/uline-scraper) - packaging, foodservice supplies, and operational consumables. - [**๐Ÿ›’ Costco Product Scraper**](https://apify.com/parseforge/costco-scraper) - bulk retail comparison for restaurants and independent operators. - [**๐Ÿพ Chewy.com Product Scraper**](https://apify.com/parseforge/chewy-com-scraper) - structured product catalogs from large ecommerce surfaces. > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more foodservice and ecommerce data tools. *** **๐Ÿ†˜ Need Help?** Stuck on input config or want a custom field added? [**Open our contact form**](https://tally.so/r/BzdKgA) and we will get back to you fast. *** > **โš ๏ธ Disclaimer:** this is an independent tool built by ParseForge. It is not affiliated with, endorsed by, or sponsored by US Foods Holding Corp. or any of its subsidiaries. Only publicly available data is collected. # Actor input Schema ## `productUrls` (type: `array`): Optional. Specific US Foods product URLs to scrape (e.g. https://www.usfoods.com/products-we-offer/product.dulce-de-leche-layered-cake.html). Leave empty to crawl the full public catalog from the sitemap. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "productUrls": [], "maxItems": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "productUrls": [], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/us-foods-catalog-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "productUrls": [], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/us-foods-catalog-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "productUrls": [], "maxItems": 10 }' | apify call parseforge/us-foods-catalog-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/us-foods-catalog-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US Foods Catalog Scraper | Brands, Specs, Images", "description": "Scrape the US Foods public product catalog for brands, case sizes, serving sizes, features, and images. Export JSON, CSV, Excel, XML for restaurant procurement.", "version": "0.1", "x-build-id": "w7it36xB08GZY0NxJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~us-foods-catalog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-us-foods-catalog-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~us-foods-catalog-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-us-foods-catalog-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~us-foods-catalog-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-us-foods-catalog-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "productUrls": { "title": "Product URLs", "uniqueItems": true, "type": "array", "description": "Optional. Specific US Foods product URLs to scrape (e.g. https://www.usfoods.com/products-we-offer/product.dulce-de-leche-layered-cake.html). Leave empty to crawl the full public catalog from the sitemap.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```