Skip to content

Recipe Scrapers

Github Version Python Version GitHub Actions Unittests Coveralls License

recipe-scrapers is a Python package for extracting recipe data from cooking websites. It parses recipe information from either standard HTML structure, Schema markup (including JSON-LD, Microdata, and RDFa formats) or OpenGraph metadata.

The package provides a simple and consistent API for retrieving data such as ingredients, instructions, cooking times, and more.

Compatible with the Python versions listed above. This package does not circumvent or bypass any bot protection measures implemented by websites.

Install

pip install recipe-scrapers

There are 458 cooking websites currently supported.

For a full list check our Supported Sites section.

Getting Started

Parsing recipe information can be as simple as:

from recipe_scrapers import scrape_me

scraper = scrape_me("https://www.allrecipes.com/recipe/158968/spinach-and-feta-turkey-burgers/")
scraper.title()
scraper.instructions()
scraper.to_json()
# for a complete list of methods:
# help(scraper)

Warning

recipe-scrapers is designed to focus exclusively on HTML parsing.

This core principle guides our development and support. You'll need to implement your own solution for fetching recipe HTMLs and managing network requests. The library works best when you provide both the HTML content and its source domain.

For more advanced implementations, we recommend using:

from recipe_scrapers import scrape_html

Check out our Examples section.

Overview

With recipe-scrapers, you should easily extract structured recipe data such as:

  • title
  • ingredients
  • instructions
  • cooking and preparation times
  • yields
  • image
  • and many more...

Check out our Examples section to see how to get started with the library.

Why recipe-scrapers Exists

Born from late-night coding sessions and a love for both food and programming, recipe-scrapers evolved from a personal project into a community tool. It's open-sourced and under the MIT license with a simple goal: let developers focus on building amazing food-related applications without reinventing the recipe-parsing wheel.

Today, our library helps power diverse projects across the cooking landscape:

  • Meal prep and planning applications
  • Smart shopping list generators
  • Recipe collection managers
  • Cooking time estimators
  • Diet and nutrition trackers
  • Food blogs and recipe aggregators

We're excited to see what you'll create! Feel free to share your project in our community showcase - we love seeing what others build with the library.

While building awesome stuff, remember to be mindful of websites' terms and fair usage - our Copyright and Usage will help you stay on track.