# 500,000+ Recipe and Grocery List API (v2)

## API Docs
- Article [Get a food article](https://yoco20z2ok.apidog.io/api-3527826.md): 
- Collection [Gets a recipe collection. A recipe collection is a curated set of recipes.](https://yoco20z2ok.apidog.io/api-3527812.md): 
- Collection [Gets a recipe collection metadata. A recipe collection is a curated set of recipes.](https://yoco20z2ok.apidog.io/api-3527831.md): 
- Collection [Get the list of current, seasonal recipe collections. From here, you can use the /collection/{id} endpoint to retrieve the recipes in those collections.](https://yoco20z2ok.apidog.io/api-3527825.md): 
- GroceryList [Delete all the items on a grocery list; faster operation than a sync with deleted items.](https://yoco20z2ok.apidog.io/api-3527813.md): 
- GroceryList [Get the user's grocery list.  User is determined by Basic Authentication.](https://yoco20z2ok.apidog.io/api-3527814.md): 
- GroceryList [Clears the checked lines.](https://yoco20z2ok.apidog.io/api-3527817.md): 
- GroceryList [Departmentalize a list of strings -- used for ad-hoc grocery list item addition](https://yoco20z2ok.apidog.io/api-3527827.md): 
- GroceryList [Add a single line item to the grocery list](https://yoco20z2ok.apidog.io/api-3527816.md): 
- GroceryList [/grocerylist/item/{guid}  DELETE will delete this item assuming you own it.](https://yoco20z2ok.apidog.io/api-3527818.md): 
- GroceryList [Update a grocery item by GUID](https://yoco20z2ok.apidog.io/api-3527815.md): 
- GroceryList [Add a single line item to the grocery list](https://yoco20z2ok.apidog.io/api-3527819.md): 
- GroceryList [Add a Recipe to the grocery list.  In the request data, pass in recipeId, scale (scale=1.0 says to keep the recipe the same size as originally posted), markAsPending (true/false) to indicate that
            the lines in the recipe should be marked in a ](https://yoco20z2ok.apidog.io/api-3527820.md): 
- GroceryList [Synchronize the grocery list.  Call this with a POST to /grocerylist/sync](https://yoco20z2ok.apidog.io/api-3527822.md): 
- Images [POST: /image/avatar
             
            Testing with Postman (validated 11/20/2015):
            1) Remove the Content-Type header; add authentication information
            2) On the request, click Body and choose "form-data", then add a line ](https://yoco20z2ok.apidog.io/api-3527830.md): 
- Images [Gets the pending by user.](https://yoco20z2ok.apidog.io/api-3527821.md): 
- Images [POST: /recipe/{recipeId}/image?lat=42&lng=21&caption=this%20is%20my%20caption
             
             Note that caption, lng and lat are all optional, but must go on the request URI as params because this endpoint
             needs a multip](https://yoco20z2ok.apidog.io/api-3527829.md): 
- Images [Get all the images for a recipe. DEPRECATED. Please use /recipe/{recipeId}/photos.](https://yoco20z2ok.apidog.io/api-3527828.md): 
- Images [Get all the photos for a recipe](https://yoco20z2ok.apidog.io/api-3527823.md): 
- Images [Gets a list of RecipeScan images for the recipe. There will be at most 3 per recipe.](https://yoco20z2ok.apidog.io/api-3527824.md): 
- Me [Indexes this instance.](https://yoco20z2ok.apidog.io/api-3527832.md): 
- Me [Puts me.](https://yoco20z2ok.apidog.io/api-3527833.md): 
- Me [Puts me personal.](https://yoco20z2ok.apidog.io/api-3527834.md): 
- Me [Puts me preferences.](https://yoco20z2ok.apidog.io/api-3527835.md): 
- Me [Gets the options.](https://yoco20z2ok.apidog.io/api-3527837.md): 
- Me [Puts me.](https://yoco20z2ok.apidog.io/api-3527847.md): 
- Me [Skinnies this instance.](https://yoco20z2ok.apidog.io/api-3527838.md): 
- Recipe [Add a new recipe](https://yoco20z2ok.apidog.io/api-3527839.md): 
- Recipe [Update a recipe](https://yoco20z2ok.apidog.io/api-3527843.md): 
- Recipe [Given a query, return recipe titles starting with query. Query must be at least 3 chars in length.](https://yoco20z2ok.apidog.io/api-3527840.md): 
- Recipe [Automatics the complete all recipes.](https://yoco20z2ok.apidog.io/api-3527844.md): 
- Recipe [Automatics the complete my recipes.](https://yoco20z2ok.apidog.io/api-3527845.md): 
- Recipe [Get a list of recipe categories (the ID field can be used for include_cat in search parameters)](https://yoco20z2ok.apidog.io/api-3527846.md): 
- Recipe [Returns last active recipe for the user](https://yoco20z2ok.apidog.io/api-3527841.md): 
- Recipe [Gets recipe single step as text](https://yoco20z2ok.apidog.io/api-3527836.md): 
- Recipe [Returns stored step number and number of steps in recipe](https://yoco20z2ok.apidog.io/api-3527842.md): 
- Recipe [Stores recipe step number and returns saved step data](https://yoco20z2ok.apidog.io/api-3527848.md): 
- Recipe [POST an image as a new RecipeScan request
                1)  Fetch the filename -- DONE
                2)  Copy it to the pics/scan folder - ENSURE NO NAMING COLLISIONS -- DONE
                3)  Create 120 thumbnail size  in pics/scan/120 -- DONE
](https://yoco20z2ok.apidog.io/api-3527849.md): 
- Recipe [Return full Recipe detail with steps. Returns 403 if the recipe is owned by someone else.](https://yoco20z2ok.apidog.io/api-3527850.md): 
- Recipe [Delete a Recipe (you must be authenticated as an owner of the recipe)](https://yoco20z2ok.apidog.io/api-3527851.md): 
- Recipe [Return full Recipe detail. Returns 403 if the recipe is owned by someone else.](https://yoco20z2ok.apidog.io/api-3527853.md): 
- Recipe [Zaps the recipe.](https://yoco20z2ok.apidog.io/api-3527852.md): 
- Recipe [Feedback on a Recipe -- for internal BigOven editors](https://yoco20z2ok.apidog.io/api-3527854.md): 
- Recipe [Get recipes related to the given recipeId](https://yoco20z2ok.apidog.io/api-3527855.md): 
- Recipe [Search for recipes. There are many parameters that you can apply. Starting with the most common, use title_kw to search within a title.
            Use any_kw to search across the entire recipe.
            If you'd like to limit by course, set the para](https://yoco20z2ok.apidog.io/api-3527866.md): 
- Recipe [Get a random, home-page-quality Recipe.](https://yoco20z2ok.apidog.io/api-3527856.md): 
- Recipe [Get the recipe/comment tuples for those recipes with 4 or 5 star ratings](https://yoco20z2ok.apidog.io/api-3527864.md): 
- Recipe [Get a list of recipes that the authenticated user has most recently viewed](https://yoco20z2ok.apidog.io/api-3527865.md): 
- Recipe [Search for recipes. There are many parameters that you can apply. Starting with the most common, use title_kw to search within a title.
            Use any_kw to search across the entire recipe.
            If you'd like to limit by course, set the para](https://yoco20z2ok.apidog.io/api-3527857.md): 
- Recipe [Same as GET recipe but also includes the recipe videos (if any)](https://yoco20z2ok.apidog.io/api-3527859.md): 
- Review [DELETE a reply to a given review. Authenticated user must be the one who originally posted the reply.](https://yoco20z2ok.apidog.io/api-3527858.md): 
- Review [Update (PUT) a reply to a given review. Authenticated user must be the original one that posted the reply.](https://yoco20z2ok.apidog.io/api-3527860.md): 
- Review [Get a given review by string-style ID. This will return a payload with FeaturedReply, ReplyCount.
            Recommended display is to list top-level reviews with one featured reply underneath. 
            Currently, the FeaturedReply is the most rece](https://yoco20z2ok.apidog.io/api-3527861.md): 
- Review [Update a given top-level review.](https://yoco20z2ok.apidog.io/api-3527863.md): 
- Review [Get a paged list of replies for a given review.](https://yoco20z2ok.apidog.io/api-3527867.md): 
- Review [POST a reply to a given review. The date will be set by server. Note that replies no longer have star ratings, only top-level reviews do.](https://yoco20z2ok.apidog.io/api-3527862.md): 
- Review [Get *my* review for the recipe {recipeId}, where "me" is determined by standard authentication headers](https://yoco20z2ok.apidog.io/api-3527868.md): 
- Review [Add a new review. Only one review can be provided per {userId, recipeId} pair. Otherwise your review will be updated.](https://yoco20z2ok.apidog.io/api-3527869.md): 
- Review [DEPRECATED! - Deletes a review by recipeId and reviewId. Please use recipe/review/{reviewId} instead.](https://yoco20z2ok.apidog.io/api-3527870.md): 
- Review [Get a given review - DEPRECATED. See recipe/review/{reviewId} for the current usage.
            Beginning in January 2017, BigOven moded from an integer-based ID system to a GUID-style string-based ID system for reviews and replies.
            We are ](https://yoco20z2ok.apidog.io/api-3527871.md): 
- Review [HTTP PUT (update) a recipe review. DEPRECATED. Please see recipe/review/{reviewId} PUT for the new endpoint.
            We are moving to a string-based primary key system, no longer integers, for reviews and replies.](https://yoco20z2ok.apidog.io/api-3527872.md): 
- Review [Get paged list of reviews for a recipe. Each review will have at most one FeaturedReply, as well as a ReplyCount.](https://yoco20z2ok.apidog.io/api-3527873.md): 
- Note [HTTP POST a new note into the system.](https://yoco20z2ok.apidog.io/api-3527874.md): 
- Note [Delete a review
                do a DELETE Http request of /note/{ID}](https://yoco20z2ok.apidog.io/api-3527875.md): 
- Note [Get a given note. Make sure you're passing authentication information in the header for the user who owns the note.](https://yoco20z2ok.apidog.io/api-3527876.md): 
- Note [HTTP PUT (update) a Recipe note (RecipeNote).](https://yoco20z2ok.apidog.io/api-3527877.md): 
- Note [recipe/100/notes](https://yoco20z2ok.apidog.io/api-3527878.md):