Savee Developers
Reference

Saves

GET
/v1/saves

List the authenticated user's saves

Newest first. Includes private saves (it's the caller's own data). The user field on each save is omitted because the caller is implicitly the owner.

/v1/saves

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

Personal access token in the form sv_live_\<24 chars\>. Generate one at https://savee.com/developer/.

In: header

Query Parameters

limitinteger

Page size (default 30, max 100).

Example: 30Minimum: 1Maximum: 100

cursorstring

Opaque cursor returned in next_cursor from the previous page.

Status codeDescription
200A page of saves.
400Invalid input.
401Missing or invalid Bearer token.
402Authenticated but the user has no active subscription.
403The Public API is not enabled for this account.
429Rate limit exceeded.
curl -X GET "http://localhost:3060/v1/saves?limit=30&cursor=string"

{
  "data": [
    {
      "id": "string",
      "url": "http://example.com",
      "name": "string",
      "source_url": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "is_private": true,
      "total_saves": 0,
      "media": {
        "type": "image",
        "width": 0,
        "height": 0,
        "thumbnail": "http://example.com",
        "original": "http://example.com"
      },
      "user": {
        "id": "string",
        "username": "string",
        "name": "string",
        "url": "http://example.com",
        "avatar_url": "http://example.com"
      }
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

GET
/v1/feed

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.

/v1/feed

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

Personal access token in the form sv_live_\<24 chars\>. Generate one at https://savee.com/developer/.

In: header

Query Parameters

limitinteger

Page size (default 30, max 100).

Example: 30Minimum: 1Maximum: 100

cursorstring

Opaque cursor returned in next_cursor from the previous page.

Status codeDescription
200A page of feed saves.
400Invalid input.
401Missing or invalid Bearer token.
402Authenticated but the user has no active subscription.
403The Public API is not enabled for this account.
429Rate limit exceeded.
curl -X GET "http://localhost:3060/v1/feed?limit=30&cursor=string"

{
  "data": [
    {
      "id": "string",
      "url": "http://example.com",
      "name": "string",
      "source_url": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "is_private": true,
      "total_saves": 0,
      "media": {
        "type": "image",
        "width": 0,
        "height": 0,
        "thumbnail": "http://example.com",
        "original": "http://example.com"
      },
      "user": {
        "id": "string",
        "username": "string",
        "name": "string",
        "url": "http://example.com",
        "avatar_url": "http://example.com"
      }
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

GET
/v1/boards/{boardID}/saves

List saves on a specific board

boardID is the board id returned by /v1/boards. Accessible by any user with a role on the board (owner, admin, editor, viewer) and by team members for team-owned boards. Returns 404 when the board does not exist or the caller has no role on it — the API does not confirm whether someone else’s board exists.

/v1/boards/{boardID}/saves

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

Personal access token in the form sv_live_\<24 chars\>. Generate one at https://savee.com/developer/.

In: header

Path Parameters

boardID
Required
string

The board id (the id returned by /v1/boards).

Query Parameters

limitinteger

Page size (default 30, max 100).

Example: 30Minimum: 1Maximum: 100

cursorstring

Opaque cursor returned in next_cursor from the previous page.

Status codeDescription
200A page of saves on the board.
400Invalid input.
401Missing or invalid Bearer token.
402Authenticated but the user has no active subscription.
403The Public API is not enabled for this account.
404Board not found or not accessible to the caller.
429Rate limit exceeded.
curl -X GET "http://localhost:3060/v1/boards/string/saves?limit=30&cursor=string"

{
  "data": [
    {
      "id": "string",
      "url": "http://example.com",
      "name": "string",
      "source_url": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "is_private": true,
      "total_saves": 0,
      "media": {
        "type": "image",
        "width": 0,
        "height": 0,
        "thumbnail": "http://example.com",
        "original": "http://example.com"
      },
      "user": {
        "id": "string",
        "username": "string",
        "name": "string",
        "url": "http://example.com",
        "avatar_url": "http://example.com"
      }
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Previous

User

Next

Boards