download_resource_by_id
Download specific Freepik resources like vectors, PSDs, photos, and AI content by providing the resource ID, with optional image size adjustment for photos.
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/jsonResponse Properties:
Example:
{
"data": {
"signed_url": "https://img.freepik.com/premium-photo/close-up-cat-resting_1048944-9269194.jpg?t=st=1725276607~exp=1725280207~hmac=1538f1b294fc3a19a19e9f02ceeb6594a9a1e36a900de85d47bbd386e27dddbe",
"filename": "blackboard-template.zip",
"url": "https://downloadscdn5.freepik.com/d/1137445/blackboard-template.zip"
}
}400: Bad Request - The server could not understand the request due to invalid syntax.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "message"
}401: Unauthorized - The client must authenticate itself to get the requested response.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "message"
}403: Forbidden - The client does not have permission to access the requested resource.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "message"
}404: Not Found - The server can not find the requested resource.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "message"
}429: Too Many Requests - The client has sent too many requests in a given amount of time.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "message"
}500: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "Internal Server Error"
}503: Service Unavailable
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "Service Unavailable. Please try again later."
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| resource-id | Yes | Photo, video or PSD resource ID | |
| 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. |