---
title: "Get featured GIFs (deprecated alias)"
method: GET
path: "/klipy/featured"
tags: ["GIFs (Deprecated)"]
---

# Get featured GIFs (deprecated alias)

`GET /klipy/featured`

Use /gifs/* instead - these vendor-specific paths are deprecated and will be removed. Routes to the active provider; identical behaviour to /gifs/featured.

## Query parameters

- `locale` 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en-GB' | 'en-US' | 'es-ES' | 'es-419' | 'fi' | 'fr' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'it' | 'ja' | 'ko' | 'lt' | 'nl' | 'no' | 'pl' | 'pt-BR' | 'ro' | 'ru' | 'sv-SE' | 'th' | 'tr' | 'uk' | 'vi' | 'zh-CN' | 'zh-TW' — The locale code for the user interface language

## Response `200`

Success

- GifFeaturedResponse
  - `gifs` GifResponse[], required — Array of featured GIFs.
    - `id` string, required — Provider-stable identifier for this GIF.
    - `slug` string, required — Canonical slug (or slug-id token) used to share / re-resolve this GIF.
    - `provider` string, required — Name of the provider that produced this GIF.
    - `title` string, required — Title or description of the GIF.
    - `url` string, required — Provider page URL for the GIF.
    - `src` string, required — Direct URL to the GIF media file (best format chosen by the server).
    - `proxy_src` string, required — Proxied URL to the GIF media file (best format chosen by the server).
    - `width` integer, required
    - `height` integer, required
    - `media` object, required — Map of format-name → media descriptor. Keys are a size prefix (none for full size, "medium", "tiny", "nano") joined to a codec name ("webm", "mp4", "webp", "gif"), plus "loopedmp4". Video keys are "webm" / "mp4" / "loopedmp4" / "mediumwebm" / "mediummp4" / "tinywebm" / "tinymp4" / "nanowebm" / "nanomp4"; image keys are "webp" / "gif" / "mediumwebp" / "mediumgif" / "tinywebp" / "tinygif" / "nanowebp" / "nanogif". Every key is optional, so clients must walk a priority list rather than index a single key. Clients that cannot decode the video keys should prefer "tinywebp" / "tinygif" / "mediumwebp" / "mediumgif" / "webp" / "gif" / "nanowebp" / "nanogif" in that order.
    - `placeholder` string, nullable — Compact thumbhash placeholder produced by the media proxy. Clients render it as a low-res preview while the GIF loads, and persist it on favourites so the picker has a fallback if the source URL later disappears.
  - `categories` GifCategoryTagResponse[], required — Array of GIF categories.
    - `name` string, required — Category search term (locale-translated label suitable for display).
    - `src` string, required — Category preview image URL from the top GIF for this category search term.
    - `proxy_src` string, required — Proxied category preview image URL from the top GIF for this category search term.
    - `gif` GifResponse, required
      - `id` string, required — Provider-stable identifier for this GIF.
      - `slug` string, required — Canonical slug (or slug-id token) used to share / re-resolve this GIF.
      - `provider` string, required — Name of the provider that produced this GIF.
      - `title` string, required — Title or description of the GIF.
      - `url` string, required — Provider page URL for the GIF.
      - `src` string, required — Direct URL to the GIF media file (best format chosen by the server).
      - `proxy_src` string, required — Proxied URL to the GIF media file (best format chosen by the server).
      - `width` integer, required
      - `height` integer, required
      - `media` object, required — Map of format-name → media descriptor. Keys are a size prefix (none for full size, "medium", "tiny", "nano") joined to a codec name ("webm", "mp4", "webp", "gif"), plus "loopedmp4". Video keys are "webm" / "mp4" / "loopedmp4" / "mediumwebm" / "mediummp4" / "tinywebm" / "tinymp4" / "nanowebm" / "nanomp4"; image keys are "webp" / "gif" / "mediumwebp" / "mediumgif" / "tinywebp" / "tinygif" / "nanowebp" / "nanogif". Every key is optional, so clients must walk a priority list rather than index a single key. Clients that cannot decode the video keys should prefer "tinywebp" / "tinygif" / "mediumwebp" / "mediumgif" / "webp" / "gif" / "nanowebp" / "nanogif" in that order.
      - `placeholder` string, nullable — Compact thumbhash placeholder produced by the media proxy. Clients render it as a low-res preview while the GIF loads, and persist it on favourites so the picker has a fallback if the source URL later disappears.

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid data
- `401` — Unauthorized - Authentication is required or the token is invalid
- `403` — Forbidden - You do not have permission to perform this action
- `429` — Too Many Requests - You are being rate limited
- `500` — Internal Server Error - An unexpected error occurred

---

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