Skip to main content
GET
/
api
/
v1
/
recipes
/
library
List recipes in the public library
import requests

url = "https://api.example.com/api/v1/recipes/library"

response = requests.get(url)

print(response.text)
{
  "result": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "slug": "<string>",
      "title": "<string>",
      "description": "<string>",
      "example_prompts": [
        "<string>"
      ],
      "chains": [
        "<string>"
      ],
      "tags": [
        "<string>"
      ],
      "category": [
        "<string>"
      ],
      "icon": "<string>",
      "author_name": "<string>",
      "status": "draft",
      "featured": true,
      "verified": true,
      "view_count": 123,
      "use_count": 123,
      "share_count": 123,
      "search_count": 123,
      "locale": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "success": true,
  "suggestion": "",
  "message": "",
  "meta": {
    "total": 123,
    "offset": 123,
    "limit": 123,
    "has_more": true,
    "after": "<string>",
    "before": "<string>"
  }
}

Query Parameters

​
offset
integer
default:0

Number of items to skip before returning results.

Required range: 0 <= x <= 9223372036854776000
​
limit
integer
default:20

The maximum number of items to return. Range: [1, 100].

Required range: 1 <= x <= 100
​
category
string | null

Filter recipes by category slug.

​
tag
string | null

Filter recipes by tag.

​
chain
string | null

Filter recipes by blockchain (e.g. ETH, SOL).

​
featured
boolean | null

When true, return only featured recipes. When false, exclude featured recipes. Omit to return all.

​
query
string | null

Keyword search string to filter recipes by title or description.

​
sort_by
enum<string>
default:popular

Sort order for results. Possible values: popular, newest, most_used.

Available options:
popular,
newest,
most_used

Response

Successful Response

​
result
RecipeRead · object[]
required
​
success
boolean
default:true
​
suggestion
string
default:""
​
message
string
default:""
​
meta
PaginationMeta · object

Pagination metadata for list responses.

Supports both legacy offset-based and cursor-based pagination. Cursor fields (has_more, after, before) are populated for cursor-paginated endpoints. Legacy fields (offset, limit) are populated when the caller uses the deprecated offset parameter.