API Object Details

Name

Type

Description

type

string

This tells us whether the returned object is a GIF or a sticker. The default value for type is almost always gif.

id

string

This is a GIF’s unique ID.

url

string

This is a GIF’s unique URL.

slug

string

Slug is a part of a URL that identifies a particular page on a website in a form readable by users. This one is the unique slug used in the GIF's URL. For example, if we have the following URL: http://giphy.com/gifs/confused-flying-YsTs5ltWtEhnq

Then the slug in it would be confused-flying-YsTs5ltWtEhnq.

bitly_gif_url

string

This is the unique "bit.ly" URL for the GIF.

bitly_url

string

This is the unique "bit.ly" URL for the GIF.

embed_url

string

This is the URL used for embedding the GIF.

username

string

This is the username of the channel to which GIF is attached. The value exists only if applicable.

source

string

This is the page where the GIF was found. For example, a GIF's source can be Reddit, HBO Max, giphy.com, and so on.

title

string

This is the title that appears on giphy.com for the GIF.

rating

string

This is the MPAA (Motion Picture Association of America) style rating of the GIF’s content. Valid values include g, pg, pg-13 and r.

content_url

string

This element is currently unused by giphy.com.

source_tld

string

This is the top-level domain of the source URL. For example, if the source post URL is http://giphy.com/5282328320, then source_tld is giphy.com.

source_post_url

string

This is the URL of the webpage where the GIF was found.

is_sticker

integer

This is the flag that shows us whether the object returned is a GIF or a sticker. Its value is 0 if a GIF is returned and 1 for the sticker.

update_datetime

string

This is the date on which the GIF was last updated.

create_datetime

string

This is the date on which the GIF was added to the GIPHY database.

import_datetime

string

This value shows the date and time aGIF was created or uploaded to its source. For example, a GIF was created or uploaded to Reddit at the following date and time: 2021-08-01 12:41:48.

trending_datetime

string

This value shows the date and time a GIF was marked as trending on giphy.com. This value only exists if applicable.

analytics_response_payload

string

This is the analytics' response payload for the GIF.

images

object

This object contains data regarding various available GIF sizes and formats.

user

object

This object contains data about the user associated with the GIF, if applicable. The user is usually the person who created or added the GIF on giphy.com.

analytics

object

This object contains data to register the user actions, such as when a user views, clicks, or sends a GIF.