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

# GET /v1/categories

`GET /v1/categories`

Get a json object containing a list of GIF categories associated with the provided type. Each category will include a corresponding search URL to be used if the user clicks on the category. The search URL will include the apikey, anonymous id, and locale that were used on the original call to the categories endpoint.

## Query parameters

- `key` string, required
- `locale` string
- `type` 'featured' | 'emoji' | 'trending'
- `contentfilter` 'off' | 'low' | 'medium' | 'high'
- `anon_id` string

## Response `200`

categories results

- CategoriesResult
  - `tags` CategoryObject[], required — an array of CategoryObjects where the “name” field has been translated to the passed in locale language.
    - `searchterm` string, required — the English search term that corresponds to the category
    - `path` string, required — the search url to request if the user selects the category
    - `image` string, required — a url to the media source for the category's example GIF
    - `name` string, required — Category name to overlay over the image. The name will be translated to match the locale of the corresponding request

---

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