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
| Request Parameters: | Required: | Description: |
|---|
| api_key | Yes | Your issued API key |
| q | Yes | Search phrase; Should be the exact terms the user searched for without any correction/enhancement.
Maximum length: 50 chars. |
| limit | No | Number of content to return from the offset. Defaults to 25. |
| offset | No | The offset to start returning content. Defaults to 0. |
| country_code | No | The country code, in ISO-3166-1 alpha-2 format. Defaults to automatic detection based on IP. Required if API is implemented via a proxy. |
| lang | No | The language code, in ISO-639-1 format. Defaults to automatic detection based on IP. |
| rating | No | The 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
| Request Parameters: | Required: | Description: |
|---|
| api_key | Yes | Your issued API key |
| limit | No | Number of content to return from the offset (default 25) |
| offset | No | The offset to start returning content (default 0) |
| country_code | No | The country code, in ISO-3166-1 alpha-2 format. Defaults to automatic detection based on IP. |
| rating | No | The 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
| Request Parameters: | Required: | Description: |
|---|
| api_key | Yes | Your issued API key |
| id | Yes | ID 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
| Request Parameters: | Required: | Description: |
|---|
| api_key | Yes | Your issued API key |
| ids | Yes | ID of the content (GIF, Sticker, Clip) |
Response
Based on the content type of the given ID, the response
Success 200
Error 4xx/5xx
