Translate phrase to Sticker

GET

/stickers/translate

The translate API draws on search, but uses the GIPHY special sauce to handle translating from one vocabulary to another. In this case, words and phrases to GIFs.

Authorizations

• api_key

Parameters

Query Parameters

s

required

string

Search term.

Responses

200

object

data

object

bitly_url

The unique bit.ly URL for this GIF

string

Example

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

Example

2013-08-01 12:41:48

embded_url

A URL used for embedding this GIF

string

Example

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

Example

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

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

downsized_large

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

downsized_medium

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

downsized_small

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

downsized_still

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_height

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_height_downsampled

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_height_small

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_height_small_still

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_height_still

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_width

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_width_downsampled

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_width_small

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_width_small_still

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

fixed_width_still

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

looping

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

original

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

original_still

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

preview

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

preview_gif

object

frames

The number of frames in this GIF.

string

Example

15

height

The height of this GIF in pixels.

string

Example

200

mp4

The URL for this GIF in .MP4 format.

string

Example

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

mp4_size

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

string

Example

25123

size

The size of this GIF in bytes.

string

Example

32381

url

The publicly-accessible direct URL for this GIF.

string

Example

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

webp

The URL for this GIF in .webp format.

string

Example

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

webp_size

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

string

Example

12321

width

The width of this GIF in pixels.

string

Example

320

import_datetime

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

string format: date-time

Example

2013-08-01 12:41:48

rating

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

string

Example

g

slug

The unique slug used in this GIF’s URL

string

Example

confused-flying-YsTs5ltWtEhnq

source

The page on which this GIF was found

string

Example

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

Example

http://cheezburger.com/5282328320

source_tld

The top level domain of the source URL.

string

Example

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

Example

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

Example

2013-08-01 12:41:48

url

The unique URL for this GIF

string

Example

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

Example

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

Example

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

Example

JoeCool4000

profile_url

The URL for this user’s profile.

string

Example

https://giphy.com/cheezburger/

twitter

The Twitter username associated with this user, if applicable.

string

Example

@joecool4000

username

The username associated with this user.

string

Example

joecool4000

username

The username this GIF is attached to, if applicable

string

Example

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

Example

OK

response_id

A unique ID paired with this response from the API.

string

Example

57eea03c72381f86e05c35d2

status

HTTP Response Code

integer format: int32

Example

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.