Skip to main content

A wrapper for the giphy public API

Project description

ezgiphy 0.0.3

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

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'])

Giphy Stickers functionalities will available in next version.

.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ezgiphy-0.0.3.tar.gz (3.3 kB view hashes)

Uploaded Source

Built Distribution

ezgiphy-0.0.3-py3-none-any.whl (4.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page