A wrapper for the giphy public API
Project description
ezgiphy 0.0.4
A wrapper for the Giphy public API.
A package wrapper for the Giphy public API that allows you to work with all Giphy API endpoints.
Installing using pip
pip install ezgiphy
Examples (Giphy public api endpoints)
from ezgiphy import GiphyPublicAPI
giphy = GiphyPublicAPI('<giphy-api-key>')
Phrase search
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')
Translate search
Experimental search endpoint for gif dialects. Supported parameters:
- s : Search query term or phrase (required).
giphy.translate(s='something')
Trending gifs
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 gifs
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')
Giphy Id search
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 by ids
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'])
Examples (Giphy sticker api endpoints)
from ezgiphy import GiphyStickerAPI
sticker = GiphyStickerAPI('<giphy-api-key>')
Phrase search
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')
Translate search
Experimental search endpoint for sticker dialects. Supported parameters:
- s : Search query term or phrase (required).
sticker.translate(s='something')
Trending gifs
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 gifs
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')
Giphy Id search
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 by ids
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'])
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.