Skip to content
Starlight OpenAPI

Get GIF by Id

GET
/gifs/{gifId}

Returns a GIF given that GIF’s unique ID

Authorizations

Parameters

Path Parameters

gifId
required
integer format: int32

Filters results by specified GIF ID.

Responses

200

object
data
object
bitly_url

The unique bit.ly URL for this GIF

string
http://gph.is/1gsWDcL
content_url

Currently unused

string
create_datetime

The date this GIF was added to the GIPHY database.

string format: date-time 
2013-08-01 12:41:48
embded_url

A URL used for embedding this GIF

string
http://giphy.com/embed/YsTs5ltWtEhnq
featured_tags

An array of featured tags for this GIF (Note: Not available when using the Public Beta Key)

Array<string>
id

This GIF’s unique ID

string
YsTs5ltWtEhnq
images

An object containing data for various available formats and sizes of this GIF.

object
downsized
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
downsized_large
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
downsized_medium
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
downsized_small
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
downsized_still
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_height
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_height_downsampled
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_height_small
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_height_small_still
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_height_still
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_width
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_width_downsampled
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_width_small
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_width_small_still
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
fixed_width_still
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
looping
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
original
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
original_still
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
preview
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
preview_gif
object
frames

The number of frames in this GIF.

string
15
height

The height of this GIF in pixels.

string
200
mp4

The URL for this GIF in .MP4 format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4
mp4_size

The size in bytes of the .MP4 file corresponding to this GIF.

string
25123
size

The size of this GIF in bytes.

string
32381
url

The publicly-accessible direct URL for this GIF.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif
webp

The URL for this GIF in .webp format.

string
https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp
webp_size

The size in bytes of the .webp file corresponding to this GIF.

string
12321
width

The width of this GIF in pixels.

string
320
import_datetime

The creation or upload date from this GIF’s source.

string format: date-time 
2013-08-01 12:41:48
rating

The MPAA-style rating for this content. Examples include Y, G, PG, PG-13 and R

string
g
slug

The unique slug used in this GIF’s URL

string
confused-flying-YsTs5ltWtEhnq
source

The page on which this GIF was found

string
http://www.reddit.com/r/reactiongifs/comments/1xpyaa/superman_goes_to_hollywood/
source_post_url

The URL of the webpage on which this GIF was found.

string
http://cheezburger.com/5282328320
source_tld

The top level domain of the source URL.

string
cheezburger.com
tags

An array of tags for this GIF (Note: Not available when using the Public Beta Key)

Array<string>
trending_datetime

The date on which this gif was marked trending, if applicable.

string format: date-time 
2013-08-01 12:41:48
type

Type of the gif. By default, this is almost always gif

string
default: gif
Allowed values: gif
update_datetime

The date on which this GIF was last updated.

string format: date-time 
2013-08-01 12:41:48
url

The unique URL for this GIF

string
http://giphy.com/gifs/confused-flying-YsTs5ltWtEhnq
user

The User Object contains information about the user associated with a GIF and URLs to assets such as that user’s avatar image, profile, and more.

object
avatar_url

The URL for this user’s avatar image.

string
https://media1.giphy.com/avatars/election2016/XwYrZi5H87o6.gif
banner_url

The URL for the banner image that appears atop this user’s profile page.

string
https://media4.giphy.com/avatars/cheezburger/XkuejOhoGLE6.jpg
display_name

The display name associated with this user (contains formatting the base username might not).

string
JoeCool4000
profile_url

The URL for this user’s profile.

string
https://giphy.com/cheezburger/
twitter

The Twitter username associated with this user, if applicable.

string
@joecool4000
username

The username associated with this user.

string
joecool4000
username

The username this GIF is attached to, if applicable

string
JoeCool4000
meta

The Meta Object contains basic information regarding the request, whether it was successful, and the response given by the API. Check responses to see a description of types of response codes the API might give you under different cirumstances.

object
msg

HTTP Response Message

string
OK
response_id

A unique ID paired with this response from the API.

string
57eea03c72381f86e05c35d2
status

HTTP Response Code

integer format: int32 
200

400

Your request was formatted incorrectly or missing required parameters.

403

You weren’t authorized to make your request; most likely this indicates an issue with your API Key.

404

The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist.

429

Your API Key is making too many requests. Read about requesting a Production Key to upgrade your API Key rate limits.