Search APIs
Loading…
← API Store
Social

GIPHY

GIPHY

GIPHY search

GET /giphy/v1/search
Test this endpoint

GIPHY 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

NameTypeDescription
qrequiredstringSearch term. Example: happy dance
typegifs | stickers | clips | textgifs (default), stickers, clips (GIFs with sound) or text (animated text). Example: gifs
limitintegerResults per page, 1 to 50 (default 25).
pageintegerPage number (1 = first), counted in pages of `limit`. Pass `page` + 1 while `has_more` is true.
offsetintegerStart at this result (0-based) instead of `page`.
ratingg | pg | pg-13 | rHighest content rating to include: g, pg, pg-13 or r.
langstring2-letter language of the search term (e.g. en, es, pt, fr), for better matches in that language.
sortrelevant | recentrelevant (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.