Search recipe database | Wynncraft

curl -X POST https://api.wynncraft.com/v3/item/recipe/search \
     -H "Content-Type: application/json" \
     -d '{
  "type": "food",
  "duration": 1100
}'

{
  "controller": {
    "count": 1,
    "current_count": 1,
    "pages": 1,
    "prev": null,
    "current": 1,
    "next": null
  },
  "results": [
    {
      "internalName": "Food1-3",
      "type": "food",
      "skill": "cooking",
      "level": {
        "minimum": 1,
        "maximum": 3
      },
      "materials": [
        {
          "item": "Refined Gudgeon Meat",
          "amount": 2
        },
        {
          "item": "Refined Wheat Grains",
          "amount": 1
        }
      ],
      "healthOrDamage": {
        "minimum": 24,
        "maximum": 32
      },
      "sprites": {
        "default": {
          "format": "attribute",
          "value": {
            "id": "minecraft:rabbit_stew",
            "customModelData": 9,
            "name": "consumable.foodGeneric"
          },
          "name": "fooddefault"
        }
      },
      "xp": 20,
      "duration": {
        "minimum": 1080,
        "maximum": 1116
      },
      "basicDuration": {
        "minimum": 60,
        "maximum": 60
      }
    }
  ]
}

<Note> This endpoint is cached for <Badge intent="error" minimal>1 hour</Badge> in the <Badge intent="success" minimal>SHARED</Badge> cache source. See [Caching](/welcome#caching). <Indent></Indent> This endpoint belongs to the <Badge intent="warning" minimal>ITEMS</Badge> rate-limit bucket. See [Throttling and Rate Limits](/welcome#throttling-and-rate-limits). </Note> <Info> `full_result` bypasses pagination and returns the full raw array instead of the paginated object. </Info> For range filters, an integer checks whether that value falls inside the stored recipe range. A one-value list behaves the same way. A two-value list matches any recipe whose stored range overlaps the requested range.

curl -X POST https://api.wynncraft.com/v3/item/recipe/search \
     -H "Content-Type: application/json" \
     -d '{
  "type": "food",
  "duration": 1100
}'

{
  "controller": {
    "count": 1,
    "current_count": 1,
    "pages": 1,
    "prev": null,
    "current": 1,
    "next": null
  },
  "results": [
    {
      "internalName": "Food1-3",
      "type": "food",
      "skill": "cooking",
      "level": {
        "minimum": 1,
        "maximum": 3
      },
      "materials": [
        {
          "item": "Refined Gudgeon Meat",
          "amount": 2
        },
        {
          "item": "Refined Wheat Grains",
          "amount": 1
        }
      ],
      "healthOrDamage": {
        "minimum": 24,
        "maximum": 32
      },
      "sprites": {
        "default": {
          "format": "attribute",
          "value": {
            "id": "minecraft:rabbit_stew",
            "customModelData": 9,
            "name": "consumable.foodGeneric"
          },
          "name": "fooddefault"
        }
      },
      "xp": 20,
      "duration": {
        "minimum": 1080,
        "maximum": 1116
      },
      "basicDuration": {
        "minimum": 60,
        "maximum": 60
      }
    }
  ]
}

This endpoint is cached for 1 hour in the SHARED cache source. See Caching.

This endpoint belongs to the ITEMS rate-limit bucket. See Throttling and Rate Limits.

full_result bypasses pagination and returns the full raw array instead of the paginated object.

For range filters, an integer checks whether that value falls inside the stored recipe range. A one-value list behaves the same way. A two-value list matches any recipe whose stored range overlaps the requested range.

Query parameters

pageintegerOptional>=1

full_resultenumOptional

Presence-based flag that expands responses. Send it without a value as ?full_result. Using ?full_result=true or ?full_result=false is not accepted.

Allowed values:

Request

This endpoint expects an object.

querystring or list of stringsOptional

Match recipe internalName values by partial name, such as 1-3 or Bow1-3.

xpinteger or list of integersOptional

Match an exact XP value or an inclusive XP range.

typestring or list of stringsOptional

skillstring or list of stringsOptional

materialsstring or list of stringsOptional

Match material item names, case-insensitive.

levelinteger or list of integersOptional

durabilityinteger or list of integersOptional

healthOrDamageinteger or list of integersOptional

durationinteger or list of integersOptional

basicDurationinteger or list of integersOptional

Response

Paginated search results.

controllerobject

resultslist of objects

Errors

400

Bad Request Error

404

Not Found Error

$	curl -X POST https://api.wynncraft.com/v3/item/recipe/search \
>	-H "Content-Type: application/json" \
>	-d '{
>	"type": "food",
>	"duration": 1100
>	}'

1	{
2	"controller": {
3	"count": 1,
4	"current_count": 1,
5	"pages": 1,
6	"prev": null,
7	"current": 1,
8	"next": null
9	},
10	"results": [
11	{
12	"internalName": "Food1-3",
13	"type": "food",
14	"skill": "cooking",
15	"level": {
16	"minimum": 1,
17	"maximum": 3
18	},
19	"materials": [
20	{
21	"item": "Refined Gudgeon Meat",
22	"amount": 2
23	},
24	{
25	"item": "Refined Wheat Grains",
26	"amount": 1
27	}
28	],
29	"healthOrDamage": {
30	"minimum": 24,
31	"maximum": 32
32	},
33	"sprites": {
34	"default": {
35	"format": "attribute",
36	"value": {
37	"id": "minecraft:rabbit_stew",
38	"customModelData": 9,
39	"name": "consumable.foodGeneric"
40	},
41	"name": "fooddefault"
42	}
43	},
44	"xp": 20,
45	"duration": {
46	"minimum": 1080,
47	"maximum": 1116
48	},
49	"basicDuration": {
50	"minimum": 60,
51	"maximum": 60
52	}
53	}
54	]
55	}