# Allrecipes API: Search recipes

> Finds Allrecipes recipes for a dish or ingredients, in search order, with ratings, photos and total times; optionally only recipes ready within a time limit.

Unofficial. Not affiliated with or endorsed by Allrecipes.

- Page: https://fous.com/methods/allrecipes.com/search-recipes
- Method: `allrecipes.com/search_recipes`, version 1
- Website: allrecipes.com
- Returns: title, star rating, number of ratings, total time, photo link, recipe link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `query` | string | yes | `"chicken broccoli casserole"` | Dish or ingredients to search for, for example chicken broccoli casserole. |
| `max_results` | integer | no | `3` | Maximum number of recipes to return, for example 20. Up to 50. Default 20. |
| `max_total_minutes` | integer | no |  | Only include recipes ready within this many minutes, for example 60. Leave blank for no limit. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "query": "chicken broccoli casserole",
  "max_results": 3
}
```

Its output:

```json
{
  "recipes": [
    {
      "title": "Broccoli Chicken Casserole",
      "photo_link": "https://www.allrecipes.com/thmb/jmmvaAT8UFY8u7acw92K-OgMNAA=/282x188/filters:no_upscale():max_bytes(150000):strip_icc():format(webp)/8965-broccoli-chicken-casserole-i-DDMFS-4x3-7c100071a13c4226bae46ea4afcf756b.jpg",
      "total_time": "50 mins",
      "recipe_link": "https://www.allrecipes.com/recipe/8965/broccoli-chicken-casserole-i/",
      "star_rating": 4.2,
      "number_of_ratings": 1063,
      "total_time_minutes": 50
    },
    {
      "title": "Chicken, Broccoli, and Cheddar Casserole",
      "photo_link": "https://www.allrecipes.com/thmb/XKXdLz5hsm4wyzsLg7jdhSW5IIs=/282x188/filters:no_upscale():max_bytes(150000):strip_icc():format(webp)/9373618-ef00b5a5052346a3b9a671b067d04351.jpg",
      "total_time": "50 mins",
      "recipe_link": "https://www.allrecipes.com/recipe/279848/chicken-broccoli-and-cheddar-casserole/",
      "star_rating": 4.7,
      "number_of_ratings": 133,
      "total_time_minutes": 50
    },
    {
      "title": "Curried Chicken and Broccoli Casserole",
      "photo_link": "https://www.allrecipes.com/thmb/QOTW1j1RtIIgqDw_Npta-FeyXRQ=/282x188/filters:no_upscale():max_bytes(150000):strip_icc():format(webp)/2161924-curried-chicken-and-broccoli-casserole-Rock_lobster-4x3-1-739cbff24aa8454bbd9d0054fa4a1e49.jpg",
      "total_time": "1 hr",
      "recipe_link": "https://www.allrecipes.com/recipe/229036/curried-chicken-and-broccoli-casserole/",
      "star_rating": 4.2,
      "number_of_ratings": 131,
      "total_time_minutes": 60
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"allrecipes.com/search_recipes","input":{"query":"chicken broccoli casserole","max_results":3}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find quick weeknight chicken dinner ideas that are ready in under 45 minutes, with ratings and photos
- I need a list of top-rated banana bread recipes, showing how many ratings each has and total prep time
- Search allrecipes for vegetarian lentil soup options I can make in an hour or less
- What are some highly rated beef stew recipes with photos I can browse, up to 15 results?
- Show me recipes using zucchini and parmesan that take 30 minutes total or less

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Dish or ingredients to search for, for example chicken broccoli casserole."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of recipes to return, for example 20. Up to 50."
    },
    "max_total_minutes": {
      "type": "integer",
      "minimum": 1,
      "description": "Only include recipes ready within this many minutes, for example 60. Leave blank for no limit."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "recipes"
  ],
  "properties": {
    "recipes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "recipe_link"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "photo_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "total_time": {
            "type": [
              "string",
              "null"
            ]
          },
          "recipe_link": {
            "type": "string"
          },
          "star_rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "number_of_ratings": {
            "type": "integer"
          },
          "total_time_minutes": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      },
      "description": "Matching recipes in Allrecipes search order."
    }
  }
}
```

## See more

- [Allrecipes API: Get recipe](https://fous.com/methods/allrecipes.com/get-recipe.md): Gets a full Allrecipes recipe by its name or page link, including ingredients, directions, times, ratings and nutrition. Names select the most-rated close match.
- [BBC Good Food API: Search recipes](https://fous.com/methods/bbcgoodfood.com/search-recipes.md): Finds BBC Good Food recipes for a dish or ingredients in search order, with ratings, time, difficulty, photos and links. Excludes app-only recipes.
- [Food Network API: Search recipes](https://fous.com/methods/foodnetwork.com/search-recipes.md): Finds Food Network recipes for a dish or ingredient, optionally filtered by chef, in site search order.
- [Serious Eats API: Search recipes](https://fous.com/methods/seriouseats.com/search-recipes.md): Finds Serious Eats recipes and cooking guides for a dish or technique, in site search order. Results can also include related articles; times appear only when the site shows them.
- [Food Network API: Get recipe](https://fous.com/methods/foodnetwork.com/get-recipe.md): Gets a Food Network recipe by dish name or recipe page link. It returns ingredients, directions, ratings and cooking times; page details that are missing come back as null.
- [BBC Good Food API: Get recipe](https://fous.com/methods/bbcgoodfood.com/get-recipe.md): Gets a full BBC Good Food recipe by dish name or recipe link, including ingredients, method and nutrition per serving. A name uses the closest matching recipe in site search; details absent from the page are null.
- [Serious Eats API: Get recipe](https://fous.com/methods/seriouseats.com/get-recipe.md): Gets a complete Serious Eats recipe by name or page link, with ingredients, directions, timing, nutrition and ratings when the page shows them.
- [DoorDash API: Search restaurants](https://fous.com/methods/doordash.com/search-restaurants.md): Finds DoorDash restaurants delivering to a street address or ZIP code, optionally for a cuisine or dish, in DoorDash's search order. Fees and times reflect guest offers; the numeric fee is null when DoorDash shows no amount.
- [All Allrecipes methods](https://fous.com/methods/allrecipes.com.md)