---
title: "Search recipes ranked by how many of the provided ingredients they contain"
method: POST
path: "/compat/v2/recipes/searchRecipesByIngredients"
tags: ["recipes"]
---

# Search recipes ranked by how many of the provided ingredients they contain

`POST /compat/v2/recipes/searchRecipesByIngredients`

## Request body

- object
  - `ingredients` string[], required
  - `userIds` string[]
  - `includeAllFriends` boolean

## Response `200`

Successful response

- object
  - `results` object[], required
    - `recipe` 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
    - `matchedTerms` string[], 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.dev/recipesage/apis/recipesage-api/revisions/78e907baaf99?raw)