/
BI
bigoven
/
1,000,000+ Recipe and Grocery List API (v2)
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Checked 7h ago · Updated 1mo ago
Details
Collection
3
GroceryList
10
Images
6
Me
7
Note
5
Recipe
23
Review
12
get
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 also supporting more of a "Google Play" style model for Reviews and Replies. That is, there are top-level Reviews and then an unlimited list of replies (which do not carry star ratings) underneath existing reviews. Also, a given user can only have one review per recipe. Existing legacy endpoints will continue to work, but we strongly recommend you migrate to using the newer endpoints listed which do NOT carry the "DEPRECATED" flag.
put
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.
delete
DEPRECATED! - Deletes a review by recipeId and reviewId. Please use recipe/review/{reviewId} instead.
get
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 recent one for that rating.
put
Update a given top-level review.
get
Get *my* review for the recipe {recipeId}, where "me" is determined by standard authentication headers
post
Add a new review. Only one review can be provided per {userId, recipeId} pair. Otherwise your review will be updated.
get
Get paged list of reviews for a recipe. Each review will have at most one FeaturedReply, as well as a ReplyCount.
get
Get a paged list of replies for a given review.
post
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.
put
Update (PUT) a reply to a given review. Authenticated user must be the original one that posted the reply.
delete
DELETE a reply to a given review. Authenticated user must be the one who originally posted the reply.
Review
Get *my* review for the recipe {recipeId}, where "me" is determined by standard authentication headers
get
/recipe/{recipeId}/review
Path parameters
recipeId
integer
required
Response
OK
BigOvenModelAPIReview
required
ID
string
ReviewID
integer
GUID
string
Comment
string
StarRating
number
double
TotalMinutes
integer
ActiveMinutes
integer
Poster
BigOvenModelAPIUserInfo
CreationDate
string
date-time
ParentID
integer
Replies
BigOvenModelAPIReview[]
FeaturedReply
BigOvenModelAPIReply
ReplyCount
integer
LastModified
string
date-time