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.

• GIPHY requires the Trending API call be made from the client side.
• Optionally, use the &rating param to tailor the response per your preferences. Read more here about content ratings.
• Optionally, you can use rendition on demand bundles to limit which renditions the API sends.

Successful Response (200 OK)

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.

• GIPHY requires the Search API call be made from the client side.
• The search keyword should be sent to GIPHY in &q parameter in the API call. Search terms could simply be words or phrases typed by the user. Users can also add the @ sign before a GIPHY username to return content from a specific GIPHY channel. All special characters should be supported and not re-encoded in your search request.
• This keyword should be the exact terms the user searched for without any correction/enhancement
• Optionally, use the &lang parameter to indicate the language the user has typed in. This will help return unique regional content, if available. See here for supported languages.
• You may use the &rating param to tailor the response per your preferences. Read more here about content ratings
• Optionally, you can use rendition on demand bundles to limit which renditions the API sends.

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.

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.

Successful Response (200 OK)

Action Register Endpoint

The GIPHY Action Register endpoint registers each time a user views, clicks, or sends a GIF or Sticker, helping GIPHY improve your users' search results.

INSTRUCTIONS

STEP 1: Most endpoints include an Analytics Object for each GIF in the response payload. To register user interactions (e.g., view, click, or send), trigger a request to the appropriate tracking URL specified in the Analytics Object.

"analytics": {
  "onload": {
    "url": "https://giphy-analytics.giphy.com/v2/pingback_simple?
                          analytics_response_payload=e%3DZXZlbnRf&action_type=SEEN"
  },
  "onclick": {
    "url": "https://giphy-analytics.giphy.com/v2/pingback_simple?
                          analytics_response_payload=e%3DZXZlbnRf&action_type=CLICK"
  },
  "onsent": {
    "url": "https://giphy-analytics.giphy.com/v2/pingback_simple?
                          analytics_response_payload=e%3DZXZlbnRf&action_type=SENT"
  }
}

STEP 2: Build the pingback URL by appending customer_id and ts parameters to the tracking URL.

Successful Response (200 OK) indicates that the analytics request has been processed. Below is an example of how to build a pingback URL using JavaScript code:

1// Step 1: "gifItem" is a GifItem object from a GIF API response
2const analytics = gifItem.analytics;
3
4// Step 2: Build pingback URL
5const baseUrl = new URL(analytics.onload.url);
6
7baseUrl.searchParams.append('ts', Date.now().toString());
8baseUrl.searchParams.append('customer_id', randomId);
9
10// Step 3: Send GET pingback
11const pingRes = await fetch(baseUrl.toString());
12// A 200 "OK" means the pingback was accepted

Random ID Endpoint

The GIPHY Random ID Endpoint generates a unique identifier that does not include personal information.

Compatible API and analytics endpoints use customer_id to help personalize responses for the same user while maintaining user privacy. If you do not have your own stable user identifier, use the random_id returned by this endpoint as the customer_id on those requests.

Successful Response (200 OK)

The GIPHY Emoji Endpoints

GIPHY has released a feature across all GIPHY apps and platforms that makes GIPHY’s uniquely diverse emoji library more accessible than ever. Pairing custom artwork with a purpose-built API endpoint, GIPHY emojis allow you to bring animated reaction emojis to your users with style and ease.

The Emoji Endpoint

This endpoint is used to fetch GIF Objects for the set of GIPHY Emoji.

Variations

• The GIF Objects returned by this endpoint have the additional property variation_count
• If this value is populated with a number greater than 0, it indicates that the emoji has some number of variations. These variations represent different stylings or skin tones for that emoji.

Successful Response (200 OK)

The Emoji Variations Endpoint

If an emoji's' variation_count is greater than 0, use the Emoji Variations Endpoint to fetch its variations.

Fetch the variations associated with a given emoji using the "id" property of the The GIF Object.

Successful Response (200 OK)

On the front-end, we reccomend displaying the variations in a tray above the emoji, as is a standard in popular platforms across mobile and web.

Check out the GIPHY Mobile Apps, or the GIPHY SDK, to see how we've chosen to display emoji variations.

Get GIF by ID Endpoint

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

• Optionally, use the &rating param to tailor the response per your preferences. Read more here about content ratings.

Successful Response (200 OK)

Error 4xx/5xx

Get GIFs by ID Endpoint

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

• Optionally, use the &rating param to tailor the response per your preferences. Read more here about content ratings.

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.

Successful Response (200 OK)

Categories API

Providers users a list of Gif categories on the GIPHY network.

Successful Response (200 OK)

Autocomplete API

Providers users a list of valid terms that completes the given tag on the GIPHY network.

Successful Response (200 OK)

Channel Search Endpoint

Channel Search endpoint returns all the GIPHY channels matching the query term

Successful Response (200 OK)

Search Suggestions

Providers users a list of tag terms related to the given tag on the GIPHY network.

Successful Response (200 OK)

Trending Search Terms API

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

Successful Response (200 OK)