---
title: "Search recipes by diet, cuisine, and macros"
method: GET
path: "/recipes/search"
tags: ["Recipes"]
---

# Search recipes by diet, cuisine, and macros

`GET /recipes/search`

## Request

- Base URL: `https://exercise-api.ymove.app/api/v2`
- URL: `https://exercise-api.ymove.app/api/v2/recipes/search`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

## Query parameters

- `query` string
- `diet` 'high_protein' | 'low_carb' | 'keto' | 'vegan' | 'vegetarian' | 'mediterranean' | 'paleo'
- `cuisine` 'american' | 'mediterranean' | 'asian' | 'mexican' | 'italian' | 'indian' | 'japanese'
- `mealType` 'breakfast' | 'lunch' | 'dinner' | 'snack'
- `maxCalories` number
- `minProtein` number
- `page` integer
- `pageSize` integer

## Response `200`

Paginated list of recipes

- object
  - `data` Recipe[]
    - `id` string
    - `title` string
    - `description` string
    - `cuisine` string
    - `diet` string[]
    - `mealType` string
    - `prepTimeMinutes` integer
    - `cookTimeMinutes` integer
    - `servings` integer
    - `calories` number
    - `protein` number
    - `carbs` number
    - `fat` number
    - `fiber` number
    - `ingredients` object[]
      - `name` string
      - `amount` string
      - `calories` number
      - `protein` number
    - `instructions` string[]
  - `pagination` Pagination
    - `page` integer, required
    - `pageSize` integer, required
    - `total` integer, required
    - `totalPages` integer, required

---

[API](https://skmtc.dev/ymove/apis/ymove-fitness-api.md) · [All operations](https://skmtc.dev/ymove/apis/ymove-fitness-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ymove/apis/ymove-fitness-api/revisions/6636f2b4a343?raw)