GIPHY
GIPHY
GIPHY search
GET /giphy/v1/searchGIPHY GIFs, stickers, clips or animated text for a search term (by default the first 25 results GIPHY shows): id, title, alt text, rating, tags, page, embed and short links, GIF, MP4 and WebP links with size and frames, every rendition (fixed height and width, downsized, stills, previews), source, flags, dates and the creator's channel (name, avatar, description, verified, social links). With limit, page/offset, rating, lang or sort (and always for clips and text) the response also has total_count, offset, limit, page and has_more for paging through up to 5,000 results.
Every response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | Search term. Example: happy dance |
type | gifs | stickers | clips | text | gifs (default), stickers, clips (GIFs with sound) or text (animated text). Example: gifs |
limit | integer | Results per page, 1 to 50 (default 25). |
page | integer | Page number (1 = first), counted in pages of `limit`. Pass `page` + 1 while `has_more` is true. |
offset | integer | Start at this result (0-based) instead of `page`. |
rating | g | pg | pg-13 | r | Highest content rating to include: g, pg, pg-13 or r. |
lang | string | 2-letter language of the search term (e.g. en, es, pt, fr), for better matches in that language. |
sort | relevant | recent | relevant (default) or recent (newest first). |
Every endpoint also takes: raw、fields、fresh、output、records
No sample yet
This endpoint has no published sample. Use “Test this endpoint” to run it in the console playground.