Sign in
GIFs

Search GIFs

Searches the active GIF provider for GIFs matching the given query. The provider name is returned in the X-Fluxer-GIF-Provider response header so clients can adapt without refetching .well-known.

get/gifs/search

Query parameters

qstring required

The search query

The search query

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

The locale code for the user interface language

Response

Success

idstring required

Provider-stable identifier for this GIF.

slugstring required

Canonical slug (or slug-id token) used to share / re-resolve this GIF.

providerstring required

Name of the provider that produced this GIF.

titlestring required

Title or description of the GIF.

urlstring required

Provider page URL for the GIF.

srcstring required

Direct URL to the GIF media file (best format chosen by the server).

proxy_srcstring required

Proxied URL to the GIF media file (best format chosen by the server).

widthinteger required
heightinteger required
mediaobject 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.

placeholderstring 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.

Changes

Changed in 1 of the 21 revisions of this API.11

  • dd0ad4ea1c8811See the full diff
    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ○

      response property items/placeholder list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

Of the 21 revisions, 2 have no diff computed.