Skip to content
This repository has been archived by the owner. It is now read-only.
An open database of recipe bookmarks
Python Shell
Branch: master
Clone or download

Latest commit


Type Name Latest commit message Commit time
Failed to load latest commit information.
scrapy_proj Update Mar 21, 2014
scripts add hashbangs to python scripts May 28, 2013
.gitignore add warnings on deprecated pipeline classes Apr 15, 2013
LICENSE add warnings on deprecated pipeline classes Apr 15, 2013 Update Aug 6, 2013
requirements.txt use timelib to parse string datetime reps Apr 16, 2013

Open Recipes

Download the latest DB dump


Open Recipes is an open database of recipe bookmarks.

Our goals are simple:

  1. Help publishers make their recipes as discoverable and consumable (get it?) as possible.
  2. Prevent good recipes from disappearing when a publisher goes away.

That's pretty much it. We're not trying to save the world. We're just trying to save some recipes.

Recipe Bookmarks?

The recipes in Open Recipes do not include preparation instructions. This is why we like to think of Open Recipes as a database of recipe bookmarks. We think this database should provide everything you need to find a great recipe, but not everything you need to prepare a great recipe. For preparation instructions, please link to the source.

The Database

Regular snapshots of the database will be provided as JSON. The format will mirror the Recipe format. We've posted an example dump of data so you can get a feel for it.

The Story

We're not a bunch of chefs. We're not even good cooks.

When we read about the acquisition shutdown of Punchfork, we just shook our heads. It was the same ol' story:

We're excited to share the news that we're gonna be rich! To celebrate, we're shutting down the site and taking all your data down with it. So long, suckers!

This part of the story isn't unique, but it continues. When one of our Studiomates spoke up about her disappointment, we listened. Then, we acted. What happens next surprised us. The CEO of Punchfork took issue with our good deed and demanded that we not save any data, even the data (likes) of users who asked us to save their data.

Here's the thing. None of the recipes belonged to Punchfork. They were scraped from various publishers to begin with. But, we don't wanna ruffle any feathers, so we're starting over.

Use the force; seek the source?

The Work

Wanna help? Fantastic. We knew we liked you.

Head over to the wiki to see how you can help out.


We're just trying to do the right thing, so we value your feedback as we go. You can ping Ed, Chris, Andreas, or anyone from Fictive Kin. General suggestions and feedback to are welcome, too.

We're also gonna be on IRC, so please feel free to join us if you have any questions or comments. We'll be hanging out in #openrecipes on Freenode. See you there!


The Open Recipes Database is licensed under a Creative Commons Attribution 3.0 Unported License.

Creative Commons License

© 2013 Fictive Kin LLC


Not every change, but notable ones that may require action

  • 2013-04-15: pipelines.MakestringsPipeline and pipelines.CleanDatesTimesPipeline have been deprecated, and pipelines.RejectinvalidPipeline has been added. Your ITEM_PIPELINES config in should look something like this:

        # uncomment if you want to insert results into MongoDB
        # 'openrecipes.pipelines.MongoDBPipeline',
  • 2013-04-14: Spiders now use a RecipeItemLoader to store data scraped from a page. This allows us to do cleanup of properties without relying on a pipeline class, which makes testing significantly easier. See spiders/ with updated comments to see the new approach. Example:

    il = RecipeItemLoader(item=RecipeItem())
    # [...]
You can’t perform that action at this time.