Skip to main content

Python package, scraping recipes from all over the internet

Project description

Github Version PyPI - Python Version GitHub Actions Unittests Coveralls License

Installation

pip install recipe-scrapers

Basic 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_html

Higher-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 = False

Supported 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!

https://contrib.rocks/image?repo=hhursev/recipe-scrapers

Share Your Project

Have an idea for using recipe-scrapers? Check out our project ideas wall for inspiration or to share your own project!

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

recipe_scrapers-15.11.0.tar.gz (144.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

recipe_scrapers-15.11.0-py3-none-any.whl (307.2 kB view details)

Uploaded Python 3

File details

Details for the file recipe_scrapers-15.11.0.tar.gz.

File metadata

  • Download URL: recipe_scrapers-15.11.0.tar.gz
  • Upload date:
  • Size: 144.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for recipe_scrapers-15.11.0.tar.gz
Algorithm Hash digest
SHA256 1290598a776109e26af4daeeea649c85097c85ac29c608fe73dab534e6902efd
MD5 8958f2dafa1db699d242452b6b99f51c
BLAKE2b-256 9309e9983f4fd1cf09126df8388c48da593e200c12df71a22c807436d00f8ac5

See more details on using hashes here.

Provenance

The following attestation bundles were made for recipe_scrapers-15.11.0.tar.gz:

Publisher: publish.yaml on hhursev/recipe-scrapers

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file recipe_scrapers-15.11.0-py3-none-any.whl.

File metadata

File hashes

Hashes for recipe_scrapers-15.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9e56f1e56ff2c7dfb16b88422beda90f7b3a3896617329ed934d74c1b5ee8b10
MD5 561d2431fc8ecde18476c5fd2658c43a
BLAKE2b-256 755aff6ba9552d7551c719812d2e9d9847c57abee4ffa11941d84f87b84a8764

See more details on using hashes here.

Provenance

The following attestation bundles were made for recipe_scrapers-15.11.0-py3-none-any.whl:

Publisher: publish.yaml on hhursev/recipe-scrapers

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page