Tenor GIF API

Developer Dashboard → Get a Free API Key →

Become a Tenor API Partner

Partners Include

Tenor's GIF API

The API that delivers the most relevant GIFs for any application, anywhere in the world.

Highlights include:

  • Search across the most relevant GIFs on the internet.
  • Support for 30+ languages and localized content
  • Get general trending, hourly trending, and popular GIFs
  • Receive search & autocomplete suggestions to ensure you users find the most precise GIF
  • Optimized to deliver GIFs that load and consume less bandwidth for every use case
  • Support for content–rating filters

Grab a key for quick access to the internet's most robust and easily consumed GIF API, free of charge.

Autocomplete Suggestions

Get suggested terms for a partial search term (input string) to show as a user is typing. Results are returned in order of what is most likely to drive a share for a given term.

If your users are searching in multiple languages, the locale parameter will yield more relevant search results. If you pass in a locale, our search API will still search all languages, but give higher preference to the given locale. Support for multiple locales is available and easy to enable. Please email [email protected]tenor.com and we will quickly get you set up.

https://api.tenor.com/v1/autocomplete?q=<term>&key=LIVDSRZULELA

Parameters:

NameTypeRequiredDefault ValueDescription
alltermsbooleannofalsefetch all results; available for privileged keys only, overrides limit.
keystringyesn/aclient key for privileged API access
limitintegerno20fetch up to a specified number of results (max: 50).
qstringnon/apartially typed search term
localestring (xx_YY)noen_USspecify default language to interpret search string; xx is ISO 639-1 language code, _YY (optional) is 2-letter ISO 3166-1 country code

Examples:

https://api.tenor.com/v1/autocomplete?key=LIVDSRZULELA&tag=se&locale=id_ID

https://api.tenor.com/v1/autocomplete?key=LIVDSRZULELA&limit=50

https://api.tenor.com/v1/autocomplete?key=LIVDSRZULELA&tag=ha

Sample response:

{
  "results": [
    "happybirthday",
    "happy",
    "haha",
    "hairflip",
    "harrypotter",
    "hate",
    "hangover",
    "haters",
    "harrystyles",
    "hater",
    "happynewyear",
    "hahaha",
    "happyendings",
    "ha",
    "hallelujah",
    "hateyou"
  ]
}

Search Suggestions

Provide related search term options to your users. Get suggested terms for a given search term (input string).

Search suggestions help a user narrow their search or discover related search terms to find a more precise GIF. Results are returned in order of what is most likely to drive a share for a given term, based on historic user search and share behavior. Search suggestions are often displayed above the GIFs returned for a search term.

If your users are searching in multiple languages, the locale parameter will yield more relevant search results. If you pass in a locale, our search API will still search all languages, but give higher preference to the given locale. Support for multiple locales is available and easy to enable. Please email [email protected]tenor.com and we will quickly get you set up.

https://api.tenor.com/v1/search_suggestions?tag=<term>&key=LIVDSRZULELA

Parameters:

NameTypeRequiredDefault ValueDescription
keystringyesn/aclient key for privileged API access
limitintegerno20fetch up to a specified number of results (max: 50).
tagstringnon/asearch term
localestring (xx_YY)noen_USspecify default language to interpret search string; xx is ISO 639-1 language code, _YY (optional) is 2-letter ISO 3166-1 country code

Examples:

https://api.tenor.com/v1/search_suggestions?key=LIVDSRZULELA&tag=smile

Sample response:

{
  "results": [
    "fake smile",
    "creepy smile",
    "evil smile",
    "big smile",
    "awkward smile",
    "anime smile",
    "love",
    "wink"
  ]
}

Register Share

Register a share event when a user taps/shares/sends a GIF.

https://api.tenor.com/v1/registershare?id=<gifid>&key=LIVDSRZULELA

Parameters:

NameTypeRequiredDefault ValueDescription
idintegeryesn/aid of GIF shared
keystringyesn/aclient key for privileged API access
scountintegernon/anumber of prior shares
tagstringnon/aoriginal tag or search string triggering the share

Examples:

https://api.tenor.com/v1/registershare?key=LIVDSRZULELA&id=12345678&tag=hello

Response:

Http status code: 202 (Accepted){
  "status": "ok"
}

Tags

Get a list of popular tags and categories.

If your users are searching in multiple languages, the locale parameter will yield more relevant search results. If you pass in a locale, our search API will still search all languages, but give higher preference to the given locale. Support for multiple locales is available and easy to enable. Please email [email protected]tenor.com and we will quickly get you set up.

https://api.tenor.com/v1/tags?key=LIVDSRZULELA

Parameters:

NameTypeRequiredDefault ValueDescription
typestringnofeaturedspecify a category of tags to retrieve. Possible values: "featured", "explore". Multiple types can be specified, each type separated with a comma

Examples:

https://api.tenor.com/v1/tags?key=LIVDSRZULELA

https://api.tenor.com/v1/tags?key=LIVDSRZULELA&type=featured,explore

Response:

{
  "tags": [
    {
      "searchterm": "hello",
      "path": "https://api.tenor.com/v1/search?tag=hello",
      "image": "https://media.tenor.com/images/6088f94e6eb5dd7584dedda0fe1e52e1/raw",
      "name": "#hello"
    },
    {
      "searchterm": "mindblown",
      "path": "https://api.tenor.com/v1/search?tag=mindblown",
      "image": "https://media.tenor.com/images/5f99e73ac47aaa89758e32b57a26d418/raw",
      "name": "#mindblown"
    },
    {
      "searchterm": "omg",
      "path": "https://api.tenor.com/v1/search?tag=omg",
      "image": "https://media.tenor.com/images/e7071c31f53d2b2b411346a7f4838cfc/raw",
      "name": "#omg"
    },
    {
      "searchterm": "bye",
      "path": "https://api.tenor.com/v1/search?tag=bye",
      "image": "https://media.tenor.com/images/6627db4ce5f307a5647b6445d63e542a/raw",
      "name": "#bye"
    }
  ]
}

GIFs

Each Gif has a corresponding ID that can be stored and looked up. This can be used if you need to call a particular Gif or multiple Gifs for such features like user created collections and favoriting.

https://api.tenor.com/v1/gifs?ids=<ids>&key=LIVDSRZULELA

Parameters:

NameTypeRequiredDefault ValueDescription
idsstringyesn/aa comma separated list of GIF IDs (max: 50)
keystringyesn/aclient key for privileged API access

Examples:

https://api.tenor.com/v1/gifs?key=LIVDSRZULELA&ids=5079878,4900007

Response:

Response Objects

Example

{
  "results": [
    {
      "url": "https://marriedprank.com/qPDk.gif",
      "media": [
        {
          "nanomp4": {
            "url": "https://media.tenor.com/videos/58abddea05dd4cb7453875f8a2083fb7/mp4",
            "dims": [
              150,
              60
            ],
            "duration": 1.1,
            "preview": "https://media.tenor.com/images/364c6c1c7de3d4a9c01e4fb1d3ad5c06/raw"
          },
          "nanowebm": {
            "url": "https://media.tenor.com/videos/8e2fe7dc437ec46f24003be0ac974fdc/webm",
            "dims": [
              150,
              60
            ],
            "preview": "https://media.tenor.com/images/364c6c1c7de3d4a9c01e4fb1d3ad5c06/raw"
          },
          "tinygif": {
            "url": "https://media.tenor.com/images/152b66fa9279557f55ae02899ef98b47/tenor.gif",
            "dims": [
              220,
              88
            ],
            "preview": "https://media.tenor.com/images/fbf954f1a8504adb8c9a8feccc36df80/raw",
            "size": 79929
          },
          "tinymp4": {
            "url": "https://media.tenor.com/videos/b64b7e0a1a4549413dfc6891486c5164/mp4",
            "dims": [
              320,
              128
            ],
            "duration": 1.1,
            "preview": "https://media.tenor.com/images/364c6c1c7de3d4a9c01e4fb1d3ad5c06/raw"
          },
          "tinywebm": {
            "url": "https://media.tenor.com/videos/524fe68e8b27b6d025afceb75149b1ce/webm",
            "dims": [
              320,
              128
            ],
            "preview": "https://media.tenor.com/images/364c6c1c7de3d4a9c01e4fb1d3ad5c06/raw"
          },
          "webm": {
            "url": "https://media.tenor.com/videos/e43301b7f50bdbe1fb3c8f43b76264fb/webm",
            "dims": [
              500,
              200
            ],
            "preview": "https://media.tenor.com/images/364c6c1c7de3d4a9c01e4fb1d3ad5c06/raw"
          },
          "gif": {
            "url": "https://media.tenor.com/images/65b3da99d3626f98e84f014f01d62b31/tenor.gif",
            "dims": [
              500,
              200
            ],
            "preview": "https://media.tenor.com/images/364c6c1c7de3d4a9c01e4fb1d3ad5c06/raw",
            "size": 483352
          },
          "mp4": {
            "url": "https://media.tenor.com/videos/c9125209120e9d2c263f4a0eedb6bacb/mp4",
            "dims": [
              500,
              200
            ],
            "duration": 1.1,
            "preview": "https://media.tenor.com/images/364c6c1c7de3d4a9c01e4fb1d3ad5c06/raw"
          },
          "loopedmp4": {
            "url": "https://media.tenor.com/videos/b57b25b4916848c87997c4df9778329a/mp4",
            "dims": [
              500,
              200
            ],
            "duration": 6.6,
            "preview": "https://media.tenor.com/images/364c6c1c7de3d4a9c01e4fb1d3ad5c06/raw"
          },
          "mediumgif": {
            "url": "https://media.tenor.com/images/844dc1a11bc49e8789613f634b849b69/tenor.gif",
            "dims": [
              500,
              200
            ],
            "preview": "https://media.tenor.com/images/d9a9fd47065c124b8e37816d13e76b48/tenor.gif",
            "size": 372182
          },
          "nanogif": {
            "url": "https://media.tenor.com/images/dc42a0e01f86d67fa5b94d5b02fed6ca/tenor.gif",
            "dims": [
              225,
              90
            ],
            "preview": "https://media.tenor.com/images/5cbaf0fd25e0a241afe81a7312208ea4/raw",
            "size": 83275
          }
        }
      ],
      "created": 1427507183.116661,
      "itemurl": "https://marriedprank.com/view/thumbs-up-zach-galifianakis-gif-3972660",
      "composite": null,
      "hasaudio": false,
      "title": "zach galifianakis",
      "id": "3972660"
    }
  ],
  "next": "0"
}

Response

KeyValue TypeDescription
nextstringa position identifier to use with the next API query to retrieve the next set of results, or null if there are no further results.
resultsResult[]an array of Result objects, containing GIF and video data

Result

KeyValue TypeDescription
createdfloata unix timestamp representing when this post was created.
hasaudiobooleantrue if this post contains audio (only video formats support audio, the gif image file format can not contain audio information).
idstringTenor result identifier
mediaMediaCollectiona collection of Media objects
tagsstring[]an array of tags for the post
titlestringthe title of the post.
itemurlstringthe full URL to view the post on tenor.com.
urlstringa short URL to view the post on tenor.com.

MediaCollection

KeyValue TypeDescription
gifMediaa large-format GIF, good for desktop use
mediumgifMediaa medium-format GIF, good for desktop use
tinygifMediaa small-format GIF, good for mobile use
nanogifMediaa smaller-format GIF, good for mobile use
webmMediaa video version of the GIF, good for desktop use
tinywebmMediaa small video version of the GIF, good for mobile use
nanowebmMediaa smaller video version of the GIF, good for mobile use
mp4Mediaa video version of the GIF, good for desktop use
loopedmp4Mediaa video version of the GIF, repeated several times, good for desktop use
tinymp4Mediaa small video version of the GIF, good for mobile use
nanomp4Mediaa smaller video version of the GIF, good for mobile use

Media

KeyValue TypeDescription
previewstringa url to a preview image of the media source
urlstringa url to the media source
dimsint[]width and height in pixels
sizeintsize of file in bytes

Errors

KeyValue TypeDescription
codeintan optional numeric code
errorstringa string message describing the error

Examples

{
  "code": 1,
  "error": "Localtime is not a valid naive time (%h:%m)."
}
{
  "code": 5,
  "error": "Valid id is required."
}
{
  "error": "no result"
}

Custom APIs & Extended Access

We develop custom endpoints and offer extended access to deliver the most engaging experience for a partner and their users.

What type of custom work?

Custom work that increases searches and shares. This tends to be unique to a particular partner’s use case and userbase. For example, custom file formats and endpoints that personalize results for a particular region, holidays, events, or corporate initiatives.

What type of extended access?

We also provide extended access to a number of features that enable a partner to have more granular controls in creating the GIF experience that best fits their users. Features like:

  • Flagging - ability for a partner to flag a particular GIF, notifying Tenor and removing the GIF from the partner’s library until investigated
  • Graylist - access to a list of search terms that can be blocked. This functions independently of safesearch
  • Tagging - access to richer metadata per GIF

How do I learn more?

We provide custom work and extended access for partners that have Daily Active Users around the 5M range. Please email [email protected]tenor.com and we will quickly get back to you with additional information.

Attribution

All content retrieved from the Tenor API must be properly attributed by including the phrase "Powered by Tenor" where API results are used. You can use either text or one of our "Powered by Tenor" logos.

Get Attribution Logos

API Key

Our docs include a restricted, rate limited example key (LIVDSRZULELA) for you to use while evaluating our API. Before deploying your integration to production, please request your own API key (it's free) so that we can deliver an optimized experience for your audience.

Get API Key

webcam girls chaturbate ~ tiny body porn ~ candie evans videos ~ bumika sax ~ scooby doo porrn ~ monica richard porn ~ online pink sex chat ~ spencer scott xvideos ~ jenaveve jolie naked pics ~ nails tits ~