/giphy-python-client

The GIPHY Core SDK is a wrapper around the GIPHY API

Primary LanguagePythonMozilla Public License 2.0MPL-2.0

⚠️ This project is currently unmaintained

This client is not up to date with the latest Giphy API version and is unlikely to receive support in the future.

Alternatives include:

Giphy Core Client for Python

The Giphy Core SDK is a wrapper around Giphy API.

Giphy is the best way to search, share, and discover GIFs on the Internet. Similar to the way other search engines work, the majority of our content comes from indexing based on the best and most popular GIFs and search terms across the web. We organize all those GIFs so you can find the good content easier and share it out through your social channels. We also feature some of our favorite GIF artists and work with brands to create and promote their original GIF content.

Getting Started

This Python package is automatically generated by the Swagger Codegen project:

  • API version: 0.9.3
  • Package version: 1.0.0
  • Build package: io.swagger.codegen.languages.PythonClientCodegen

Requirements.

Python 2.7 and 3.4+

Installation & Usage

pip install giphy_client

Then import the package:

import giphy_client

Getting Started

Please follow the installation procedure and then run the following:

import time
import giphy_client
from giphy_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = giphy_client.DefaultApi()
api_key = 'dc6zaTOxFJmzC' # str | Giphy API Key.
q = 'cheeseburgers' # str | Search query term or prhase.
limit = 25 # int | The maximum number of records to return. (optional) (default to 25)
offset = 0 # int | An optional results offset. Defaults to 0. (optional) (default to 0)
rating = 'g' # str | Filters results by specified rating. (optional)
lang = 'en' # str | Specify default country for regional content; use a 2-letter ISO 639-1 country code. See list of supported languages <a href = \"../language-support\">here</a>. (optional)
fmt = 'json' # str | Used to indicate the expected response format. Default is Json. (optional) (default to json)

try: 
    # Search Endpoint
    api_response = api_instance.gifs_search_get(api_key, q, limit=limit, offset=offset, rating=rating, lang=lang, fmt=fmt)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DefaultApi->gifs_search_get: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to http://api.giphy.com/v1

Class Method HTTP request Description
DefaultApi gifs_categories_category_get GET /gifs/categories/{category} Category Tags Endpoint.
DefaultApi gifs_categories_category_tag_get GET /gifs/categories/{category}/{tag} Tagged Gifs Endpoint.
DefaultApi gifs_categories_get GET /gifs/categories Categories Endpoint.
DefaultApi gifs_get GET /gifs Get GIFs by ID Endpoint
DefaultApi gifs_gif_id_get GET /gifs/{gif_id} Get GIF by ID Endpoint
DefaultApi gifs_random_get GET /gifs/random Random Endpoint
DefaultApi gifs_search_get GET /gifs/search Search Endpoint
DefaultApi gifs_translate_get GET /gifs/translate Translate Endpoint
DefaultApi gifs_trending_get GET /gifs/trending Trending GIFs Endpoint
DefaultApi stickers_random_get GET /stickers/random Random Sticker Endpoint
DefaultApi stickers_search_get GET /stickers/search Sticker Search Endpoint
DefaultApi stickers_translate_get GET /stickers/translate Sticker Translate Endpoint
DefaultApi stickers_trending_get GET /stickers/trending Trending Stickers Endpoint

Documentation For Models