Skip to main content

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.

Search for GIFs using the Tenor API. This endpoint provides a wrapper around Tenor’s GIF search functionality, supporting all Tenor search parameters including query, pagination, content filtering, and localization. Tenor Attribution: This endpoint uses the Tenor API. When displaying GIFs from this endpoint, you must include proper attribution to Tenor as required by their Terms of Service. See Tenor’s API documentation for details. This endpoint is public and does not require authentication.

​
Parameters

NameTypeRequiredDescription
qstringYesSearch query string
limitintegerNoMaximum number of results to return (1-50)
posstringNoPagination token for retrieving the next page of results (returned in the next field of the response)
contentfilter"high" | "medium" | "low" | "off"NoContent safety filter level
countrystringNoISO 3166-1 alpha-2 country code for regional content filtering
localestringNoLocale code for language/region preferences (e.g., “en_US”)

​
Returns

GifSearchResponse — GIF search results retrieved successfully 
{
  "items": [
{
  "id": "string",
  "url": "string" /* uri */,
  "preview": {
  "url": "string" /* uri */,
  "width": 0,
  "height": 0
},
  "description": "string",
  "tags": ["string"],
  "tenorUrl": "string" /* uri */,
  "shortTenorUrl": "string" /* uri */,
  "width": 0,
  "height": 0,
  "createdAt": "string" /* date-time */
}
],
  "next": "string"
}

​
Example

import { DiscovrClient } from "discovr";
import type { GifSearchResponse } from "discovr";

const discovr = new DiscovrClient("your-client-id", {
  basePath: "https://api.discovr.media",
});

// After sign-in and profile selection …
const response: GifSearchResponse = await discovr.searchGifs("happy dance", { limit: 20, pos: "next_page_token_here", contentfilter: "medium", country: "US", locale: "en_US" });
console.log(response);