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

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.
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.
Maximum GIF IDs: “100”
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.
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.
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.
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.
Successful Response (200 OK)
PrivacyTerms