🥗 FatSecret Scraper

Want FatSecret food pages in a spreadsheet? This scraper makes it easy.

Use structured filters — better for AI agents — or paste an input_url. When input_url is set it overrides the filters.

FatSecret is a worldwide food database. Search by keyword, leave the keyword empty to walk foods A–Z, or paste a single food page. This actor opens each food page and returns up to 2000 rows per run.

💡 Perfect for...

• Nutrition apps: Export calories, fat, carbs, protein, and common serving sizes from the food page.
• Dashboards: Compare the same food across country sites.
• Market research: Browse branded products or generic / USDA foods without paging the site.
• Data analysts: Export structured rows with public food-page URLs, photos, and related foods.
• 🤖 AI Agents: Power Claude, Cursor, Codex, the Hermes Agent, and OpenClaw workflows with live FatSecret results.
• 📚 RAG Systems: Feed food names, descriptions, and nutrition facts into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste a FatSecret food page, search, or A–Z list URL, or pick a country and keyword. input_url always wins when set.
• 🎯 Website-Matched Filters: Keyword, country site, and A–Z browse set (all / generic foods / USDA / brands).
• 🌐 Full food pages: Title, brand, serving, calories, macros, common serving sizes, photos, and related foods.

📦 What's inside the data?

id, url, title, brand, description, serving, calories_kcal, fat_g, carbs_g, protein_g, fat_pct, carbs_pct, protein_pct, rdi_percent, servings, photos, related, country, source

🚀 Quick start

Option A: paste a food page such as https://foods.fatsecret.com/calories-nutrition/generic/chicken-breast-ns-as-to-skin-eaten. Option B: paste a search such as https://foods.fatsecret.com/calories-nutrition/search?q=chicken. Option C: pick a country, type a keyword (or leave it empty to browse A–Z), and set max_results.

Input Example (filters):

{
  "query": "chicken",
  "country": "us",
  "max_results": 100
}

Input Example (URL):

{
  "input_url": "https://foods.fatsecret.com/calories-nutrition/generic/chicken-breast-ns-as-to-skin-eaten",
  "max_results": 1
}

Output Example:

{
  "id": "generic/chicken-breast-ns-as-to-skin-eaten",
  "url": "https://foods.fatsecret.com/calories-nutrition/generic/chicken-breast-ns-as-to-skin-eaten",
  "title": "Chicken Breast",
  "brand": null,
  "description": "There are 195 calories in 100 grams of Chicken Breast.",
  "serving": "100 grams",
  "calories_kcal": 195,
  "fat_g": 7.72,
  "carbs_g": 0,
  "protein_g": 29.55,
  "fat_pct": 37,
  "carbs_pct": 0,
  "protein_pct": 63,
  "rdi_percent": 10,
  "servings": [
    {
      "name": "1 oz raw",
      "note": "yield after cooking, bone removed",
      "calories_kcal": 29
    },
    {
      "name": "100 g",
      "note": null,
      "calories_kcal": 195
    }
  ],
  "photos": [
    "https://m.ftscrt.com/food/b0ab0c4e-442a-4ddc-8ace-404d1907df8b.jpg"
  ],
  "related": [
    {
      "title": "Skinless Chicken Breast",
      "url": "https://foods.fatsecret.com/calories-nutrition/generic/chicken-breast-skinless"
    }
  ],
  "country": "United States",
  "source": "generic"
}

Output fields:

Field	Description
id	Food id from the public page path.
url	Public food page.
title	Food name on the page.
brand	Brand name when the food is a branded product.
description	Short nutrition sentence from the food page.
serving	Serving size the calories apply to.
calories_kcal	Calories in kcal for that serving.
fat_g	Fat in grams.
carbs_g	Carbohydrates in grams.
protein_g	Protein in grams.
fat_pct	Share of calories from fat.
carbs_pct	Share of calories from carbs.
protein_pct	Share of calories from protein.
rdi_percent	Percent of a 2000 calorie recommended daily intake.
servings	Common serving sizes with calories for each.
photos	Food photos shown on the page.
related	Related foods linked from the page.
country	FatSecret country site used for the row.
source	Generic foods, USDA, or a brand listing.

📋 Input reference

Parameter	Type	Required	Default	Description
input_url	string	No	—	FatSecret food page, search, or A–Z list URL. Overrides every filter.
query	string	No	chicken	Same as the site search box. Leave empty to browse A–Z.
country	string enum	No	United States	Which country site to search.
browse_set	string enum	No	All search	Used when keyword is empty: all sets, generic foods, USDA, or brands.
max_results	integer	No	50	Maximum rows (1–2000).