Saves

Get a single save

Look up one save by either of its identifiers.

saveID accepts the id returned by any listing endpoint (67aada20d242ec0009400825) or the save's short_id — the segment in its savee.com URL. So a link like https://savee.com/i/997d6DW/ becomes GET /v1/saves/997d6DW directly, with no lookup step in between. The two forms can't be confused: an id is 24 hex characters, a short_id is 7.

Visible to the caller are their own saves (including private ones) and any public save on Savee. A save that exists but isn't visible returns 404 rather than 403 — the API does not confirm whether someone else's private save exists. Unlike /v1/saves, the response always includes the user who created the save, since it may not be the caller.

get/v1/saves/{saveID}

Request

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

Path parameters

saveIDstring required

The save id, or its short_id from a savee.com /i/…/ URL.

Example:997d6DW

Response

The save.

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"
    }
  }
}

Changes

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