A package wrapper for the Giphy public API that allows you to work with all Giphy API endpoints.
Installing using pip
pip install ezgiphy
from ezgiphy import GiphyPublicAPI
giphy = GiphyPublicAPI('<giphy-api-key>')
Search all Giphy GIFs for a word or phrase. Supported parameters:
- q : Search query term or phrase (required).
- limit : The maximum number of records to return.
- offset: An optional results offset.
- rating: Filters results by rating (g/pg/pg-13/r)
- lang: specify default country for regional content.
giphy.search(q='something',limit=25,rating='g')
Experimental search endpoint for gif dialects. Supported parameters:
- s : Search query term or phrase (required).
giphy.translate(s='something')
Get all trending gifs. Supported parameters:
- limit: The maximum number of records to return.
- rating: Filters results by rating (g/pg/pg-13/r),
giphy.trending(limit=25,rating='g')
Random gif(s) filtered by tag. Supported parameters:
- tag: The maximum number of records to return.
- rating: Filters results by rating (g/pg/pg-13/r).
giphy.random(tag='something',rating='g')
Search Giphy gifs for a single Id. Supported parameters:
- id: Filter result by specific gif id (required).
giphy.get_by_id(id='some id')
Search all Giphy gifs for an list of Id's. Supported parameters:
- ids: List of specific ids (required).
giphy.get_by_ids(ids=['id one','id two','id three'])
from ezgiphy import GiphyStickerAPI
sticker = GiphyStickerAPI('<giphy-api-key>')
Search all Giphy Stickers for a word or phrase. Supported parameters:
- q : Search query term or phrase (required).
- limit : The maximum number of records to return.
- offset: An optional results offset.
- rating: Filters results by rating (g/pg/pg-13/r)
- lang: specify default country for regional content.
sticker.search(q='something',limit=25,rating='g')
Experimental search endpoint for sticker dialects. Supported parameters:
- s : Search query term or phrase (required).
sticker.translate(s='something')
Get all trending stickers. Supported parameters:
- limit: The maximum number of records to return.
- rating: Filters results by rating (g/pg/pg-13/r),
sticker.trending(limit=25,rating='g')
Random sticker(s) filtered by tag. Supported parameters:
- tag: The maximum number of records to return.
- rating: Filters results by rating (g/pg/pg-13/r).
sticker.random(tag='something',rating='g')
Search Giphy stickers for a single Id. Supported parameters:
- id: Filter result by specific gif id (required).
sticker.get_by_id(id='some id')
Search all Giphy sticker for an list of Id's. Supported parameters:
- ids: List of specific ids (required).
sticker.get_by_ids(ids=['id one','id two','id three'])