1,000,000+ Recipe and Grocery List API (v2)
bigoven · Company
#Documentation This is the documentation for the partner endpoint of the BigOven Recipe and Grocery List API. The update brings with it Swagger-based documentation. [Swagger](http://swagger.io) is an emerging standard for describing REST-based APIs, and with this Swagger-compliant endpoint (above), you can make ready-to-go interface libraries for your code via [swagger-codegen](https://github.com/swagger-api/swagger-codegen). For instance, it's easy to generate libraries for Node.js, Java,
Authentication
No authentication requiredFree to use with no key needed.
Sample Requests
GET
Get the list of current, seasonal recipe collections. From here, you can use the /collection/{id} endpoint to retrieve the recipes in those collections.
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://api.apis.guru/v2/specs/bigoven.com/partner/collections?test=example
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/bigoven.com/partner/collections?test=example"
import requests
params = {
"test": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/bigoven.com/partner/collections",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/bigoven.com/partner/collections');
url.searchParams.set('test', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/bigoven.com/partner/collections")
q := baseURL.Query()
q.Set("test", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/bigoven.com/partner/collections")
uri.query = URI.encode_www_form({
"test" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/bigoven.com/partner/collections?" . http_build_query([
"test" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET
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 parameter "include_primarycat" to one of (appetizers,bread,breakfast,dessert,drinks,maindish,salad,sidedish,soup,marinades,other).
If you'd like to exclude a category, set exclude_cat to one or more (comma-separated) list of those categories to exclude.
If you'd like to include a category, set include_cat to one or more (comma-separated) of those categories to include.
To explicitly include an ingredient in your search, set the parameter "include_ing" to a CSV of up to three ingredients, e.g.:include_ing=mustard,chicken,beef%20tips
To explicitly exclude an ingredient in your search, set the parameter "exclude_ing" to a CSV of up to three ingredients.
All searches must contain the paging parameters pg and rpp, which are integers, and represent the page number (1-based) and results per page (rpp).
So, to get the third page of a result set paged with 25 recipes per page, you'd pass pg=3&rpp=25
If you'd like to target searches to just a single target user's recipes, set userId=the target userId (number).
Or, you can set username=theirusername
vtn;vgn;chs;glf;ntf;dyf;sff;slf;tnf;wmf;rmf;cps
cuisine
photos
filter=added,try,favorites,myrecipes\r\n\r\n
folder=FolderNameCaseSensitive
coll=ID of Collection
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 parameter "include_primarycat" to one of (appetiz
https://api.apis.guru/v2/specs/bigoven.com/partner/recipes?db=example&pg=1&chs=1&cps=1&dyf=1&glf=1&ntf=1&rmf=1&rpp=1&sff=1&slf=1&tnf=1&vgn=1&vtn=1&wmf=1&coll=1&token=YOUR_TOKEN&any_kw=example&filter=example&folder=example&photos=true&userId=1&cuisine=example&userset=example&champion=1&synonyms=true&title_kw=example&username=testuser&boostmine=true&totalMins=1&exclude_cat=example&exclude_ing=example&include_cat=example&include_ing=example&servingsMin=1&maxIngredients=1&minIngredients=1&exclude_primarycat=example&include_primarycat=example
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/bigoven.com/partner/recipes?db=example&pg=1&chs=1&cps=1&dyf=1&glf=1&ntf=1&rmf=1&rpp=1&sff=1&slf=1&tnf=1&vgn=1&vtn=1&wmf=1&coll=1&token=YOUR_TOKEN&any_kw=example&filter=example&folder=example&photos=true&userId=1&cuisine=example&userset=example&champion=1&synonyms=true&title_kw=example&username=testuser&boostmine=true&totalMins=1&exclude_cat=example&exclude_ing=example&include_cat=example&include_ing=example&servingsMin=1&maxIngredients=1&minIngredients=1&exclude_primarycat=example&include_primarycat=example"
import requests
params = {
"db": "example",
"pg": "1",
"chs": "1",
"cps": "1",
"dyf": "1",
"glf": "1",
"ntf": "1",
"rmf": "1",
"rpp": "1",
"sff": "1",
"slf": "1",
"tnf": "1",
"vgn": "1",
"vtn": "1",
"wmf": "1",
"coll": "1",
"token": "YOUR_TOKEN",
"any_kw": "example",
"filter": "example",
"folder": "example",
"photos": "true",
"userId": "1",
"cuisine": "example",
"userset": "example",
"champion": "1",
"synonyms": "true",
"title_kw": "example",
"username": "testuser",
"boostmine": "true",
"totalMins": "1",
"exclude_cat": "example",
"exclude_ing": "example",
"include_cat": "example",
"include_ing": "example",
"servingsMin": "1",
"maxIngredients": "1",
"minIngredients": "1",
"exclude_primarycat": "example",
"include_primarycat": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/bigoven.com/partner/recipes",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/bigoven.com/partner/recipes');
url.searchParams.set('db', 'example');
url.searchParams.set('pg', '1');
url.searchParams.set('chs', '1');
url.searchParams.set('cps', '1');
url.searchParams.set('dyf', '1');
url.searchParams.set('glf', '1');
url.searchParams.set('ntf', '1');
url.searchParams.set('rmf', '1');
url.searchParams.set('rpp', '1');
url.searchParams.set('sff', '1');
url.searchParams.set('slf', '1');
url.searchParams.set('tnf', '1');
url.searchParams.set('vgn', '1');
url.searchParams.set('vtn', '1');
url.searchParams.set('wmf', '1');
url.searchParams.set('coll', '1');
url.searchParams.set('token', 'YOUR_TOKEN');
url.searchParams.set('any_kw', 'example');
url.searchParams.set('filter', 'example');
url.searchParams.set('folder', 'example');
url.searchParams.set('photos', 'true');
url.searchParams.set('userId', '1');
url.searchParams.set('cuisine', 'example');
url.searchParams.set('userset', 'example');
url.searchParams.set('champion', '1');
url.searchParams.set('synonyms', 'true');
url.searchParams.set('title_kw', 'example');
url.searchParams.set('username', 'testuser');
url.searchParams.set('boostmine', 'true');
url.searchParams.set('totalMins', '1');
url.searchParams.set('exclude_cat', 'example');
url.searchParams.set('exclude_ing', 'example');
url.searchParams.set('include_cat', 'example');
url.searchParams.set('include_ing', 'example');
url.searchParams.set('servingsMin', '1');
url.searchParams.set('maxIngredients', '1');
url.searchParams.set('minIngredients', '1');
url.searchParams.set('exclude_primarycat', 'example');
url.searchParams.set('include_primarycat', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/bigoven.com/partner/recipes")
q := baseURL.Query()
q.Set("db", "example")
q.Set("pg", "1")
q.Set("chs", "1")
q.Set("cps", "1")
q.Set("dyf", "1")
q.Set("glf", "1")
q.Set("ntf", "1")
q.Set("rmf", "1")
q.Set("rpp", "1")
q.Set("sff", "1")
q.Set("slf", "1")
q.Set("tnf", "1")
q.Set("vgn", "1")
q.Set("vtn", "1")
q.Set("wmf", "1")
q.Set("coll", "1")
q.Set("token", "YOUR_TOKEN")
q.Set("any_kw", "example")
q.Set("filter", "example")
q.Set("folder", "example")
q.Set("photos", "true")
q.Set("userId", "1")
q.Set("cuisine", "example")
q.Set("userset", "example")
q.Set("champion", "1")
q.Set("synonyms", "true")
q.Set("title_kw", "example")
q.Set("username", "testuser")
q.Set("boostmine", "true")
q.Set("totalMins", "1")
q.Set("exclude_cat", "example")
q.Set("exclude_ing", "example")
q.Set("include_cat", "example")
q.Set("include_ing", "example")
q.Set("servingsMin", "1")
q.Set("maxIngredients", "1")
q.Set("minIngredients", "1")
q.Set("exclude_primarycat", "example")
q.Set("include_primarycat", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/bigoven.com/partner/recipes")
uri.query = URI.encode_www_form({
"db" => "example",
"pg" => "1",
"chs" => "1",
"cps" => "1",
"dyf" => "1",
"glf" => "1",
"ntf" => "1",
"rmf" => "1",
"rpp" => "1",
"sff" => "1",
"slf" => "1",
"tnf" => "1",
"vgn" => "1",
"vtn" => "1",
"wmf" => "1",
"coll" => "1",
"token" => "YOUR_TOKEN",
"any_kw" => "example",
"filter" => "example",
"folder" => "example",
"photos" => "true",
"userId" => "1",
"cuisine" => "example",
"userset" => "example",
"champion" => "1",
"synonyms" => "true",
"title_kw" => "example",
"username" => "testuser",
"boostmine" => "true",
"totalMins" => "1",
"exclude_cat" => "example",
"exclude_ing" => "example",
"include_cat" => "example",
"include_ing" => "example",
"servingsMin" => "1",
"maxIngredients" => "1",
"minIngredients" => "1",
"exclude_primarycat" => "example",
"include_primarycat" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/bigoven.com/partner/recipes?" . http_build_query([
"db" => "example",
"pg" => "1",
"chs" => "1",
"cps" => "1",
"dyf" => "1",
"glf" => "1",
"ntf" => "1",
"rmf" => "1",
"rpp" => "1",
"sff" => "1",
"slf" => "1",
"tnf" => "1",
"vgn" => "1",
"vtn" => "1",
"wmf" => "1",
"coll" => "1",
"token" => "YOUR_TOKEN",
"any_kw" => "example",
"filter" => "example",
"folder" => "example",
"photos" => "true",
"userId" => "1",
"cuisine" => "example",
"userset" => "example",
"champion" => "1",
"synonyms" => "true",
"title_kw" => "example",
"username" => "testuser",
"boostmine" => "true",
"totalMins" => "1",
"exclude_cat" => "example",
"exclude_ing" => "example",
"include_cat" => "example",
"include_ing" => "example",
"servingsMin" => "1",
"maxIngredients" => "1",
"minIngredients" => "1",
"exclude_primarycat" => "example",
"include_primarycat" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET
Given a query, return recipe titles starting with query. Query must be at least 3 chars in length.
Given a query, return recipe titles starting with query. Query must be at least 3 chars in length.
https://api.apis.guru/v2/specs/bigoven.com/partner/recipe/autocomplete?limit=10&query=test
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/bigoven.com/partner/recipe/autocomplete?limit=10&query=test"
import requests
params = {
"limit": "10",
"query": "test"
}
response = requests.get(
"https://api.apis.guru/v2/specs/bigoven.com/partner/recipe/autocomplete",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/bigoven.com/partner/recipe/autocomplete');
url.searchParams.set('limit', '10');
url.searchParams.set('query', 'test');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/bigoven.com/partner/recipe/autocomplete")
q := baseURL.Query()
q.Set("limit", "10")
q.Set("query", "test")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/bigoven.com/partner/recipe/autocomplete")
uri.query = URI.encode_www_form({
"limit" => "10",
"query" => "test"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/bigoven.com/partner/recipe/autocomplete?" . http_build_query([
"limit" => "10",
"query" => "test"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with 1,000,000+ Recipe and Grocery List API (v2)?
1,000,000+ Recipe and Grocery List API (v2) is a Company API. Developers commonly use company APIs for:
- enriching CRM records with company firmographics
- building lead-generation and prospecting tools
- verifying business identity and registration details
- monitoring competitors and market intelligence
- powering B2B data enrichment pipelines
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. 1,000,000+ Recipe and Grocery List API (v2) is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?