Saves

List the authenticated user’s home feed

Saves from users this user follows (and platform-curated content), newest first. Each save includes a user object describing the saver.

get/v1/feed

Request

  • Base URL: https://api.savee.com
  • URL: https://api.savee.com/v1/feed
  • 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: saves:read)

Query parameters

limitinteger

Page size (default 30, max 100).

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

Response

A page of feed 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.