---
title: "Full-text search over recipes"
method: POST
path: "/compat/v2/recipes/searchRecipes"
tags: ["recipes"]
---

# Full-text search over recipes

`POST /compat/v2/recipes/searchRecipes`

## Request body

- object
  - `searchTerm` string, required
  - `userIds` string[]
  - `folder` 'main' | 'inbox', required
  - `labels` string[]
  - `labelIntersection` boolean
  - `includeAllFriends` boolean
  - `ratings` integer[]
  - `nutritionFilter` object
    - `calories` object
      - `min` number
      - `max` number
      - `matchMissing` boolean
    - `protein` object
      - `min` number
      - `max` number
      - `matchMissing` boolean
    - `totalCarbs` object
      - `min` number
      - `max` number
      - `matchMissing` boolean
    - `totalFat` object
      - `min` number
      - `max` number
      - `matchMissing` boolean
    - `sodium` object
      - `min` number
      - `max` number
      - `matchMissing` boolean

## Response `200`

Successful response

- object
  - `recipes` object[], required
    - `id` string, uuid, required
    - `userId` string, uuid, required
    - `fromUserId` string, uuid, nullable, required
    - `title` string, required
    - `description` string, required
    - `yield` string, required
    - `activeTime` string, required
    - `totalTime` string, required
    - `source` string, required
    - `url` string, required
    - `folder` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `lastMadeAt` string, nullable, required
    - `rating` integer, nullable, required
    - `recipeLabels` object[], required
      - `label` object, required
        - `title` string, required
    - `recipeImages` object[], required
      - `order` integer, required
      - `image` object, required
        - `location` string, required
    - `fromUser` object, nullable, required
      - `id` string, uuid, required
      - `name` string, required
      - `handle` string, nullable, required
      - `enableProfile` boolean, required
      - `profileImages` object[], required
        - `order` integer, required
        - `imageId` string, uuid, required
        - `image` object, required
          - `id` string, uuid, required
          - `location` string, required
    - `user` object, required
      - `id` string, uuid, required
      - `name` string, required
      - `handle` string, nullable, required
      - `enableProfile` boolean, required
      - `profileImages` object[], required
        - `order` integer, required
        - `imageId` string, uuid, required
        - `image` object, required
          - `id` string, uuid, required
          - `location` string, required
  - `totalCount` integer, required

## Other responses

- `400` — Invalid input data
- `500` — Internal server error

---

[API](https://skmtc.dev/recipesage/apis/recipesage-api.md) · [All operations](https://skmtc.dev/recipesage/apis/recipesage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recipesage/recipesage-api/revisions/08ef517bf108/schema)