In Development · Free Sample Available

The Food & Beverage Products API

Normalized packaged-food data keyed by barcode: ingredient lists in exact on-label order, nutrition facts parsed to name, amount, unit and daily value, declared and precautionary allergens, and clean categories.

500,000+ products at launch · 1,000 free sample products today · JSONL, CSV, SQLite

One barcode, one full labelcurl

$ curl "https://api.thefoodapi.io/v1/products/lookup?gtin=00074323095524" \
    -H "x-api-key: $FOOD_API_KEY"

{
  "id": "2df12c62-f996-5362-82d6-e5f738378e08",
  "gtin": "00074323095524",
  "name": "Marinela Cinnas Cinnamon Cookies, 8.82 oz",
  "brand": "Marinela",
  "product_type": "food",
  "category": ["Food", "Snacks, Cookies & Chips", "Cookies", "Shop All Cookies"],
  "net_content": "8.82 oz Bag",
  "pack_count": null,
  "food_condition": "shelf_stable",
  "food_form": "whole",
  "flavor": "Artificial Flavor",
  "dietary_claims": null,
  "organic": null,
  "allergens_declared": ["wheat", "soy"],
  "allergens_may_contain": ["milk", "egg", "peanut", "tree_nut", "sesame"],
  "allergens_statement": "CONTAINS WHEAT, SOY. MADE IN A BAKERY THAT MAY ALSO USE MILK, EGG, PEANUTS, TREE NUTS, SESAME.",

  "nutrition_serving_size": "3 cookies (30g)",
  "nutrition_servings_per_container": null,
  "nutrition_basis": "per_serving",
  "nutrition_preparation": "as_sold",
  "nutrition_nutrients": [
    { "name": "Calories", "amount": 140, "unit": "kcal", "daily_value_percent": null },
    { "name": "Total Fat", "amount": 5, "unit": "g", "daily_value_percent": 6 },
    { "name": "Saturated Fat", "amount": 1, "unit": "g", "daily_value_percent": 5 },
    { "name": "Trans Fat", "amount": 0, "unit": "g", "daily_value_percent": null },
    { "name": "Polyunsaturated Fat", "amount": 1.5, "unit": "g", "daily_value_percent": null },
    { "name": "Monounsaturated Fat", "amount": 3, "unit": "g", "daily_value_percent": null },
    { "name": "Cholesterol", "amount": 0, "unit": "mg", "daily_value_percent": 0 },
    { "name": "Sodium", "amount": 70, "unit": "mg", "daily_value_percent": 3 },
    { "name": "Total Carbohydrate", "amount": 23, "unit": "g", "daily_value_percent": 8 },
    { "name": "Dietary Fiber", "amount": 1, "unit": "g", "daily_value_percent": 4 },
    { "name": "Total Sugars", "amount": 8, "unit": "g", "daily_value_percent": null },
    { "name": "Added Sugars", "amount": 8, "unit": "g", "daily_value_percent": 16 },
    { "name": "Protein", "amount": 2, "unit": "g", "daily_value_percent": null },
    { "name": "Vitamin D", "amount": 0, "unit": "mcg", "daily_value_percent": 0 },
    { "name": "Calcium", "amount": 10, "unit": "mg", "daily_value_percent": 0 },
    { "name": "Iron", "amount": 0.8, "unit": "mg", "daily_value_percent": 4 },
    { "name": "Potassium", "amount": 20, "unit": "mg", "daily_value_percent": 0 },
    { "name": "Thiamin", "amount": null, "unit": null, "daily_value_percent": 6 },
    { "name": "Riboflavin", "amount": null, "unit": null, "daily_value_percent": 4 },
    { "name": "Niacin", "amount": null, "unit": null, "daily_value_percent": 4 },
    { "name": "Folate", "amount": null, "unit": null, "daily_value_percent": 15 },
    { "name": "Zinc", "amount": null, "unit": null, "daily_value_percent": 8 }
  ],
  "ingredients": "Bleached Wheat Flour, Sugar, Vegetable Shortening (Canola Oil, Palm And Fractionated Palm Oil), Water, Corn Syrup, Vegetable Oil (Rice Bran And Canola Oil), Baking Soda, Salt, Cinnamon, Soy Lecithin, Sodium Stearoyl Lactylate, Natural And Artificial Flavor, Enrichment (Thiamin Mononitrate, Riboflavin, Niacin, Folic Acid, Ferrous Sulfate, Zinc Oxide).",
  "ingredients_parsed": [
    {
      "component": null,
      "ingredients": [
        { "name": "Bleached Wheat Flour", "max_percent": null, "sub_ingredients": null },
        { "name": "Sugar", "max_percent": null, "sub_ingredients": null },
        {
          "name": "Vegetable Shortening",
          "max_percent": null,
          "sub_ingredients": [
            { "name": "Canola Oil", "max_percent": null, "sub_ingredients": null },
            { "name": "Palm And Fractionated Palm Oil", "max_percent": null, "sub_ingredients": null }
          ]
        },
        { "name": "Water", "max_percent": null, "sub_ingredients": null },
        { "name": "Corn Syrup", "max_percent": null, "sub_ingredients": null },
        {
          "name": "Vegetable Oil",
          "max_percent": null,
          "sub_ingredients": [
            { "name": "Rice Bran And Canola Oil", "max_percent": null, "sub_ingredients": null }
          ]
        },
        { "name": "Baking Soda", "max_percent": null, "sub_ingredients": null },
        { "name": "Salt", "max_percent": null, "sub_ingredients": null },
        { "name": "Cinnamon", "max_percent": null, "sub_ingredients": null },
        { "name": "Soy Lecithin", "max_percent": null, "sub_ingredients": null },
        { "name": "Sodium Stearoyl Lactylate", "max_percent": null, "sub_ingredients": null },
        { "name": "Natural And Artificial Flavor", "max_percent": null, "sub_ingredients": null },
        {
          "name": "Enrichment",
          "max_percent": null,
          "sub_ingredients": [
            { "name": "Thiamin Mononitrate", "max_percent": null, "sub_ingredients": null },
            { "name": "Riboflavin", "max_percent": null, "sub_ingredients": null },
            { "name": "Niacin", "max_percent": null, "sub_ingredients": null },
            { "name": "Folic Acid", "max_percent": null, "sub_ingredients": null },
            { "name": "Ferrous Sulfate", "max_percent": null, "sub_ingredients": null },
            { "name": "Zinc Oxide", "max_percent": null, "sub_ingredients": null }
          ]
        }
      ]
    }
  ],
  "sweeteners": null,
  "caffeine_statement": null,
  "alcoholic_beverage": false,
  "alcohol_percent": null,
  "warnings": null,
  "directions": "Call 1-800-984-0989 for more food information …",
  "countries_of_sale": ["US"],
  "image_name": "8721df154043fcecbd08fbbc54000bdc155157c4a7a0e33607d681fa837c1727.jpg",
  "label_image_names": [
    "9540f65434efb69a057168358cac755b91c09a8a84220fa0e9513b031a98f86b.jpg",
    "d5304a5345e671191621e69901d138cfdc375e010064a93681561566c52cf9f8.jpg"
  ],
  "updated_at": "2026-09-23T16:38:19.234Z"
}

… Show nutrition facts & ingredients ▾

A real record from the free sample, keys grouped for reading. Reserved always-null fields omitted. API paths are planned and may still change.

500K+

Products at launch

packaged foods and beverages, one record per product

1,000

Products in the free sample

across 520 brands, with 1,286 photos

GTIN-14

Barcode-keyed records

every product resolvable from a scanned code

%DV

Nutrition normalized

name · amount · unit · daily value, per label

The planned API

Structured Access to Every Label

A uniform JSON interface over a barcode-keyed food catalog, with API key auth and versioned paths. The records are the ones in the sample today; the endpoints are what we are building over them.

GET /v1/products/lookup?gtin=…

Barcode Lookup

Resolve a scanned UPC-A, EAN-13 or GTIN-14 straight to the full product record. The primary key of the whole catalog.

GET /v1/products/search

Search

Search across brand and product names, returning slim records built for result lists.

GET /v1/products

Filter & Discover

Filter by category, brand, storage condition, allergen exclusions and dietary claims in a single request.

GET /v1/products/{id}

Full Product Record

The complete label in structured form: the parsed ingredient tree, normalized nutrition facts, allergen tags and attributes.

POST /v1/products/batch

Batch Retrieval

Many complete records in one request, returned in the same order as the codes or ids you sent.

GET image_name · label_image_names

Product & Label Photos

The main product photo and the label photos (ingredient list, nutrition panel) ship with every record that has them, named by content hash.

Want an endpoint that isn’t here? Tell us what you’re building →

The record

What a Record Gives You

Every product is the label, in structured form. Three layers, one JSON document.

Identify anything with a barcode

Every record carries a checksum-validated GTIN-14. Pad a scanned UPC-A or EAN-13 to 14 digits and it resolves to the same record, whatever code your app or catalog already holds.

Scan → record

GET /v1/products/lookup?gtin=00074323095524

"name":  "Marinela Cinnas Cinnamon Cookies, 8.82 oz"
"brand": "Marinela"
"gtin":  "00074323095524"

Read the label as data

Ingredients stay in exact on-label order and parse into components and sub-ingredients. Nutrition facts normalize to name, amount, unit and daily value against a stated serving size. Nothing is estimated: what the label doesn’t state is null, never a guess.

The label, structured

"ingredients_parsed": [
  { "component": null, "ingredients": [
    { "name": "Bleached Wheat Flour", "sub_ingredients": null },
    { "name": "Vegetable Shortening",
      "sub_ingredients": [ { "name": "Canola Oil" }, … ] } … ] } ]
"nutrition_serving_size": "3 cookies (30g)",
"nutrition_nutrients": [
  { "name": "Added Sugars", "amount": 8,
    "unit": "g", "daily_value_percent": 16 } … ]

Build what your users see

Render the response as live product UI: allergen badges, nutrition panels, dietary filters. The presentation layer is yours.

Marinela

Cinnas Cinnamon Cookies · 8.82 oz

contains wheatcontains soymay contain milkmay contain eggshelf stable

Calories140 kcal

Sodium70 mg3% DV

Added Sugars8 g16% DV

Example UI rendered from one record. The presentation layer is yours to design.

Roadmap

What We’re Building

Dataset first, API second. The normalization pipeline (barcode validation, ingredient parsing, nutrition normalization, allergen tagging, label-photo reconciliation) is running; the free sample is its first packaged release.

Now

Free sample out, catalog growing

The first cut is packaged and free to download: 1,000 products in the launch schema. The pipeline is now running the same normalization across the full catalog.

Dataset launch

One-time dataset licenses launch first: the full 500,000+-product catalog as JSONL, CSV and SQLite snapshots, with the same schema documentation as the sample.

Then

Hosted API

A metered REST API over the same catalog (barcode lookup, search and filters) for teams that would rather not host the data themselves.

Need specific categories, brands or markets covered? Tell us what coverage you need →

Who it’s for

Built For Teams That Ship Food Products

From barcode scanners to grocery storefronts, teams get the same clean reference and skip months of data wrangling.

Nutrition & Health Apps

Let users scan any product and see real label facts. Skip the months of collecting and cleaning food data before you can ship.

What you'd build:

Barcode scan → full label in one request
Food and macro logging with normalized nutrition
Allergy alerts from normalized allergen tags
Diet matching on kosher, vegan and similar claims

E-commerce & Grocery

Enrich your storefront with structured ingredients, nutrition panels and allergen badges. Better product pages, better search, fewer returns.

What you'd build:

Ingredient-rich product pages for organic search traffic
Faceted search on dietary claims and allergens
Consistent nutrition panels across the catalog
Catalog enrichment keyed by the barcodes you already hold

Research & ML

Structured label data at scale: ingredient trees, normalized nutrients and categories ready for analysis and model training.

What you'd build:

Ingredient and formulation trend analysis
Nutrition benchmarking across categories
Training data for product-recognition models
Market-gap analysis on claims and categories

Questions

Frequently Asked Questions

The essentials below. See the full FAQ for data, sourcing and launch details.

What is in the free sample?

1,000 products across 520 brands, delivered as products.jsonl, products.csv and products.sqlite (identical records, pick your format), a SCHEMA.md documenting every field, and an images folder with 1,286 photos: main product images plus label photos (ingredient list, nutrition panel, back of pack).

What can I do with the sample?

Evaluate it freely: load it, query it, prototype against it, build internal demos, benchmark it against other sources. What you may not do is redistribute the files or their contents, publish them as a dataset, or use them in a shipping product or a public model without a license. Refer to the Terms of Service for full details.

How big will the full catalog be?

500,000+ products at launch. The free sample holds 1,000 of them across 520 brands, and every record in the full catalog uses the same schema and file formats as the sample, so what you build against the sample carries over unchanged.

When does the full catalog launch?

By end 2026. Everyone who has requested the sample hears first; we send exactly one email when the full dataset is available.

See all FAQs →

Free sample

Try the Data Before We Launch

1,000 real records in the launch schema, with photos and schema documentation, free. The link lands in your inbox right away, and you get one more email when the full 500,000+-product catalog ships.