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!
logo

GIPHY Clips Search Endpoint

Returns list of video content from GIPHY's network content based on given query phase.

  • Access to Clips endpoints is only available upon approval. Please reach out to clips@giphy.com to request permission.
  • 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.

Request

GET /v1/clips/search
Parameter:Required:Description:
api_keyYesYour issued API key
qYesSearch phrase; Should be the exact terms the user searched for without any correction/enhancement.
Maximum length: 50 chars.
limitNoNumber of content to return from the offset. Defaults to 25.
offsetNoThe offset to start returning content. Defaults to 0.
country_codeNoThe country code, in ISO-3166-1 alpha-2 format. Defaults to automatic detection based on IP. Required if API is implemented via a proxy.
langNoThe language code, in ISO-639-1 format. Defaults to automatic detection based on IP.
ratingNoThe maximum rating of content to return. Defaults to R.

Response

Success 200
Error 4xx/5xx

GIPHY Clips Trending Endpoint

Returns list of trending video content from Giphy’s network

  • Access to Clips endpoints is only available upon approval. Please reach out to clips@giphy.com to request permission.
  • 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.

Request

GET /v1/clips/trending
Parameter:Required:Description:
api_keyYesYour issued API key
limitNoNumber of content to return from the offset (default 25)
offsetNoThe offset to start returning content (default 0)
country_codeNoThe country code, in ISO-3166-1 alpha-2 format. Defaults to automatic detection based on IP.
ratingNoThe maximum rating of content to return. Defaults to PG.

Response

Success 200
Error 4xx/5xx

Content By ID Endpoint

Same functionality as the Get GIF By ID endpoint, but generalized for any Giphy content (GIFs or Clips) based on given ID.

Request

GET /v1/content/:Id
Parameter:Required:Description:
api_keyYesYour issued API key
idYesID of the content (GIF, Sticker, Clip)

Response

Based on the content type of the given ID, the response

Success 200
Error 4xx/5xx

Content By Multiple IDs Endpoint

Same functionality as the Get GIF By IDs endpoint, but generalized for any GIPHY content (GIFs or Clips) based on given IDs.

Request

GET GET /v1/content
Parameter:Required:Description:
api_keyYesYour issued API key
idsYesID of the content (GIF, Sticker, Clip)

Response

Based on the content type of the given ID, the response

Success 200
Error 4xx/5xx