---
title: "Search saves, or list the newest"
method: GET
path: "/api/v1/saves"
tags: ["Save and read"]
---

# Search saves, or list the newest

`GET /api/v1/saves`

## Request

- Base URL: `https://savehq.app`
- URL: `https://savehq.app/api/v1/saves`
- Auth: HTTP bearer

## Query parameters

- `q` string
- `limit` integer

## Response `200`

Saves

- object
  - `query` string, nullable
  - `saves` object[]
    - `id` string
    - `title` string, nullable
    - `url` string, nullable
    - `author` string, nullable
    - `category` string, nullable
    - `saved_at` string, date-time, nullable

## Other responses

- `401`: Missing, expired or revoked API key or token
- `429`: Over 60 requests a minute for this person; retry after 60 seconds

---

[API](https://skmtc.dev/savehq/apis/savehq-api.md) · [All operations](https://skmtc.dev/savehq/apis/savehq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/savehq/apis/savehq-api/revisions/14aa80bad77d?raw)