Search
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.
AuthorizationBearer <token>Personal access token (sv_live_…) — represents you and carries every scope, so no scope is required for this call. Best for your own scripts and internal tools. Generate one at https://savee.com/developers/.
limit?integerPage size (default 30, max 30).
1 <= value <= 30cursor?stringOpaque cursor returned in next_cursor from the previous page. Pass it through verbatim — the encoding is an implementation detail and may change.
query*stringWhat to search for. Must be at least 2 characters.
2 <= lengthA page of matching saves.
application/json- response
data*array<>next_cursor*|Pass as cursor to fetch the next page. null on the last page.
has_more*booleanWhether another page is available. Keep paging while this is true.
curl -X GET 'https://api.savee.com/v1/search?query=string'{ "data": [ { "id": "string", "short_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" }, "detected_aesthetics": "string", "colors": [ { "color": "string", "amount": 0 } ], "user": { "id": "string", "username": "string", "name": "string", "url": "http://example.com", "avatar_url": "http://example.com" } } ], "next_cursor": "string", "has_more": true}