Skip to main content
GET
/
gif-search
Search for GIFs
const options = {method: 'GET'};

fetch('https://api.discovr.media/gif-search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "items": [
    {
      "id": "12345678",
      "url": "https://media.tenor.com/example.gif",
      "preview": {
        "url": "https://media.tenor.com/preview.gif",
        "width": 200,
        "height": 200
      },
      "description": "Happy Dance",
      "tags": [
        "happy",
        "dance",
        "celebration"
      ],
      "tenorUrl": "https://tenor.com/view/happy-dance-gif-12345678",
      "shortTenorUrl": "https://tenor.com/example",
      "width": 498,
      "height": 498,
      "createdAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "next": "next_page_token_here"
}

Documentation Index

Fetch the complete documentation index at: https://docs.discovr.media/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
q
string
required

Search query string

Minimum string length: 1
​
limit
integer
default:20

Maximum number of results to return (1-50)

Required range: 1 <= x <= 50
​
pos
string

Pagination token for retrieving the next page of results (returned in the next field of the response)

​
contentfilter
enum<string>
default:medium

Content safety filter level

Available options:
high,
medium,
low,
off
​
country
string

ISO 3166-1 alpha-2 country code for regional content filtering

Pattern: ^[A-Z]{2}$
Example:

"US"

​
locale
string

Locale code for language/region preferences (e.g., "en_US")

Example:

"en_US"

Response

GIF search results retrieved successfully

​
items
object[]
required

Array of GIF results

​
next
string | null

Pagination token for retrieving the next page of results

Example:

"next_page_token_here"