# Food Allergen Label Checker: US, EU & AU (`ultimatemc/food-allergen-label-checker`) Actor

Check grocery and food product ingredient lists against the 'Contains' allergen statement: US 9 major allergens (incl. sesame), EU/UK 14 allergens and Australia PEAL. Flags missing allergens, unnamed tree nuts or fish species, free-from claims that conflict, and skips false friends like coconut.

- **URL**: https://apify.com/ultimatemc/food-allergen-label-checker.md
- **Developed by:** [Ultimate Foresight Inc](https://apify.com/ultimatemc) (community)
- **Categories:** E-commerce, Business, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

Check **grocery and food product ingredient lists** against their **"Contains" allergen statements** for **US (FALCPA and the FASTER Act, 9 major allergens including sesame)**, **EU/UK (14 allergens, Regulation 1169/2011)** or **Australia and New Zealand (FSANZ Plain English Allergen Labelling)** rules. The **Food Allergen Label Checker** finds allergens in ingredients that the statement leaves out, **tree nuts or fish without the specific name**, **"free-from" claims that conflict** with the ingredients or a "may contain" warning, and **coconut listed as a major allergen** after FDA's 2025 update. It knows the false friends, such as **coconut, nutmeg, butternut squash, water chestnut, buckwheat, cocoa butter and oat milk**. Click **Start** with the prefilled example to see it work.

> This is automated keyword screening of label text, not a determination that a label complies or that a food is safe for anyone with an allergy. It can't detect cross-contact or allergens missing from the text supplied. Not legal or medical advice; every row carries this disclaimer and a timestamp.

### What does the Food Allergen Label Checker do?

- ✅ **Allergen missing from the Contains statement** (US) or **summary statement** (Australia/NZ PEAL): for example whey or butter in the ingredients but no milk declared.
- ✅ **Allergen source not named** (US, no Contains statement): ingredients like casein without "(milk)" next to them.
- ✅ **Tree nut type or fish species not named**: FDA requires "almonds" or "cod", not just "tree nuts" or "fish".
- ✅ **Coconut in the Contains statement**: removed from FDA's tree nut list in its January 2025 guidance (Edition 5).
- ✅ **Free-from conflicts**: "dairy-free" with milk ingredients, or "nut-free" next to "may contain nuts".
- ✅ **EU/UK emphasis**: when ingredient lists include HTML bold tags, allergens that aren't emphasised are flagged (Regulation 1169/2011 Art. 21).
- ✅ **False friends skipped**: coconut, nutmeg, butternut squash, water chestnut, buckwheat, cocoa/shea/peanut butter, cream of tartar, lactic acid, milk thistle, oyster mushroom and plant milks.
- ✅ Output per product: `region`, `allergensFound`, `allergenTerms`, `declaredAllergens`, `mayContain`, `riskLevel`, `issues` (`ruleId`, `severity`, `allergen`, `matchedTerms`, `message`, `sourceUrl`, `fixHint`), `checkedAt` and a disclaimer.

### Who is it for?

- **Food brands and private-label teams** reviewing label copy before print or listing.
- **Grocery retailers and online marketplaces** auditing product data from suppliers.
- **Allergy apps, nutrition databases and data teams** cleaning scraped grocery data (Woolworths, Coles, Tesco, Walmart, Instacart, Open Food Facts).
- **Food safety consultants** running a first pass over large catalogs.

### How to check food labels for allergen gaps

1. Click **Start** with the prefilled example (four products showing common gaps and a clean label).
2. Replace **Products** with your own: `ingredients`, `contains`, optional `mayContain`, `claims`, `title` and `region`.
3. Or enter a **Dataset ID** from a grocery scraper. Common fields are detected automatically; use **Field map** with dotted paths for nested ones.
4. Choose **Allergen rules** (US, EU, UK, AU or NZ) for rows without their own `region`.
5. Turn on **Only save rows with findings**, then export as CSV, Excel or JSON.

### Input example

This is the prefilled input:

```json
{
  "products": [
    {
      "id": "EXAMPLE-COOKIES",
      "title": "Example chocolate chip cookies",
      "ingredients": "Enriched wheat flour, sugar, chocolate chips (sugar, cocoa butter, milk fat), butter, eggs, pecans, salt, soy lecithin.",
      "contains": "Contains: wheat, milk, egg, soy."
    },
    {
      "id": "EXAMPLE-GRANOLA",
      "title": "Example nut-free granola",
      "claims": "Nut-free",
      "ingredients": "Rolled oats, honey, sunflower seeds, coconut. May contain peanuts and tree nuts."
    },
    {
      "id": "EXAMPLE-CURRY",
      "title": "Example coconut curry sauce",
      "ingredients": "Coconut milk, water, onion, nutmeg, butternut squash, salt, spices.",
      "contains": "Contains: coconut."
    },
    {
      "id": "EXAMPLE-CRACKERS",
      "title": "Example sesame crackers",
      "ingredients": "Wheat flour, sesame seeds, olive oil, salt.",
      "contains": "Contains: wheat, sesame."
    }
  ]
}
```

Dataset mode:

```json
{"datasetId": "YOUR_DATASET_ID", "fieldMap": {"ingredients": "AdditionalAttributes.ingredients", "contains": "AdditionalAttributes.allergystatement", "title": "DisplayName"}, "region": "AU", "onlyFlagged": true}
```

### Output example

Real output from a run of the prefilled input on 2026-10-31 (long finding lists are shortened here; the run returns all of them):

```json
[
  {
    "itemNo": 1,
    "productId": "EXAMPLE-COOKIES",
    "title": "Example chocolate chip cookies",
    "region": "US",
    "allergensFound": [
      "egg",
      "milk",
      "soy",
      "tree nuts",
      "wheat"
    ],
    "allergenTerms": {
      "milk": [
        "milk",
        "butter",
        "milk fat"
      ],
      "egg": [
        "eggs"
      ],
      "tree nuts": [
        "pecans"
      ],
      "wheat": [
        "wheat"
      ],
      "soy": [
        "soy"
      ]
    },
    "containsStatement": "Contains: wheat, milk, egg, soy.",
    "declaredAllergens": [
      "egg",
      "milk",
      "soy",
      "wheat"
    ],
    "mayContain": [],
    "riskLevel": "high",
    "issueCount": 1,
    "categoriesFlagged": [
      "allergen_missing_from_contains"
    ],
    "issues": [
      {
        "ruleId": "allergen_missing_from_contains",
        "severity": "high",
        "allergen": "tree nuts",
        "matchedTerms": [
          "pecans"
        ],
        "message": "Ingredients include pecans (tree nuts), but the 'Contains' statement doesn't list it. Under FALCPA, a Contains statement must name all major food allergens in the food.",
        "sourceUrl": "https://www.fda.gov/regulatory-information/search-fda-guidance-documents/guidance-industry-questions-and-answers-regarding-food-allergen-labeling-edition-5",
        "fixHint": "Add tree nuts to the Contains statement."
      }
    ],
    "url": null,
    "checkedAt": "2026-10-31T18:43:38+00:00",
    "disclaimer": "Automated keyword screening of the ingredient, allergen and claim text supplied, against..."
  },
  {
    "itemNo": 2,
    "productId": "EXAMPLE-GRANOLA",
    "title": "Example nut-free granola",
    "region": "US",
    "allergensFound": [],
    "allergenTerms": {},
    "containsStatement": null,
    "declaredAllergens": [],
    "mayContain": [
      "peanuts",
      "tree nuts"
    ],
    "riskLevel": "medium",
    "issueCount": 2,
    "categoriesFlagged": [
      "free_from_with_may_contain"
    ],
    "issues": [
      {
        "ruleId": "free_from_with_may_contain",
        "severity": "medium",
        "allergen": "tree nuts",
        "matchedTerms": null,
        "message": "Claim 'Nut-free' sits next to a precautionary 'may contain tree nuts' statement. FDA says a free-from claim shouldn't be paired with an advisory statement for the same allergen.",
        "sourceUrl": "https://www.fda.gov/regulatory-information/search-fda-guidance-documents/guidance-industry-questions-and-answers-regarding-food-allergen-labeling-edition-5",
        "fixHint": "Drop either the free-from claim or the precautionary statement after checking cross-contact controls."
      },
      {
        "ruleId": "free_from_with_may_contain",
        "severity": "medium",
        "allergen": "peanuts",
        "matchedTerms": null,
        "message": "Claim 'Nut-free' sits next to a precautionary 'may contain peanuts' statement. FDA says a free-from claim shouldn't be paired with an advisory statement for the same allergen.",
        "sourceUrl": "https://www.fda.gov/regulatory-information/search-fda-guidance-documents/guidance-industry-questions-and-answers-regarding-food-allergen-labeling-edition-5",
        "fixHint": "Drop either the free-from claim or the precautionary statement after checking cross-contact controls."
      }
    ],
    "url": null,
    "checkedAt": "2026-10-31T18:43:38+00:00",
    "disclaimer": "Automated keyword screening of the ingredient, allergen and claim text supplied, against..."
  },
  {
    "itemNo": 3,
    "productId": "EXAMPLE-CURRY",
    "title": "Example coconut curry sauce",
    "region": "US",
    "allergensFound": [],
    "allergenTerms": {},
    "containsStatement": "Contains: coconut.",
    "declaredAllergens": [],
    "mayContain": [],
    "riskLevel": "low",
    "issueCount": 1,
    "categoriesFlagged": [
      "coconut_in_contains"
    ],
    "issues": [
      {
        "ruleId": "coconut_in_contains",
        "severity": "low",
        "allergen": null,
        "matchedTerms": null,
        "message": "The Contains statement lists coconut. Since FDA's January 2025 guidance (Edition 5), coconut is not a major food allergen and shouldn't appear in the Contains statement; keep it in the ingredient list.",
        "sourceUrl": "https://www.fda.gov/regulatory-information/search-fda-guidance-documents/guidance-industry-questions-and-answers-regarding-food-allergen-labeling-edition-5",
        "fixHint": "Remove coconut from the Contains statement."
      }
    ],
    "url": null,
    "checkedAt": "2026-10-31T18:43:38+00:00",
    "disclaimer": "Automated keyword screening of the ingredient, allergen and claim text supplied, against..."
  },
  {
    "itemNo": 4,
    "productId": "EXAMPLE-CRACKERS",
    "title": "Example sesame crackers",
    "region": "US",
    "allergensFound": [
      "sesame",
      "wheat"
    ],
    "allergenTerms": {
      "wheat": [
        "wheat"
      ],
      "sesame": [
        "sesame"
      ]
    },
    "containsStatement": "Contains: wheat, sesame.",
    "declaredAllergens": [
      "sesame",
      "wheat"
    ],
    "mayContain": [],
    "riskLevel": "none found",
    "issueCount": 0,
    "categoriesFlagged": [],
    "issues": [],
    "url": null,
    "checkedAt": "2026-10-31T18:43:38+00:00",
    "disclaimer": "Automated keyword screening of the ingredient, allergen and claim text supplied, against..."
  }
]
```

### How much does it cost to check food labels?

This Actor uses pay-per-event pricing: **$0.002 per product saved** plus a **$0.00005 start fee per run**, plus small platform usage paid by you (a few hundredths of a cent for small runs). That's about **$2.00 for 1,000 products** and **$20.00 for 10,000** plus usage. With **Only save rows with findings** on, rows without findings aren't saved or charged. You can set a maximum cost per run in the run options.

### Use it through the API, integrations or AI agents

- Run it and get results in one call: `https://api.apify.com/v2/acts/ultimatemc~food-allergen-label-checker/run-sync-get-dataset-items`
- Use it from AI agents through the Apify MCP server: `https://mcp.apify.com?tools=ultimatemc/food-allergen-label-checker`
- Schedule it after a daily scraper run, send flagged rows to Slack or email with webhooks, or connect it to Make, Zapier, n8n or Google Sheets.
- Chain it after a grocery scraper by passing the scraper's dataset ID.

### How it works

Each allergen has a list of ingredient names (for example whey, casein, ghee and paneer for milk). False friends are removed first, then matches are compared with the words in the Contains or allergen statement. Lists were written from FDA, EU and FSANZ sources checked on 2026-10-31. No AI and no external calls, so the same input always gives the same result.

Sources:

- [FDA: Food Allergies (major food allergens)](https://www.fda.gov/food/food-labeling-nutrition/food-allergies)
- [FDA: Questions and Answers Regarding Food Allergens, Edition 5 (2025)](https://www.fda.gov/regulatory-information/search-fda-guidance-documents/guidance-industry-questions-and-answers-regarding-food-allergen-labeling-edition-5)
- [EUR-Lex: Regulation (EU) No 1169/2011, Annex II](https://eur-lex.europa.eu/eli/reg/2011/1169/oj/eng)
- [FSANZ: Allergen labelling (PEAL)](https://www.foodstandards.gov.au/consumer/labelling/allergen-labelling)

### FAQ

#### Which allergens are checked?

US: milk, egg, fish, crustacean shellfish, tree nuts, peanuts, wheat, soy and sesame. EU/UK: the 14 Annex II allergens. Australia/NZ: the PEAL list, including molluscs, lupin and sulphites.

#### Is coconut a tree nut?

Not any more in the US. FDA's January 2025 guidance removed coconut, shea and several others from its tree nut list, so coconut isn't flagged as an allergen.

#### Why isn't 'may contain' required?

Precautionary statements are voluntary in the US, EU and Australia. The checker only flags them when they conflict with a free-from claim.

#### Does it check bold text in the EU?

Yes, when your ingredient text has HTML bold tags. Without them, allergens are listed as info so you can confirm emphasis on pack.

#### Is it AI?

No. It's a fixed set of word lists and rules, so results are repeatable.

### Limitations

- Keyword matching can miss unusual ingredient names or wrongly match rare ones.
- It can't detect cross-contact or allergens that aren't in the text supplied.
- Gluten-containing cereals are checked for EU/UK and AU/NZ; US rules cover wheat only.
- Other label rules (nutrition panels, font sizes) aren't checked.

### Other tools by Ultimate Foresight

- [Amazon Listing Policy Checker for Titles & Bullets](https://apify.com/ultimatemc/amazon-listing-policy-checker): flags pesticide, FDA and disease claims and Amazon title and bullet rule breaks in bulk, with policy links and fixes.
- [Fair Housing Listing Checker for Real Estate Ads](https://apify.com/ultimatemc/fair-housing-listing-checker): flags rental and sale listing wording that may raise Fair Housing Act issues, with HUD sources and rewrite tips (screening aid only).
- [Ad Copy Policy Checker for Meta, Google & TikTok](https://apify.com/ultimatemc/ad-copy-policy-checker): checks ad text against Facebook, Instagram, Google Ads and TikTok ad policies before you submit.
- [H-1B Visa Sponsor Checker & Score for Job Listings](https://apify.com/ultimatemc/h1b-visa-sponsor-score): adds Department of Labor H-1B sponsorship history and a 0-100 score to company names or job listings.
- [Chain vs Independent Labeler for Google Maps Leads](https://apify.com/ultimatemc/chain-vs-independent-labeler): labels local businesses as chain, franchise or independent.
- [YouTube Monetization Checker for Scripts & Titles](https://apify.com/ultimatemc/youtube-script-monetization-checker): pre-checks titles, descriptions and scripts for wording that leads to limited or no ads.
- [Etsy & eBay Listing Policy & Banned Item Checker](https://apify.com/ultimatemc/etsy-ebay-listing-policy-checker): pre-checks marketplace listings for prohibited items, counterfeit wording and off-platform contact.
- [Job Scam Detector & Trust Score for Job Postings](https://apify.com/ultimatemc/job-posting-trust-score): scores job postings 0-100 for scam and ghost-job signals.
- [SAM.gov Amendment & Opportunity Change Tracker](https://apify.com/ultimatemc/sam-gov-opportunity-change-detector): shows what changed between versions of a SAM.gov notice: deadlines, set-asides, NAICS and attachments.
- [Product Recall Checker for Brands, UPCs & Products](https://apify.com/ultimatemc/product-recall-matcher): matches your brands, products, UPCs or model numbers against CPSC, FDA and NHTSA recalls.
- [App Store & Google Play Listing Policy Checker](https://apify.com/ultimatemc/app-store-listing-policy-checker): pre-checks app names, subtitles and descriptions against Apple and Google Play metadata rules.
- [Company Name Normalizer & Deduplicator for CRM](https://apify.com/ultimatemc/company-name-canonicalizer): cleans company names (Inc, LLC, d/b/a, aliases) and groups duplicates in CRM, lead or vendor lists.
- [FCC Covered List & Section 889 Bulk Screener](https://apify.com/ultimatemc/fcc-covered-list-screener): screens FCC IDs and brand names against the public FCC Covered List, with sources and timestamps (screening aid only).
- [Green Claims Checker: EU Greenwashing Ban & FTC](https://apify.com/ultimatemc/green-claims-checker): flags risky eco-friendly, carbon neutral and recyclable wording under EU, FTC and UK CMA rules.
- [Influencer #ad Disclosure Checker: FTC & ASA](https://apify.com/ultimatemc/influencer-ad-disclosure-checker): flags influencer posts with missing or unclear #ad labels under FTC, ASA/CAP and CMA rules.
- [Job Title to SOC Code Mapper with O\*NET Data](https://apify.com/ultimatemc/job-title-soc-code-mapper): maps job titles to SOC and O\*NET-SOC codes in bulk, with seniority and tech skills found in the posting.
- [Shrinkflation Detector for Grocery Price Data](https://apify.com/ultimatemc/shrinkflation-detector): finds smaller packs at the same or higher price by comparing two runs of a grocery scraper, with unit price before and after.
- [Job Ad Discrimination Checker for Job Posts (US)](https://apify.com/ultimatemc/job-ad-discrimination-checker): flags age, sex, national origin, citizenship and other discriminatory wording in job posts, with EEOC and DOJ sources (screening aid only).
- [Walmart Listing Policy Checker for Titles & Copy](https://apify.com/ultimatemc/walmart-listing-policy-checker): flags promotional phrases, retailer names, URLs, long titles and pesticide or FDA claims in Walmart Marketplace listings, with policy links and fixes.
- [TikTok Shop Listing Policy Checker for Products](https://apify.com/ultimatemc/tiktok-shop-listing-policy-checker): flags off-platform links, dupe wording, weight-loss, disease and FDA claims and title rule breaks in TikTok Shop listings.
- [Supplement & Cosmetic Claims Checker: FDA & FTC](https://apify.com/ultimatemc/supplement-cosmetic-claims-checker): flags disease, drug and 'FDA approved' claims and missing supplement disclaimers in supplement and beauty product copy, with FDA and FTC sources (screening aid only).
- [Rental Listing Scam Checker for Craigslist & FB](https://apify.com/ultimatemc/rental-listing-scam-checker): scores rental listings 0-100 for FTC-listed scam signs like wire or gift card payment, deposit before viewing and rent far below similar listings.
- [GTIN, UPC & EAN Barcode Validator (Check Digit)](https://apify.com/ultimatemc/gtin-barcode-validator): checks UPC, EAN, GTIN-14 and ISBN codes for wrong check digits, lost leading zeros, scientific notation, restricted prefixes and duplicates before a feed upload.
- [Fake Review Checker: Incentivized & Duplicates](https://apify.com/ultimatemc/review-integrity-checker): screens scraped reviews for incentivized or insider wording, copied text, rating bursts and rating/text mismatches named in the FTC 2024 fake-review rule.
- [Facebook Marketplace Listing Policy Checker](https://apify.com/ultimatemc/facebook-marketplace-listing-policy-checker): flags Marketplace listings that may break Meta's Commerce Policies (weapons, vapes, Rx, animals, gift cards, services, counterfeits and more), with policy links.
- [Fake Discount Checker: EU 30-Day Prior Price](https://apify.com/ultimatemc/discount-claim-checker): checks 'was' and strikethrough prices against your own price history for 30-day prior-price, raise-then-discount and wrong-badge issues.
- [SMS Marketing Message Checker: STOP & 10DLC](https://apify.com/ultimatemc/sms-marketing-message-checker): pre-checks SMS marketing texts for segment count, STOP opt-out wording, URL shorteners, SHAFT content and quiet hours.
- [Hidden Fee Checker: Hotel, Rental & Ticket Prices](https://apify.com/ultimatemc/hidden-fee-price-checker): flags headline prices that leave out mandatory resort, service or booking fees under the FTC junk fees rule (16 CFR 464), with sources per finding.
- [EU GPSR Listing Checker for Amazon, eBay & Shops](https://apify.com/ultimatemc/gpsr-listing-checker): checks listings for the EU GPSR Article 19 online-sale details: manufacturer, EU responsible person, product identifier, picture and warnings.
- [Toy Choking Hazard Warning Checker (CPSC)](https://apify.com/ultimatemc/toy-choking-warning-checker): flags toy listings missing the CPSC choking-hazard warnings for small parts, balloons, small balls and marbles, with age-grade checks.
- [Textile Fiber Label Checker: Bamboo & Origin](https://apify.com/ultimatemc/textile-fiber-label-checker): flags 'bamboo' claims that should say rayon, fiber percentages that don't add up, mismatched silk or cashmere titles and missing Made in USA/Imported.
- [Prop 65 Warning Checker for Product Listings](https://apify.com/ultimatemc/prop65-warning-checker): flags Prop 65 safe-harbor warnings missing 'WARNING', the P65Warnings.ca.gov link or a chemical name, old short forms, and listed chemicals mentioned with no warning.
- [Unit Price Checker for Grocery & Retail Listings](https://apify.com/ultimatemc/unit-price-checker): parses pack sizes, recomputes the price per kg, litre or item, and flags missing or wrong unit prices in grocery and retail data.
- [Made in USA Claim Checker for Product Listings](https://apify.com/ultimatemc/made-in-usa-claim-checker): flags unqualified 'Made in USA' claims next to imported or foreign-origin details under the FTC rule (16 CFR 323), with sources per finding.
- [Subscription Auto-Renewal Disclosure Checker](https://apify.com/ultimatemc/auto-renewal-disclosure-checker): checks subscription and free-trial offer text for missing renewal, price, billing period and cancellation disclosures under California law and FTC ROSCA.
- [Email CAN-SPAM Checker & Unsubscribe Header Test](https://apify.com/ultimatemc/email-can-spam-checker): pre-checks marketing emails for missing unsubscribe links or postal address, misleading subjects and Google/Yahoo one-click unsubscribe headers.

Found a false positive? Open an issue on the **Issues** tab with the ingredient text and what you expected, and we'll review the rule.

# Actor input Schema

## `products` (type: `array`):

Array of objects with "ingredients" and optional "contains" (allergen statement), "mayContain", "claims", "title", "region" (US, EU, UK, AU, NZ) and "id"/"url". HTML bold tags in EU ingredient lists are used for the emphasis check. The prefilled example shows common gaps and a clean label; replace it with your own.

## `ingredientTexts` (type: `array`):

One full ingredient statement per entry, including any 'Contains:' and 'May contain' sentences.

## `region` (type: `string`):

Which allergen list and rules to apply when a row has no 'region' field.

## `datasetId` (type: `string`):

Apify dataset with food products, for example the output of a Woolworths, Coles, Tesco, Walmart, Kroger, Instacart or Open Food Facts scraper. Common fields (ingredients, ingredients_text, allergens, allergenStatement, traces, title, name) are detected automatically; override them with Field map.

## `fieldMap` (type: `object`):

Override field names; dotted paths work for nested fields. Example: {"ingredients": "AdditionalAttributes.ingredients", "contains": "AdditionalAttributes.allergystatement", "title": "DisplayName"}.

## `onlyFlagged` (type: `boolean`):

Skip products with no findings (you are only charged for saved rows).

## `maxItems` (type: `integer`):

Maximum number of products to check in this run.

## Actor input object example

```json
{
  "products": [
    {
      "id": "EXAMPLE-COOKIES",
      "title": "Example chocolate chip cookies",
      "ingredients": "Enriched wheat flour, sugar, chocolate chips (sugar, cocoa butter, milk fat), butter, eggs, pecans, salt, soy lecithin.",
      "contains": "Contains: wheat, milk, egg, soy."
    },
    {
      "id": "EXAMPLE-GRANOLA",
      "title": "Example nut-free granola",
      "claims": "Nut-free",
      "ingredients": "Rolled oats, honey, sunflower seeds, coconut. May contain peanuts and tree nuts."
    },
    {
      "id": "EXAMPLE-CURRY",
      "title": "Example coconut curry sauce",
      "ingredients": "Coconut milk, water, onion, nutmeg, butternut squash, salt, spices.",
      "contains": "Contains: coconut."
    },
    {
      "id": "EXAMPLE-CRACKERS",
      "title": "Example sesame crackers",
      "ingredients": "Wheat flour, sesame seeds, olive oil, salt.",
      "contains": "Contains: wheat, sesame."
    }
  ],
  "region": "US",
  "onlyFlagged": false,
  "maxItems": 10000
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "products": [
        {
            "id": "EXAMPLE-COOKIES",
            "title": "Example chocolate chip cookies",
            "ingredients": "Enriched wheat flour, sugar, chocolate chips (sugar, cocoa butter, milk fat), butter, eggs, pecans, salt, soy lecithin.",
            "contains": "Contains: wheat, milk, egg, soy."
        },
        {
            "id": "EXAMPLE-GRANOLA",
            "title": "Example nut-free granola",
            "claims": "Nut-free",
            "ingredients": "Rolled oats, honey, sunflower seeds, coconut. May contain peanuts and tree nuts."
        },
        {
            "id": "EXAMPLE-CURRY",
            "title": "Example coconut curry sauce",
            "ingredients": "Coconut milk, water, onion, nutmeg, butternut squash, salt, spices.",
            "contains": "Contains: coconut."
        },
        {
            "id": "EXAMPLE-CRACKERS",
            "title": "Example sesame crackers",
            "ingredients": "Wheat flour, sesame seeds, olive oil, salt.",
            "contains": "Contains: wheat, sesame."
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("ultimatemc/food-allergen-label-checker").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "products": [
        {
            "id": "EXAMPLE-COOKIES",
            "title": "Example chocolate chip cookies",
            "ingredients": "Enriched wheat flour, sugar, chocolate chips (sugar, cocoa butter, milk fat), butter, eggs, pecans, salt, soy lecithin.",
            "contains": "Contains: wheat, milk, egg, soy.",
        },
        {
            "id": "EXAMPLE-GRANOLA",
            "title": "Example nut-free granola",
            "claims": "Nut-free",
            "ingredients": "Rolled oats, honey, sunflower seeds, coconut. May contain peanuts and tree nuts.",
        },
        {
            "id": "EXAMPLE-CURRY",
            "title": "Example coconut curry sauce",
            "ingredients": "Coconut milk, water, onion, nutmeg, butternut squash, salt, spices.",
            "contains": "Contains: coconut.",
        },
        {
            "id": "EXAMPLE-CRACKERS",
            "title": "Example sesame crackers",
            "ingredients": "Wheat flour, sesame seeds, olive oil, salt.",
            "contains": "Contains: wheat, sesame.",
        },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("ultimatemc/food-allergen-label-checker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "products": [
    {
      "id": "EXAMPLE-COOKIES",
      "title": "Example chocolate chip cookies",
      "ingredients": "Enriched wheat flour, sugar, chocolate chips (sugar, cocoa butter, milk fat), butter, eggs, pecans, salt, soy lecithin.",
      "contains": "Contains: wheat, milk, egg, soy."
    },
    {
      "id": "EXAMPLE-GRANOLA",
      "title": "Example nut-free granola",
      "claims": "Nut-free",
      "ingredients": "Rolled oats, honey, sunflower seeds, coconut. May contain peanuts and tree nuts."
    },
    {
      "id": "EXAMPLE-CURRY",
      "title": "Example coconut curry sauce",
      "ingredients": "Coconut milk, water, onion, nutmeg, butternut squash, salt, spices.",
      "contains": "Contains: coconut."
    },
    {
      "id": "EXAMPLE-CRACKERS",
      "title": "Example sesame crackers",
      "ingredients": "Wheat flour, sesame seeds, olive oil, salt.",
      "contains": "Contains: wheat, sesame."
    }
  ]
}' |
apify call ultimatemc/food-allergen-label-checker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ultimatemc/food-allergen-label-checker"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/WWjxi03mXanFalSBQ/builds/jorJJdX5u213ZH9v5/openapi.json