Edit in GitHubLog an issue

Getting started with the Adobe Stock API

Approval process

If you are not a Stock for Enterprise customer, the easiest approval method is to join the Adobe Affiliate program.

  1. All users: Apply here to the Adobe Prerelease program for the Stock API.

  2. If you are not an Adobe Affiliate, fill out this survey to give us details about your application and intended use of the Stock API. Some questions are optional, but the more details you give, the better your chances for being accepted.

Approval is not required for Stock for Enteprise customers unless you need to create an OAuth User authentication credential. Enterprise customers can create Server-to-server authentication credentials without an issue. For User authentication, you must apply to the Prerelease program.

You may email the Stock API team with questions.

Do I have Stock for Enterprise?

  1. First, do you have access to the Adobe Admin Console?
  2. Second, when you click on Products, do you see an Adobe Stock product or a Creative Cloud (CC) product? In the screenshot below, this customer has an Adobe Stock Credits product, as well as a CC All Apps product. They can use the Stock API, but only with their Stock credits product. They cannot create an integration for CC All Apps because it is not a Stock product.

Stock product

For more information on why Creative Cloud does not have API access, see the FAQ May I use my Creative Cloud Professional or Professional Plus plan with the Stock API?.

Adobe Affiliates

Join the Adobe Affiliate Program and earn attractive commissions. Promote Adobe Creative Cloud, Adobe Stock and Adobe Document Cloud on your website, blog or social media channel. It's free, it's easy, and it pays.

While most Adobe Affiliates display banner advertising on their websites, affiliate partners can choose to integrate with the Stock Search API to create a custom search experience for their users.

See the Affiliates FAQ for more information.

Note that you will still need to join the Stock API Prerelease program as well as join the Adobe Affiliate program.

Overview

The Adobe Stock API provides programmatic access to Adobe Stock content. You can integrate this API into your organization's applications and processes. You can use the API in scripts or programs to search for and retrieve Adobe Stock assets such as photos, videos, and vector files, and to license assets for your users.

You interact with the Adobe Stock API via HTTP requests instead of a user interface. You can create applications that perform these actions:

  • Search for and retrieve Adobe Stock assets. Your applications can search by keywords, models, contributor, series, and categories, and can also request assets that are similar to other assets or images. You can sort, filter, and page through any results from your searches. Search results contain URLs for thumbnails of the found assets, which you can use to display the thumbnails to your users. Results also can contain metadata about the assets, including information that your applications can use to retrieve the original asset.

  • License assets that your search retrieves. If you have an Authentication token, you can use the API to determine your user's purchasing status, obtain a license for the user for a specific asset, and download the original asset.

  • Get a license history of past purchases. In addition to allowing users to license and download content, your application can retrieve the licensing history for your users or organization, allowing download of previously purchased assets.

API workflow

API workflow

At its simplest, all Stock API integrations include these steps:

  1. Register your application on Adobe I/O.
  2. Determine the authentication method from your use case and build appropriate headers.
  3. Build and deploy your application using Stock APIs.

Design phase

This step is implied by the list above and is outside the scope of this documentation, however everything you learn in the Getting Started section should give you sufficient information to design and architect your application.

As you read the documentation, keep some questions in mind. Some of these will be answered by your use case, but some may require a separate business discussion.

  • Is this an internal integration for members of my company, or for external users?
    • If internal, does my company have Adobe Stock Enterprise entitlements, or just Team and Individual entitlements?
    • If external, do I assume that users will have their own Adobe Stock accounts, or will my company use its own entitlements to purchase on their behalf?
  • Do I need to expose search options to the end user?
    • If yes, what kind of search experience do I want to provide: basic search on keywords only, or allow searching on similar images? The power and flexibility of similarity search is a key differentiator for Adobe Stock.
  • Will my application need to handle licensing of Stock assets, or will users be directed to the Adobe Stock website to purchase?
  • What technology/platform will I be using to create my application?
  • What size and how many image thumbnails do I want to display?
  • Do I require localization?

Next steps

  1. Learn how to register your application on the Adobe Developer Console. You can add as many integrations as you need.
  2. Test how your application will authenticate to the Adobe Stock API.
  3. Finally, start building your app, test and deploy to your users!

More topics

If you have already performed most of the tasks above or are in the middle of an implementation and need detailed help, check out these resources as well:

  • Privacy
  • Terms of Use
  • Do not sell or share my personal information
  • AdChoices
Copyright © 2024 Adobe. All rights reserved.