Skip to content
Starlight OpenAPI

Get GIFs by ID

GET
/gifs

A multiget version of the get GIF by ID endpoint.

Authorizations

Parameters

Query Parameters

ids
string

Filters results by specified GIF IDs, separated by commas.

Responses

200

object
data
Array<object>
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
downsized_large
object
downsized_medium
object
downsized_small
object
downsized_still
object
fixed_height
object
fixed_height_downsampled
object
fixed_height_small
object
fixed_height_small_still
object
fixed_height_still
object
fixed_width
object
fixed_width_downsampled
object
fixed_width_small
object
fixed_width_small_still
object
fixed_width_still
object
looping
object
original
object
original_still
object
preview
object
preview_gif
object
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
pagination

The Pagination Object contains information relating to the number of total results available as well as the number of results fetched and their relative positions.

object
count

Total number of items returned.

integer format: int32 
25
offset

Position in pagination.

integer format: int32 
75
total_count

Total number of items available.

integer format: int32 
250

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.