Quick Links
A Python package for extracting recipe data from cooking websites. 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.
Installation
pip install recipe-scrapersBasic Usage
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)This package is focused exclusively on HTML parsing.
For advanced implementations, 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.
You are encouraged to use our scrape_html method:
from recipe_scrapers import scrape_htmlHigher-quality image detection is enabled by default when multiple options are available on a page. If you prefer to keep the first image returned by the site, disable the behaviour on a per-call basis or via the global setting:
scraper = scrape_html(html, url, best_image=False)
image_url = scraper.image()
from recipe_scrapers.settings import settings
settings.BEST_IMAGE_SELECTION = FalseSupported Sites
We support a wide range of recipe websites out of the box. Check our supported sites list for the full list.
You can also get the full list programmatically with:
from recipe_scrapers import SCRAPERS
SCRAPERS.keys()Contributing
We welcome contributions! Please read our contribution guide to get started.
Special Thanks
To all the contributors who help make this project better!
1 maintainer
Metadata
1 maintainer
Release files for recipe-scrapers 15.12.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| recipe_scrapers-15.12.0.tar.gz | 164.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| recipe_scrapers-15.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 512.5 kB
Release files / recipe_scrapers-15.12.0.tar.gz
| Download URL | recipe_scrapers-15.12.0.tar.gz |
|---|---|
| Size | 164.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7610139233ca2ffb139038e97839cc17c17af1e7a3cb39e126075882121d6ee0
|
|
BLAKE2b-256 checksum How to use checksums |
81fbb73d2a12103918a9299fd53bda4830285dd5567a74ca20a7c1eaad2a8455
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 8, 2026.
Transparency logRelease files / recipe_scrapers-15.12.0-py3-none-any.whl
| Download URL | recipe_scrapers-15.12.0-py3-none-any.whl |
|---|---|
| Size | 348.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
51c22eb2a61009f4892a9f5c059c5fa5b854a51591f9358b9bbeeb357839e678
|
|
BLAKE2b-256 checksum How to use checksums |
67efa93997a728f415a0b857992baab6f4feab8a1415a4a9a86f5a3e9a77e5c6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 8, 2026.
Transparency log
