---
title: "Find GIFs to attach"
method: GET
path: "/gifs"
---

# Find GIFs to attach

`GET /gifs`

## Request

- Base URL: `https://govir.app/api/v1`
- URL: `https://govir.app/api/v1/gifs`
- Auth: HTTP bearer

Trending GIPHY GIFs, or a search with `q`. Put a GIF's `id` in a part's `gif`. Show "Powered by GIPHY" where you show the results.

## Query parameters

- `q` string
- `offset` integer

## Response `200`

OK

- object
  - `data` object[]
    - `id` string
    - `title` string
    - `width` integer
    - `height` integer
    - `url` string
    - `preview_url` string
  - `next_offset` integer, nullable
  - `attribution` string

## Other responses

- `400`: The request isn't valid
- `401`: No key, a wrong key, or a revoked one
- `409`: Not possible now, or warnings to confirm (needs_confirmation)
- `429`: Too many requests; see Retry-After

---

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