GIPHY Alt Text for GIFs is now available! Email us to learn more at bd.team@giphy.com.
GIPHY Clips (GIFs with Sound)have arrived! Learn about adding Clips to your app in our documentation!
Need to move your project from Tenor to GIPHY?   Check out our  migration guide!
logo
Create an API Key

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.

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.
Default: “0”
Maximum: “499”
rating: stringgFilters results by specified rating. Acceptable values include g, pg, pg-13, r. If you do not specify a rating, you will receive results from all possible ratings.
customer_id: stringe826c9fc5c929e0d6c6d423841a282aaAn identifier assigned to a user in your platform. Use it consistently across that user's requests. If you do not have your own user ID, you can use the identifier returned by the Random ID Endpoint.
bundle: stringmessaging_non_clipsReturns only renditions that correspond to the named bundle. Read more about renditions.
country_code: stringUSSpecify the country of origin of the end user request, in two-letter ISO 3166-1 alpha-2 format.

Note: Please specify country code if requests are proxied through your service.
region: stringVASpecify the country subdivision of the end user request, found in ISO 3166-2 format.

Note: Please specify region if requests are proxied through your service and country_code is also proxied.
remove_low_contrast: booleantrueUse this parameter to exclude low-contrast items from search results.
Successful Response (200 OK)
PrivacyTerms