---
title: "GET /v1/random"
method: GET
path: "/v1/random"
---

# GET /v1/random

`GET /v1/random`

Get a randomized list of GIFs for a given search term. This differs from the search endpoint which returns a rank ordered list of GIFs for a given search term.

## Query parameters

- `q` string, required
- `key` string, required
- `locale` string
- `contentfilter` 'off' | 'low' | 'medium' | 'high'
- `media_filter` 'basic' | 'minimal'
- `ar_range` 'all' | 'wide' | 'standard'
- `limit` integer
- `pos` string
- `anon_id` string

## Response `200`

search results

- SearchResult
  - `next` string, required — a position identifier to use with the next API query to retrieve the next set of results, or null if there are no further results.
  - `results` GifObject[], required — an array of GifObjects containing the most relevant GIFs for the requested search term - Sorted by relevancy Rank
    - `created` number, required — a unix timestamp representing when this post was created.
    - `hasaudio` boolean, required — true if this post contains audio (only video formats support audio, the gif image file format can not contain audio information).
    - `id` string, required — Tenor result identifier
    - `media` Media[], required — An array of dictionaries with GIF_FORMAT as the key and MEDIA_OBJECT as the value
      - `gif` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `mediumgif` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `tinygif` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `nanogif` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `mp4` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `loopedmp4` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `tinymp4` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `nanomp4` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `webm` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `tinywebm` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
      - `nanowebm` MediaObject
        - `preview` string, required — a url to a preview image of the media source
        - `url` string, required — a url to the media source
        - `dims` integer[], required — width and height in pixels
        - `size` integer, required — size of file in bytes
    - `tags` string[], required — an array of tags for the post
    - `title` string, required
    - `content_description` string, required

---

[API](https://skmtc.net/tnyim/apis/tenor-gifapi-client.md) · [All operations](https://skmtc.net/tnyim/apis/tenor-gifapi-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tnyim/tenor-gifapi-client/versions/1f7b6e1b5f4e/schema)