Skip to content

Lumen5/shutterstock-api

BranchesTags

Repository files navigation

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

Author

About

Python SDK client for the Shutterstock API

Topics

python python3 rest-client shutterstock shutterstock-api

Resources

Readme
Activity
Custom properties

Stars

1 star

Watchers

4 watching

Forks

2 forks
Report repository

Releases

7 tags

Packages

No packages published

Languages