shutterstock-api

The Shutterstock API provides access to Shutterstock's library of media, as well as information about customers' accounts and the contributors that provide the media.

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

API version: 1.0.11
Package version: 0.3.1
Build package: io.swagger.codegen.languages.PythonClientCodegen

Requirements.

Python 2.7 and 3.4+

Installation & Usage

pip install

If the python package is hosted on Github, you can install directly from Github

pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)

Then import the package:

import shutterstock_api

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import shutterstock_api

Getting Started

Please follow the installation procedure and then run the following:

from __future__ import print_function
import time
import shutterstock_api
from shutterstock_api.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: customer_accessCode
configuration = shutterstock_api.Configuration()
configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = shutterstock_api.AudioApi(shutterstock_api.ApiClient(configuration))
id = '\"48433115\"' # str | Collection ID
body = shutterstock_api.CollectionItemRequest() # CollectionItemRequest | List of items to add to collection

try:
    # Add audio tracks to collections
    api_instance.add_soundbox_items(id, body)
except ApiException as e:
    print("Exception when calling AudioApi->add_soundbox_items: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.shutterstock.com

Class	Method	HTTP request	Description
AudioApi	add_soundbox_items	POST /v2/audio/collections/{id}/items	Add audio tracks to collections
AudioApi	create_soundbox	POST /v2/audio/collections	Create audio collections
AudioApi	delete_soundbox	DELETE /v2/audio/collections/{id}	Delete audio collections
AudioApi	delete_soundbox_items	DELETE /v2/audio/collections/{id}/items	Remove audio tracks from collections
AudioApi	download_tracks	POST /v2/audio/licenses/{id}/downloads	Download audio tracks
AudioApi	get_audio_license_list	GET /v2/audio/licenses	List audio licenses
AudioApi	get_genres	GET /v2/audio/genres	List audio genres
AudioApi	get_instruments	GET /v2/audio/instruments	List audio instruments
AudioApi	get_moods	GET /v2/audio/moods	List audio moods
AudioApi	get_soundbox	GET /v2/audio/collections/{id}	Get the details of audio collections
AudioApi	get_soundbox_items	GET /v2/audio/collections/{id}/items	Get the contents of audio collections
AudioApi	get_soundbox_list	GET /v2/audio/collections	List audio collections
AudioApi	get_track	GET /v2/audio/{id}	Get details about audio tracks
AudioApi	get_track_list	GET /v2/audio	List audio tracks
AudioApi	license_track	POST /v2/audio/licenses	License audio tracks
AudioApi	rename_soundbox	POST /v2/audio/collections/{id}	Rename audio collections
AudioApi	search_audio	GET /v2/audio/search	Search for tracks
ContributorsApi	get_contributor	GET /v2/contributors/{contributor_id}	Get details about a single contributor
ContributorsApi	get_contributor_collection_items	GET /v2/contributors/{contributor_id}/collections/{id}/items	Get the items in contributors' collections
ContributorsApi	get_contributor_collections	GET /v2/contributors/{contributor_id}/collections/{id}	Get details about contributors' collections
ContributorsApi	get_contributor_collections_list	GET /v2/contributors/{contributor_id}/collections	List contributors' collections
ContributorsApi	get_contributor_list	GET /v2/contributors	Get details about multiple contributors
EditorialApi	get_editorial_image	GET /v2/editorial/{id}	Get editorial content details
EditorialApi	get_editorial_livefeed	GET /v2/editorial/livefeeds/{id}	Get editorial livefeed
EditorialApi	get_editorial_livefeed_items	GET /v2/editorial/livefeeds/{id}/items	Get editorial livefeed items
EditorialApi	get_editorial_livefeed_list	GET /v2/editorial/livefeeds	Get editorial livefeed list
EditorialApi	license_editorial_image	POST /v2/editorial/licenses	License editorial content
EditorialApi	search_editorial	GET /v2/editorial/search	Search editorial content
ImagesApi	add_lightbox_items	POST /v2/images/collections/{id}/items	Add images to collections
ImagesApi	create_lightbox	POST /v2/images/collections	Create image collections
ImagesApi	delete_lightbox	DELETE /v2/images/collections/{id}	Delete image collections
ImagesApi	delete_lightbox_items	DELETE /v2/images/collections/{id}/items	Remove images from collections
ImagesApi	download_image	POST /v2/images/licenses/{id}/downloads	Download images
ImagesApi	get_featured_lightbox	GET /v2/images/collections/featured/{id}	Get the details of featured image collections
ImagesApi	get_featured_lightbox_items	GET /v2/images/collections/featured/{id}/items	Get the contents of featured image collections
ImagesApi	get_featured_lightbox_list	GET /v2/images/collections/featured	List featured image collections
ImagesApi	get_image	GET /v2/images/{id}	Get details about images
ImagesApi	get_image_categories	GET /v2/images/categories	List image categories
ImagesApi	get_image_license_list	GET /v2/images/licenses	List image licenses
ImagesApi	get_image_list	GET /v2/images	List images
ImagesApi	get_image_recommendations	GET /v2/images/recommendations	List recommended images
ImagesApi	get_lightbox	GET /v2/images/collections/{id}	Get the details of image collections
ImagesApi	get_lightbox_items	GET /v2/images/collections/{id}/items	Get the contents of image collections
ImagesApi	get_lightbox_list	GET /v2/images/collections	List image collections
ImagesApi	get_similar_images	GET /v2/images/{id}/similar	List similar images
ImagesApi	get_updated_images	GET /v2/images/updated	List updated images
ImagesApi	license_images	POST /v2/images/licenses	License images
ImagesApi	rename_lightbox	POST /v2/images/collections/{id}	Rename image collections
ImagesApi	search_images	GET /v2/images/search	Search for images
ImagesApi	upload_ephemeral_image	POST /v2/images	Upload images
TestApi	echo	GET /v2/test	Echo text
TestApi	validate	GET /v2/test/validate	Validate input
UsersApi	create_user	POST /v2/user	Register user
UsersApi	get_access_token	GET /v2/user/access_token	Get access token details
UsersApi	get_user	GET /v2/user	Get user details
UsersApi	get_user_subsciption_list	GET /v2/user/subscriptions	List user subscriptions
VideosApi	add_clipbox_items	POST /v2/videos/collections/{id}/items	Add videos to collections
VideosApi	create_clipbox	POST /v2/videos/collections	Create video collections
VideosApi	delete_clipbox	DELETE /v2/videos/collections/{id}	Delete video collections
VideosApi	delete_clipbox_items	DELETE /v2/videos/collections/{id}/items	Remove videos from collections
VideosApi	download_videos	POST /v2/videos/licenses/{id}/downloads	Download videos
VideosApi	get_clipbox	GET /v2/videos/collections/{id}	Get the details of video collections
VideosApi	get_clipbox_items	GET /v2/videos/collections/{id}/items	Get the contents of video collections
VideosApi	get_clipbox_list	GET /v2/videos/collections	List video collections
VideosApi	get_similar_videos	GET /v2/videos/{id}/similar	List similar videos
VideosApi	get_updated_videos	GET /v2/videos/updated	List updated videos
VideosApi	get_video	GET /v2/videos/{id}	Get details about videos
VideosApi	get_video_categories	GET /v2/videos/categories	List video categories
VideosApi	get_video_license_list	GET /v2/videos/licenses	List video licenses
VideosApi	get_video_list	GET /v2/videos	List videos
VideosApi	license_videos	POST /v2/videos/licenses	License videos
VideosApi	rename_clipbox	POST /v2/videos/collections/{id}	Rename video collections
VideosApi	search_videos	GET /v2/videos/search	Search for videos

Documentation For Models

Documentation For Authorization

basic

Type: HTTP basic authentication

customer_accessCode

Type: OAuth
Flow: accessCode
Authorization URL: https://accounts.shutterstock.com/oauth/authorize
Scopes:
licenses.create: Grant the ability to download and license media on behalf of the user.
purchases.view: Grant read-only access to a user's purchase history.
licenses.view: Grant read-only access to a user's licenses.
collections.edit: Grant the ability to create new collections, edit a collection, and modify the contents of a collection
collections.view: Grant read-only access to a collection and its contents.
user.view: Grants read-only access to a user's basic account information (includes username, id, first and last name). If email is the same as username, it also implies user.email

Lumen5 / shutterstock-api