download_resource_by_id
Download specific resources like vectors, PSDs, photos, and AI-generated content by providing a resource ID. Supports resizing images to designated sizes while maintaining aspect ratio.
Instructions
Download a specific resource by providing the resource ID. This endpoint supports downloading various types of resources including vectors, PSDs, photos, and AI-generated content.
Path Parameters:
- resource-id (Required): Photo, video or PSD resource ID
Query Parameters:
- image_size: Resizes the photo to a specified size while maintaining aspect ratio. Accepts a pixel value (100px to 2000px) or keywords small(1000px), medium(1500px), large(2000px), original corresponding to standard website sizes. The size depends on the image orientation, the longest side of the image will be resized to the specified size. If not specified, the highest resolution is provided. Applicable only to photos.
Responses:
- 200 (Success): OK Response
- Content-Type:
application/json
- Response Properties:
- Example:
- Content-Type:
- 400: Bad Request - The server could not understand the request due to invalid syntax.
- Content-Type:
application/json
- Response Properties:
- Example:
- Content-Type:
- 401: Unauthorized - The client must authenticate itself to get the requested response.
- Content-Type:
application/json
- Response Properties:
- Example:
- Content-Type:
- 403: Forbidden - The client does not have permission to access the requested resource.
- Content-Type:
application/json
- Response Properties:
- Example:
- Content-Type:
- 404: Not Found - The server can not find the requested resource.
- Content-Type:
application/json
- Response Properties:
- Example:
- Content-Type:
- 429: Too Many Requests - The client has sent too many requests in a given amount of time.
- Content-Type:
application/json
- Response Properties:
- Example:
- Content-Type:
- 500: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- Content-Type:
application/json
- Response Properties:
- Example:
- Content-Type:
- 503: Service Unavailable
- Content-Type:
application/json
- Response Properties:
- Example:
- Content-Type:
Input Schema
Name | Required | Description | Default |
---|---|---|---|
Accept-Language | No | Specifies the search query language using the ISO 639-1 (2-letter language code) and the ISO 3166-1 (2-letter country code) for language variants. The API will use "en-US" as a default language for processing if a code is not provided, or does not exist. | |
image_size | No | Resizes the photo to a specified size while maintaining aspect ratio. Accepts a pixel value (100px to 2000px) or keywords small(1000px), medium(1500px), large(2000px), original corresponding to standard website sizes. The size depends on the image orientation, the longest side of the image will be resized to the specified size. If not specified, the highest resolution is provided. Applicable only to photos. | |
resource-id | Yes | Photo, video or PSD resource ID |