recipe-scrapers

What it is and what it does

recipe-scrapers is a Python library that extracts structured recipe data from cooking websites. It parses recipe information from standard HTML structure, Schema.org markup (JSON-LD, Microdata, RDFa), and OpenGraph metadata, providing a consistent API to retrieve ingredients, instructions, cooking times, images, and other recipe fields. The library handles the parsing layer only—you supply the HTML content and its source domain, and it returns structured data via methods like title(), instructions(), and to_json().

The package is focused exclusively on HTML parsing and does not handle network requests or bot protection circumvention. It supports current Python versions (3.10 through 3.14) and works with a wide range of recipe websites out of the box. Higher-quality image detection is enabled by default but can be disabled per-call or globally.

Use it for:

• Build a recipe collection app that imports recipes from multiple cooking websites into a unified database.
• Scrape recipe metadata to power a meal-planning or nutrition-tracking tool.
• Extract recipe instructions and ingredients for offline recipe storage or mobile app content.
• Aggregate recipe data from multiple sources for comparison or analysis.
• Integrate recipe parsing into a cooking assistant or kitchen app.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Extracts structured recipe data (ingredients, instructions, cooking times, images) from cooking websites by parsing HTML, Schema.org markup, and OpenGraph metadata.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It solves a specific, well-defined problem—parsing recipe data from HTML—with a simple API and support for multiple markup standards. Install it if you need to extract recipe information from websites; skip it if you don't need recipe parsing.

Install

recipe-scrapers on PyPI

pip install recipe-scrapers

uv add recipe-scrapers

poetry add recipe-scrapers

Installing recipe-scrapers

Before you install

Low friction install with three lightweight dependencies. Actively maintained as of 2026-08-14 with recent release history; no known vulnerabilities.

License in practice

MIT License permits commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install recipe-scrapers

from recipe_scrapers import scrape_me

scraper = scrape_me("https://www.allrecipes.com/recipe/158968/spinach-and-feta-turkey-burgers/")
print(scraper.title())
print(scraper.instructions())

Requires Python 3.10 or later. You must provide your own HTML fetching and network request handling; the library parses HTML you supply.

Verify before relying

• Exact count of supported recipe websites beyond 'wide range'
• Whether all Schema.org formats (JSON-LD, Microdata, RDFa) are equally well-supported across sites
• Performance characteristics when scraping large recipe collections

Package facts

Evidence: recipe_scrapers-15.12.0-py3-none-any.whl

Keywords: python, recipes, scraper, harvest, recipe-scraper, recipe-scrapers

Tags

More Libraries packages