Gifli API Docs
Api

Public feed

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.

GET
/gifs/feed

Query Parameters

cursor?string

Opaque cursor from a previous response's nextCursor. Takes precedence over page.

page?integer

1-based page number (offset mode). Ignored when cursor is set.

limit?integer

Response Body

application/json

application/json

curl -X GET "https://example.com/gifs/feed"
{  "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,  "nextCursor": "string"}
{  "error": "string"}