Run multiple image searches

开发环境

POST

/v2/bulk_search/images

This endpoint runs up to 5 image searches in a single request and returns up to 20 results per search. You can provide global search parameters in the query parameters and override them for each search in the body parameter. The query and body parameters are the same as in the GET /v2/images/search endpoint.

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/v2/bulk_search/images' \
--header 'User-Agent: ShutterstockWorkspace/1.1.30' \
--header 'Content-Type: text/plain' \
--header 'Authorization: Basic Og==' \
--data-raw '[
    {
        "added_date": "<date>",
        "added_date_start": "<date>",
        "aspect_ratio_min": "<number>",
        "aspect_ratio_max": "<number>",
        "aspect_ratio": "<number>",
        "added_date_end": "<date>",
        "authentic": "<boolean>",
        "category": "<string>",
        "color": "<string>",
        "contributor": [
            "<string>",
            "<string>"
        ],
        "contributor_country": [
            "<country-code-2>",
            "<country-code-2>"
        ],
        "fields": "<string>",
        "height": "<integer>",
        "height_from": "<integer>",
        "height_to": "<integer>",
        "image_type": [
            "<string>",
            "<string>"
        ],
        "keyword_safe_search": true,
        "language": "<string>",
        "license": [
            "commercial"
        ],
        "model": [
            "<string>",
            "<string>"
        ],
        "orientation": "<string>",
        "page": 1,
        "per_page": 20,
        "people_model_released": "<boolean>",
        "people_age": "<string>",
        "people_ethnicity": [
            "<string>",
            "<string>"
        ],
        "people_gender": "<string>",
        "people_number": "<integer>",
        "query": "<string>",
        "region": "<country-code-2>",
        "safe": true,
        "sort": "popular",
        "spellcheck_query": true,
        "view": "minimal",
        "width": "<integer>",
        "width_from": "<integer>",
        "width_to": "<integer>"
    },
    {
        "added_date": "<date>",
        "added_date_start": "<date>",
        "aspect_ratio_min": "<number>",
        "aspect_ratio_max": "<number>",
        "aspect_ratio": "<number>",
        "added_date_end": "<date>",
        "authentic": "<boolean>",
        "category": "<string>",
        "color": "<string>",
        "contributor": [
            "<string>",
            "<string>"
        ],
        "contributor_country": [
            "<country-code-2>",
            "<country-code-2>"
        ],
        "fields": "<string>",
        "height": "<integer>",
        "height_from": "<integer>",
        "height_to": "<integer>",
        "image_type": [
            "<string>",
            "<string>"
        ],
        "keyword_safe_search": true,
        "language": "<string>",
        "license": [
            "commercial"
        ],
        "model": [
            "<string>",
            "<string>"
        ],
        "orientation": "<string>",
        "page": 1,
        "per_page": 20,
        "people_model_released": "<boolean>",
        "people_age": "<string>",
        "people_ethnicity": [
            "<string>",
            "<string>"
        ],
        "people_gender": "<string>",
        "people_number": "<integer>",
        "query": "<string>",
        "region": "<country-code-2>",
        "safe": true,
        "sort": "popular",
        "spellcheck_query": true,
        "view": "minimal",
        "width": "<integer>",
        "width_from": "<integer>",
        "width_to": "<integer>"
    }
]'

响应示例

{
 "$ref": "#/components/schemas/BulkImageSearchResults/example"
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Query 参数

Header 参数

Body 参数text/plain

示例

返回响应

🟢200OK

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

修改于 2024-04-26 03:33:20

Search for images

Get suggestions for a search term