List my GIFs
Paginated list of GIFs owned by the caller. With a bare app token it returns GIFs across all of the app's service accounts.
Pass a user session token (from /auth/login) or an app API key (gk_…).
In: header
Query Parameters
Page number (1-indexed).
Results per page.
Response Body
application/json
application/json
curl -X GET "https://example.com/gifs/me"{ "items": [ { "id": "string", "name": "string", "description": "string", "url": "http://example.com", "mimeType": "image/webp", "sizeBytes": "204800", "width": 0, "height": 0, "thumbhash": "string", "userId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" } ], "total": 0, "page": 0, "limit": 0, "pages": 0}{ "error": "string"}Upload a GIF POST
Upload a GIF, PNG, WebP, MP4, or WebM up to 10 MB. Files are converted to WebP and an AI description is added asynchronously.
Public feed GET
Feed of all GIFs, newest first. Public. Two pagination modes: - **Cursor (recommended):** pass the `nextCursor` value from the previous response as `cursor`. Stable under concurrent uploads/deletes — pages never overlap or skip items. `total` and `page` are omitted in this mode. - **Page:** pass `page` (1-200). Simpler, but offset-based; item positions can shift between requests when the feed changes. Every response includes `nextCursor` for the item after the last one returned (`null` when the feed is exhausted), so clients can switch to cursor pagination after any page.