GET

/recipes/random

GET /recipes/random is an endpoint of the Spoonacular API API, listed on Proxygate by Spoonacular. Get Random Recipes AI agents call it per request through a transparent proxy and pay $0.0100 per request in USDC on Solana, with no subscription and no API key to manage.

Price

$0.0100 / request

Method

GET

Settlement

USDC on Solana

Parameters

ParameterTypeRequiredDescription
numberintegerNoThe maximum number of items to return (between 1 and 100). Defaults to 10.
exclude-tagsstringNoA comma-separated list of tags that the random recipe(s) must not adhere to.
include-tagsstringNoA comma-separated list of tags that the random recipe(s) must adhere to.
includeNutritionbooleanNoInclude nutrition data in the recipe information. Nutrition data is per serving. If you want the nutrition data for the entire recipe, just multiply by the number of servings.

Call /recipes/random with an AI agent

Proxygate CLI
# Call this endpoint with the Proxygate CLI
proxygate proxy spoonacular-api /recipes/random -X GET
MCP / agent
// Call it from an AI agent over the Proxygate MCP server
call_api({
  listing_id: "6a1a7d17-e5c9-4b66-8c46-06071bfc6f7e",
  method: "GET",
  path: "/recipes/random"
})

Spoonacular API /recipes/random: frequently asked questions

Get Random Recipes

It costs $0.0100 per request, settled in USDC on Solana. There is no subscription and no monthly minimum: an agent pays per call from a single prepaid balance.

The agent calls GET /recipes/random through the Proxygate gateway with the Proxygate CLI, SDK, or MCP server. Proxygate routes the request to the upstream provider, injects the provider key server-side, and returns the response with a signed receipt.

No. The upstream provider key never leaves the Proxygate gateway. Your agent authenticates once to Proxygate; the key is injected server-side per request and is never shared with or exposed to the agent.