contributors

Get details about contributors' collections

This endpoint gets more detailed information about a contributor's collection, including its cover image, timestamps for its creation, and most recent update. To get the items in collections, use GET /v2/contributors/{contributor_id}/collections/{id}/items.

get/v2/contributors/{contributor_id}/collections/{id}

Request

Base URL
https://api.shutterstock.com
Auth
- OAuth 2
  Authorization codehttps://accounts.shutterstock.com/oauth/authorize
  Token URLhttps://api.shutterstock.com/v2/oauth/access_token
- or HTTP basic
TypeScript
https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/docs/v2/contributors/:contributor_id/collections/:id/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

contributor_idstring required

Contributor ID

idstring required

Collection ID that belongs to the contributor

Response

created_timestring date-time

When the collection was created

idstring required

The collection ID

items_updated_timestring date-time

The last time this collection's items were updated

namestring required

The name of the collection

share_codestring

A code that can be used to share the collection (optional)

share_urlstring

The browser URL that can be used to share the collection (optional)

total_item_countinteger required

The number of items in the collection

updated_timestring date-time

The last time the collection was updated (other than changes to the items in it)

Example response

{
  "id": "293542904",
  "name": "My collection",
  "total_item_count": 85,
  "items_updated_time": "2021-05-20T16:15:22-04:00",
  "cover_item": {
    "id": "297886754"
  }
}

Changes

No recorded changes to this operation across all 3 revisions of this API.