GIPHY Alt Text for GIFs is now available! Email us to learn more at bd.team@giphy.com.
GIPHY Clips (GIFs with Sound)have arrived! Learn about adding Clips to your app in our documentation!
Need to move your project from Tenor to GIPHY?   Check out our  migration guide!
logo

The GIF Object

GIF Objects are returned from most of GIPHY API's Endpoints. These objects contain a variety of information, such as the Image Object, which itself includes the URLS for multiple different GIFS formats and sizes.

Property:Example
type: string(default:"gif")
By default, this is almost always GIF.
"gif"
id: string
This GIF's unique ID
"YsTs5ltWtEhnq"
slug: string
The unique slug used in this GIF's URL
"confused-flying-YsTs5ltWtEhnq"
url: string
The unique URL for this GIF
"http://giphy.com/gifs/confused-flying-YsTs5ltWtEhnq"
bitly_url: string
The unique bit.ly URL for this GIF
"http://gph.is/1gsWDcL"
embed_url: string
A URL used for embedding this GIF
"http://giphy.com/embed/YsTs5ltWtEhnq"
username: string
The username this GIF is attached to, if applicable
"JoeCool4000"
source: string
The page on which this GIF was found
"http://www.reddit.com/r/reactiongifs/comments/1xpyaa/superman_goes_to_hollywood/"
rating: string
The MPAA-style rating for this content. Examples include Y, G, PG, PG-13 and R
"g"
content_url: string
Currently unused
user: User
An object containing data about the user associated with this GIF, if applicable.
source_tld: string
The top level domain of the source URL.
"cheezburger.com"
source_post_url: string
The URL of the webpage on which this GIF was found.
"http://cheezburger.com/5282328320"
update_datetime: string
The date on which this GIF was last updated.
"2013-08-01 12:41:48"
create_datetime: string
The date this GIF was added to the GIPHY database.
"2013-08-01 12:41:48"
import_datetime: string
The creation or upload date from this GIF's source.
"2013-08-01 12:41:48"
trending_datetime: string
The date on which this gif was marked trending, if applicable.
"2013-08-01 12:41:48"
images: Images
An object containing data for various available formats and sizes of this GIF.
title: string
The title that appears on giphy.com for this GIF.
"Happy Dancing GIF"
alt_text: string
Alt text enables assistive programs to read descriptions of GIFs.
"Barney the Purple Dinosaur blows out birthday candles."
is_low_contrast: boolean
Indicates whether a Sticker is low contrast. (Note: This field is returned only for Stickers
false