Shutterstock

Brightspot's Shutterstock integration lets you search and import licensed images from a linked Shutterstock account into federated search.

The integration requires a Shutterstock account. See shutterstock.com.

Configuring the integration

To configure the Shutterstock integration:

1. From the left navigation, under Admin, click Sites & Settings.
2. From the Integrations tab, expand the Shutterstock cluster.
3. Expand the Shutterstock API Client list, and select an API client. If the required API client does not appear, click Create New, and complete the following fields:
   1. (Optional) In the Name field, type a name to identify this API client.
   2. In the Consumer Key field, type the consumer key from the Shutterstock Developers Console.
   3. In the Consumer Secret field, type the consumer secret from the Shutterstock Developers Console.
   4. (Optional) In the Access Token Override field, type an access token to use instead of Brightspot's OAuth exchange.
4. Click Save.

note

You must also configure a callback URL and referrer for this API client in the Shutterstock Developers Console. For details, see Applications. Brightspot displays the exact values to enter in a note on the Consumer Key field.

Linking your account

Unless an administrator has linked an enterprise account (see Using an enterprise account), Shutterstock imports images on behalf of the signed-in editor rather than a shared service account. If no account is available to you, searching for Shutterstock Image returns "No matching items!" in the default results view. The "Click here to authenticate Shutterstock" prompt appears only in the authentication view, which is the third view icon in the results toolbar.

To link your Shutterstock account:

1. Open the search panel for Shutterstock.
2. Click the authentication link ("Click here to authenticate Shutterstock" in the authentication view the first time, or Link another account to add an additional account).
3. Sign in to Shutterstock and approve the requested permissions.

After you approve access, Brightspot returns you to the search panel and Shutterstock is ready to search.

Using an enterprise account

If your organization has a Shutterstock enterprise account, an administrator can link it once so that users can search Shutterstock without linking a personal account.

To link an enterprise account:

1. From the left navigation, under Admin, click Sites & Settings.
2. From the Integrations tab, expand the Shutterstock cluster.
3. Expand the Shutterstock API Client list, and select the API client.
4. Click Save.
5. Next to the Shutterstock API Client list, click to open the API client.
6. Below Linked Enterprise Accounts, click Click here to add an enterprise account.
7. Sign in to Shutterstock and approve the requested permissions.

note

The Click here to add an enterprise account link appears only after you select the API client in the site settings and save.

When a user searches Shutterstock, Brightspot uses the user's most recently linked personal account. If the user has not linked a personal account, Brightspot uses the most recently linked enterprise account. When more than one account is available, a Shutterstock Accounts list appears in the search filters so the user can choose which account to search with.

Searching for and importing Shutterstock images

You search Shutterstock from the search panel, in the same way as other db-http integrations. Images you find are read-only until you import them into Brightspot.

To search for and import a Shutterstock image:

1. In the search panel, from the content-type filter, under External Types, select Shutterstock Image.

2. If the results show "No matching items!" for every search, you might not have a linked account. Switch to the authentication view, and link your account. See Linking your account.

3. Enter a search term, and optionally sort the results by popular, newest, relevance, or random.

4. Click an image.

   Brightspot displays the image in the content edit form along with its Shutterstock metadata, such as the description, keywords, and categories.

5. Click Import.

Brightspot imports the image as an asset. For more information about importing and re-importing, see Searching and importing assets.

note

Brightspot does not include a content type for imported Shutterstock images. A developer must define one before the import creates a usable asset. See Shutterstock developer reference.

Image quality and licensing

The Shutterstock module provides a helper that a project's converter can call to download the image. Whether an import uses it depends on how your project's converter is built, so confirm with your developers if imported images are not what you expect.

When the helper is used, it checks the linked account's Shutterstock subscription, which Brightspot records when the account is linked:

• If the account has a subscription with downloads remaining, the helper licenses the image with Shutterstock and downloads the full-resolution image.
• Otherwise, the helper downloads the watermarked preview image.

warning

Licensing an image creates a license with Shutterstock and can use a download from the account's subscription.

Because Brightspot checks the subscription only when the account is linked, a subscription you add or renew afterward is not detected until you link the account again. To refresh the subscription, click Link another account in the search filters and sign in with the same Shutterstock account.

Troubleshooting

Symptom	Likely cause	Resolution
Shutterstock Image does not appear under External Types.	The site has no Shutterstock API client, the API client is not published, or the consumer key or consumer secret is blank.	Complete Configuring the integration for the site.
Searching for Shutterstock Image shows "No matching items!" and no prompt to link an account.	No personal or enterprise Shutterstock account is linked. The prompt appears only in the authentication view, not the default grid or list view.	Switch to the authentication view, the third view icon in the results toolbar, and link an account. See Linking your account or Using an enterprise account.
Shutterstock rejects the sign-in or does not return to Brightspot.	The callback URL or referrer is not registered for the API client in the Shutterstock Developers Console.	Enter the values shown in the note on the Consumer Key field.
Imported images are watermarked or low resolution.	The linked account had no subscription with downloads remaining when it was linked, or the project's converter does not download the licensed image.	Confirm the subscription in Shutterstock, and then link the account again. If the problem continues, ask a developer to review the converter.
Every search returns no results, even for common terms.	Shutterstock rejected the request, for example because the linked account's access was revoked. Brightspot does not display the error and shows an empty result list.	Link the account again. If the problem continues, ask an administrator to confirm the API client's consumer key and secret.
Search returns results from the wrong Shutterstock account.	More than one account is linked, and a different account is selected.	From the Shutterstock Accounts list in the search filters, select the account to search with.