Endpoints

If you want to see these endpoints in action before getting started, you can use our API Explorer to input sample queries and view the live responses!


Search Endpoint

GIPHY Search gives you instant access to our library of millions of GIFs and Stickers by entering a word or phrase. With our unparalleled search algorithm, users can easily express themselves and animate their conversations.

Gif URLSticker URL
api.giphy.com/v1/gifs/searchapi.giphy.com/v1/stickers/search
Request Parameters:Example:Description:
api_key: string(required)YOUR_API_KEYGIPHY API Key.
q: string(required)cheeseburgersSearch query term or phrase.
limit: integer (int32)20The maximum number of objects to return. (Default: “25”)
offset: integer (int32)5Specifies the starting position of the results. Defaults to 0.
rating: stringgFilters results by specified rating. If you do not specify a rating, you will receive results from all possible ratings.
lang: stringenSpecify default language for regional content; use a 2-letter ISO 639-1 language code.
random_id: stringe826c9fc5c929e0d6c6d423841a282aaAn ID/proxy for a specific user.
Successful Response (200 OK)

Trending Endpoint

GIPHY Trending returns a list of the most relevant and engaging content each and every day. Our feed of trending content is continuously updated, so you always have the latest and greatest at your fingertips.

Gif URLSticker URL
api.giphy.com/v1/gifs/trendingapi.giphy.com/v1/stickers/trending
Request Parameters:Example:Description:
api_key: string(required)YOUR_API_KEYGIPHY API Key.
limit: integer (int32)20The maximum number of objects to return. (Default: “25”)
offset: integer (int32)5Specifies the starting position of the results. Defaults to 0.
rating: stringgFilters results by specified rating. If you do not specify a rating, you will receive results from all possible ratings.
random_id: stringe826c9fc5c929e0d6c6d423841a282aaAn ID/proxy for a specific user.
Successful Response (200 OK)

Translate Endpoint

GIPHY Translate converts words and phrases to the perfect GIF or Sticker using GIPHY's special sauce algorithm. This feature is best exhibited in GIPHY's Slack integration.

Gif URLSticker URL
api.giphy.com/v1/gifs/translateapi.giphy.com/v1/stickers/translate
Request Parameters:Example:Description:
api_key: string(required)YOUR_API_KEYGIPHY API Key.
s: string(required)ryan goslingSearch term.
weirdness: int10Value from 0-10 which makes results weirder as you go up the scale.
random_id: stringe826c9fc5c929e0d6c6d423841a282aaAn ID/proxy for a specific user.
Successful Response (200 OK)

Random Endpoint

GIPHY Random lets you add some weirdness to the conversation by returning a single random GIF or Sticker related to the word or phrase entered. If no tag is specified, the GIF or Sticker returned is completely random.

Gif URLSticker URL
api.giphy.com/v1/gifs/randomapi.giphy.com/v1/stickers/random
Request Parameters:Example:Description:
api_key: string(required)YOUR_API_KEYGIPHY API Key.
tag: stringburritoFilters results by specified tag..
rating: stringgFilters results by specified rating. If you do not specify a rating, you will receive results from all possible ratings.
random_id: stringe826c9fc5c929e0d6c6d423841a282aaAn ID/proxy for a specific user.
Successful Response (200 OK)

Action Register Endpoint

GIPHY’s Action Register registers each time a user views, clicks, or sends a GIF or Sticker and plays an important role in helping GIPHY improve your user’s search results.

INSTRUCTIONS

On almost all of our endpoints we return an Analytics Object for each of the GIF in the response for most endpoints.

To register an action when user views/clicks/sends a GIF, you should make a request by hitting the corresponding URL in the Analytics Object as such, and append the required params in the URL.

ImpressionClickSend
GET analytics->onload->urlGET analytics->onclick->urlGET analytics->onsent->url

BEST PRACTICE

We recommend getting a Random ID for each user by using the Random ID Endpoint. This will allow GIPHY’S API to adjust responses to your users without the use of personally identifiable information.

Request Parameters:Example:Description:
random_id: string(required)e826c9fc5c929e0d6c6d423841a282aaAn ID/proxy for a specific user.
ts: integer (int)(required)1527703430507A UNIX timestamp in milliseconds corresponding to when the action occurred.
Successful Response (200 OK)

Random ID Endpoint

GIPHY Random ID Endpoint allows GIPHY to generate a unique ID you can assign to each new user in your app.

To get the most out of Random ID, we recommend sending the random_id param with all compatible endpoints. This lets us adjust the API response to your users’ preferences and improve their GIF experience while maintaining their privacy.

URL
api.giphy.com/v1/randomid
Request Parameters:Example:Description:
api_key: string(required)YOUR_API_KEYGIPHY API Key.
Successful Response (200 OK)

Get GIF by ID Endpoint

Get GIF by ID returns a GIF’s metadata based on the GIF ID specified.

URL
api.giphy.com/v1/gifs/{gif_id}
Request Parameters:Example:Description:
api_key: string(required)YOUR_API_KEYGIPHY API Key.
gif_id: string(required)xT4uQulxzV39haRFjGThe ID of the GIF you want details for.
random_id: stringe826c9fc5c929e0d6c6d423841a282aaAn ID/proxy for a specific user.
Successful Response (200 OK)

Get GIFs by ID Endpoint

Get GIFs by ID returns metadata of multiple GIFs based on the GIF IDs specified.

URL
api.giphy.com/v1/gifs
Request Parameters:Example:Description:
api_key: string(required)YOUR_API_KEYGIPHY API Key.
ids: string(required)xT4uQulxzV39haRFjG, 3og0IPxMM0erATueVWFilters results by specified GIF IDs, separated by commas.
random_id: stringe826c9fc5c929e0d6c6d423841a282aaAn ID/proxy for a specific user.
Successful Response (200 OK)

Upload Endpoint

GIPHY Upload allows you to upload your content programmatically on GIPHY.com. We accept animated GIFs or video files up to 100MB.

Note: If you're using a rate-limited key assigned by the developer portal, you will not be able to specify a GIPHY channel username to your request and you will be limited to 10 uploads per day. To have these limits removed, you can apply for a production key from your dashboard. Only approved apps will be able to include a GIPHY channel username. You can use this endpoint to upload your content, attach tags, and other meta tag in a single HTTP or HTTPS POST request.

URL
upload.giphy.com/v1/gifs
Request Parameters:Example:Description:
api_key: string(required)YOUR_API_KEYGIPHY API Key.
username: stringJoeCool3000Your assigned username (required for approved apps only).
file: string(binary)The animated GIF or video file you'd like to upload. (Local file resource, required if no source_image_url supplied).
source_image_url: stringhttp://www.mysite.com/myfile.mp4The URL for the image or video you wish to upload (required if no file parameter specified).
tags: stringpets, cat, meowA comma delimited list of tags to be applied to the upload.
source_post_url: stringhttp://www.mysite.com/my-post/The URL of the source of the asset.
Successful Response (200 OK)

GIPHY Custom APIs

If you’d like to customize your app's GIF experience further, we have even more endpoints for you to choose from! To request access to any of the below endpoints, please reach out to us at api@giphy.com.

Additional endpoints include:

Categories API

Allows users to explore and select from available GIF categories and subcategories on GIPHY.

Search Suggestions API

Lets users to discover new and engaging content by providing a list of additional search terms related to the one they originally provided.

Autocomplete API

Speeds up user's search by returning a list of completed search terms given the partial search term already provided.

Trending Search Terms API

Provides users a list of the most popular trending search terms on the GIPHY network.