Skip to content

Commit

Permalink
Merge pull request #73 from AdobeDocs/Prerelease
Browse files Browse the repository at this point in the history
Prerelease
  • Loading branch information
chfabbro authored Nov 22, 2024
2 parents 84ad92a + c43f024 commit d3dd105
Showing 1 changed file with 37 additions and 9 deletions.
46 changes: 37 additions & 9 deletions src/pages/getting-started/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,19 +16,47 @@ description: Getting started with the Adobe Stock API. Build an API application

# Getting started with the Adobe Stock API

<InlineAlert variant="success" slots="text"/>
TL;DR: (1) register for an Adobe Stock API key at the Adobe Developer Console*, (2) Add your API key in the following curl** command and make your first search query, then (3) return here to learn more!
<InlineAlert variant="warning" slots="header, text1, text2, text3, text4" />

```shell
curl -H 'x-api-key:myAPIKey' -H 'x-product:myTestApp1.0' https://stock.adobe.io/Rest/Media/1/Search/Files?locale=en_US%26search_parameters%5Bwords%5D=kittens
```
Please read me!

> \* **Adobe Developer Console**: [https://developer.adobe.com/console/](https://developer.adobe.com/console/)<br />
> \*\* **curl**: [https://curl.haxx.se/](https://curl.haxx.se/)
Beginning in November, 2024, the Stock API will only be available to Stock for Enterprise customers. If you don't know if you have Stock for Enterprise, see [Do I have Stock for Enterprise?](#do-i-have-stock-for-enterprise) To create an integration, you must either be a System Administrator or a [member of the Developers group](https://helpx.adobe.com/enterprise/using/manage-developers.html) for the Stock product. *Hint: If you do not see an option to add Developers or API credentials, then you **do not** have Stock for Enterprise.* If you want to get a quote for Stock for Enterprise, please contact your Adobe account representative or [request a callback](https://www.adobe.com/creativecloud/business/enterprise.html#creativecloud-rfi).

## Read me first!
If you are a Stock for Enterprise customer, then you can create a [Server to Server integration](https://developer.adobe.com/developer-console/docs/guides/authentication/ServerToServerAuthentication/), which does not require a login. Go to [Overview](#overview) to begin.

If you do not have Stock for Enterprise, then you will not be able to create an integration at this time without being accepted into a program unless you have a compelling business reason or have an Adobe business sponsor. Adobe affiliates who are approved to join the Adobe campaign may be pre-approved.

The approval process is still being rolled out. You may email [the Stock API team](mailto:[email protected]) with questions.

<!--
To request approval: Go to https://www.adobeprerelease.com and join the "Adobe Stock API" program. As noted, if you have been approved to join the Adobe Affiliate program, then you should be approved to use the Stock API.
-->

## Do I have Stock for Enterprise?

1. First, do you have access to the [Adobe Admin Console](https://adminconsole.adobe.com/)?
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](./stock-api-available.png)

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?](https://developer.adobe.com/stock/docs/faq/stock-api-business-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.

* To join the Adobe Affiliate Program, go here: [https://www.adobe.com/affiliates.html](https://www.adobe.com/affiliates.html).
* For an in-depth use case, see [Get Paid to Search Adobe Stock!](https://medium.com/adobetech/get-paid-to-search-adobe-stock-e2ba9a7c0312)

See the [Affiliates FAQ](faq/stock-api-business-faq.md#affiliates-faq) for more information.

Note that you will still need to join the [Stock API Prerelease program](https://www.adobeprerelease.com) as well as join the Adobe Affiliate program.

<InlineAlert slots="text" />
Continue here once you have access to the API!

Before you begin, be sure to review the [Developer Terms of Use](/faq/terms-for-adobe-stock-developers.md). Or better yet, bookmark it. There will be a quiz later :)

## Overview

Expand Down

0 comments on commit d3dd105

Please sign in to comment.