---
title: "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"
method: GET
path: "/recipes"
tags: ["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 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

`GET /recipes`

## Query parameters

- `any_kw` string
- `folder` string
- `coll` integer
- `filter` string
- `title_kw` string
- `userId` integer
- `username` string
- `token` string
- `photos` boolean
- `boostmine` boolean
- `include_cat` string
- `exclude_cat` string
- `include_primarycat` string
- `exclude_primarycat` string
- `include_ing` string
- `exclude_ing` string
- `cuisine` string
- `db` string
- `userset` string
- `servingsMin` number, double
- `totalMins` integer
- `maxIngredients` integer
- `minIngredients` integer
- `rpp` integer
- `pg` integer
- `vtn` integer
- `vgn` integer
- `chs` integer
- `glf` integer
- `ntf` integer
- `dyf` integer
- `sff` integer
- `slf` integer
- `tnf` integer
- `wmf` integer
- `rmf` integer
- `cps` integer
- `champion` integer
- `synonyms` boolean

## Response `200`

OK

- BigOvenModelAPI2RecipeSearchResult
  - `ResultCount` integer
  - `Results` BigOvenModelAPI2RecipeInfox[]
    - `RecipeID` integer
    - `Title` string
    - `Cuisine` string
    - `Category` string
    - `Subcategory` string
    - `Microcategory` string
    - `StarRating` number, double
    - `WebURL` string
    - `ReviewCount` integer
    - `Poster` BigOvenModelAPI2UserInfoTinyx
      - `UserName` string
      - `UserID` integer
      - `FirstName` string
      - `LastName` string
      - `PhotoUrl` string
    - `IsPrivate` boolean
    - `Servings` number, double
    - `CreationDate` string, date-time
    - `IsRecipeScan` boolean
    - `IsBookmark` boolean
    - `TotalTries` integer
    - `PhotoUrl` string
    - `HasVideos` boolean
  - `SpellSuggest` string

---

[API](https://skmtc.net/bigoven/apis/1-000-000-recipe-and-grocery-list-api-v2.md) · [All operations](https://skmtc.net/bigoven/apis/1-000-000-recipe-and-grocery-list-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigoven/1-000-000-recipe-and-grocery-list-api-v2/revisions/213a69be0728/schema)