Adobe Stock Image Search Design

Overview

Flow

Search Parameters

In order to provide more accurate search results should be the ability to modify the following search criteria:

Name	Parameter Name	Description	Values
X per page	limit	Number of images per page	32 (default); 64
Image type	content_type	Asset type to display	all (default); photo; Illustration
Safe content	offensive	Include image with violence or nudity	only safe (default); all
Isolated image only	isolated	Image subject is isolated from the background by being on a uniformly colored background.	no (default); yes
Image orientation	orientation	images with specific orientation	all (default); horizontal; vertical; square; panoramic
Image color	colors	Images that have specific color	HEX
Price	premium	Standard or premium (more expensive) images	include Premium (default); standard

Sorting

Parameter	Description
relevance (default)	How closely it matches your search request, closest matches first.
creation	Creation date in descending order (newest first).
popularity	In descending order by the number of views by all users.
nb_downloads	In descending order by the number of downloads by all users since the asset was added to Adobe Stock.
undiscovered	Starting with assets that have not commonly been viewed or downloaded.

Service Contracts

Search API service contracts details available on the Application Service Contracts page

Request Builder Interface

interface RequestBuilderInterface
{
    /**
     * Set page size for result
     *
     * @param int $size
     * @return void
     */
    public function setSize(int $size) : void;

    /**
     * Set offset size
     *
     * @param int $offset
     * @return void
     */
    public function setOffset(int $offset) : void;

    /**
     * Set sorting
     *
     * @param array $sort
     * @return void
     */
    public function setSort(array $sort) : void;

    /**
     * Bind value to placeholder
     *
     * @param string $placeholder
     * @param mixed $value
     */
    public function bind(string $placeholder, $value) : void;

    /**
     * @return RequestInterface
     */
    public function create();
}

Request Configuration

<requests xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <request query="stock_image_search">
        <queries>
            <query xsi:type="query" value="$search_parameters$" name="search_parameters">
                <match field="words"/>
            </query>
        </queries>
        <filters>
            <filter xsi:type="filter" name="content_type_filter" field="content_type" value="$content_type$"/>
            <filter xsi:type="filter" name="offensive_filter" field="offensive" value="$offensive$"/>
            <filter xsi:type="filter" name="isolated_filter" field="isolated" value="$isolated$"/>
            <filter xsi:type="filter" name="orientation_filter" field="orientation" value="$orientation$"/>
            <filter xsi:type="filter" name="colors_filter" field="colors" value="$colors$"/>
            <filter xsi:type="filter" name="premium_filter" field="premium" value="$premium$"/>
        </filters>
        <from>0</from>
        <size>32</size>
    </request>
</requests>