Search Savee's public library

Full-text search across Savee's public library — not the caller's own saves. Results include the user who saved each item, since they come from across the platform.

Search is metered separately from the rest of the API and far more tightly: 20 searches per 5 minutes and 200 per week, reported as the search-burst and search-weekly policies in the RateLimit header. Pace against the weekly figure. Requires the search:read scope.

Pages hold at most 30 results (a larger limit is reduced to 30), and a query can be paged through its first 90 results only: next_cursor is null after the 90th, and a cursor past it returns 400. Every page counts as a search.

get/v1/search

Request

Base URL: https://api.savee.com
URL: https://api.savee.com/v1/search
Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://savee.com/oauth/authorize/, token URL https://savee.com/api/oauth/token/, scopes: search:read)

Query parameters

limitinteger

Page size (default 30, max 30).

Example:30

cursorstring

Opaque cursor returned in next_cursor from the previous page. Pass it through verbatim — the encoding is an implementation detail and may change.

Example:eyJjIjoiMjAyNi0wNS0wOFQxMjowMDowMFoiLCJpIjoiNjdhYWRhMjAifQ

querystring required

What to search for. Must be at least 2 characters.

Example:brutalist poster

Response

A page of matching saves.

next_cursorstring nullable required

Pass as cursor to fetch the next page. null on the last page.

has_moreboolean required

Whether another page is available. Keep paging while this is true.

Example response

{
  "data": [
    {
      "id": "67aada20d242ec0009400825",
      "short_id": "UXb_bvc",
      "url": "https://savee.com/i/UXb_bvc/",
      "name": "Brutalist poster",
      "source_url": "https://example.com/poster",
      "created_at": "2026-05-08T12:00:00.000Z",
      "total_saves": 42,
      "media": {
        "type": "image",
        "width": 1600,
        "height": 2400,
        "thumbnail": "https://dm.savee.com/asset_image/w420/6r4nDqE.avif",
        "original": "https://dm.savee.com/asset_image/original/6r4nDqE.avif"
      },
      "detected_aesthetics": "Bold black-and-white typography overlays a textured forest silhouette. Minimalist, grunge, typography, dark, moody, energetic, asymmetric, layered, negative space.",
      "colors": [
        {
          "color": "#1A1A1A",
          "amount": 0.62
        }
      ],
      "user": {
        "id": "63e1a4c2d242ec00094007f1",
        "username": "aliceb",
        "name": "Alice Bauer",
        "url": "https://savee.com/aliceb/",
        "avatar_url": "https://dm.savee.com/user-avatar/original/8kQ2mZp.jpg"
      }
    }
  ],
  "next_cursor": "eyJjIjoiMjAyNi0wNS0wOFQxMjowMDowMFoiLCJpIjoiNjdhYWRhMjAifQ",
  "has_more": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.