Hi! There's a new version available (api2), recommended for all new and future development.

We plan to continue to support the legacy version of the API well into 2017 (and later if you let us know), but we do recommend all developers migrate to the new api2 format as your development cycle allows. We strongly recommend that all new recipe and grocery API developers begin with http://api2.bigoven.com

Sorting And Filtering

API query result sets can be retrieved pre-sorted by appending a query with the "sort" parameter.

How Can I Sort Results?

Properly sorted queries contain sort={type} in the URL parameters, as seen below.

http://api.bigoven.com/{PATH}?{PARAMETERS}&{AUTH PARAMETERS}&sort={type}

What Can I Sort By?

The following table describes what types of sorting are available for each type of query. The default sorting method is in bold.

Query Type Sorting Options
Recipe Search Results {title, dateasc, datesdesc, quality}
JSON {title, dateasc, datesdesc, orderinqueue, quality}
JSON {title, dateasc, datedesc, quality}

Sorting Types

Sorting Type Description
title Sorted alphabetically by recipe title, ascending.
dateasc Sorted by date posted to BigOven, ascending.
datedesc Sorted by date posted to BigOven, descending.
orderinqueue Sorted by order added to Try list.
quality Sorted by quality of recipe, as determined by a proprietary algorithm.