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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file recipe_scrapers-15.12.0.tar.gz.
File metadata
- Download URL: recipe_scrapers-15.12.0.tar.gz
- Upload date:
- Size: 164.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7610139233ca2ffb139038e97839cc17c17af1e7a3cb39e126075882121d6ee0
|
|
| MD5 |
6ea119da7fb67e790dd99583222d029b
|
|
| BLAKE2b-256 |
81fbb73d2a12103918a9299fd53bda4830285dd5567a74ca20a7c1eaad2a8455
|
Provenance
The following attestation bundles were made for recipe_scrapers-15.12.0.tar.gz:
Publisher:
publish.yaml on hhursev/recipe-scrapers
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
recipe_scrapers-15.12.0.tar.gz -
Subject digest:
7610139233ca2ffb139038e97839cc17c17af1e7a3cb39e126075882121d6ee0 - Sigstore transparency entry: 2387118162
- Sigstore integration time:
-
Permalink:
hhursev/recipe-scrapers@aae9f5e0946635afcd3e20dff3a0004db4561ded -
Branch / Tag:
refs/tags/15.12.0 - Owner: https://github.com/hhursev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yaml@aae9f5e0946635afcd3e20dff3a0004db4561ded -
Trigger Event:
release
-
Statement type:
File details
Details for the file recipe_scrapers-15.12.0-py3-none-any.whl.
File metadata
- Download URL: recipe_scrapers-15.12.0-py3-none-any.whl
- Upload date:
- Size: 348.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
51c22eb2a61009f4892a9f5c059c5fa5b854a51591f9358b9bbeeb357839e678
|
|
| MD5 |
323d7a5a5374c95dd277dc42b628098c
|
|
| BLAKE2b-256 |
67efa93997a728f415a0b857992baab6f4feab8a1415a4a9a86f5a3e9a77e5c6
|
Provenance
The following attestation bundles were made for recipe_scrapers-15.12.0-py3-none-any.whl:
Publisher:
publish.yaml on hhursev/recipe-scrapers
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
recipe_scrapers-15.12.0-py3-none-any.whl -
Subject digest:
51c22eb2a61009f4892a9f5c059c5fa5b854a51591f9358b9bbeeb357839e678 - Sigstore transparency entry: 2387118246
- Sigstore integration time:
-
Permalink:
hhursev/recipe-scrapers@aae9f5e0946635afcd3e20dff3a0004db4561ded -
Branch / Tag:
refs/tags/15.12.0 - Owner: https://github.com/hhursev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yaml@aae9f5e0946635afcd3e20dff3a0004db4561ded -
Trigger Event:
release
-
Statement type:
