get_resource_detail_by_id
Retrieve detailed information for a specific resource by its ID using the MCP server. Supports PSD, vector, photo, and AI-generated content types. Access metadata, previews, and available formats.
Instructions
Retrieve the detailed information of a specific resource by its ID. This endpoint supports multiple resource types including PSD, vector, photo, and AI-generated content.
Path Parameters:
resource-id (Required): Photo, video or PSD resource ID
Responses:
200 (Success): OK Response
Content-Type:
application/jsonResponse Properties:
Example:
{
"data": {
"preview": {
"width": 300,
"url": "https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm",
"height": 500
},
"new": true,
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"created": "2023-03-07T23:05:26Z",
"available_formats": {
"psd": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"jpg": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"zip": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"fonts": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"svg": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"ai": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"png": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"eps": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"resources": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"3d-render": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
},
"atn": {
"total": 1,
"items": [
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
},
{
"size": 100,
"colorspace": "RGB",
"name": "image.jpg",
"id": 1
}
]
}
},
"type": "photo",
"url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm",
"license": "https://www.freepik.com/profile/license/pdf/4350594",
"premium": true,
"is_ai_generated": true,
"related_resources": {
"suggested": [
{
"preview": {
"width": 300,
"url": "https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm",
"height": 500
},
"new": true,
"premium": true,
"is_ai_generated": true,
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "White t-shirt with copy space on gray background",
"id": 15667327,
"type": "vector",
"has_prompt": true,
"slug": "merry-christmas",
"url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"
},
{
"preview": {
"width": 300,
"url": "https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm",
"height": 500
},
"new": true,
"premium": true,
"is_ai_generated": true,
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "White t-shirt with copy space on gray background",
"id": 15667327,
"type": "vector",
"has_prompt": true,
"slug": "merry-christmas",
"url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"
}
],
"same_author": [
{
"preview": {
"width": 300,
"url": "https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm",
"height": 500
},
"new": true,
"premium": true,
"is_ai_generated": true,
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "White t-shirt with copy space on gray background",
"id": 15667327,
"type": "vector",
"has_prompt": true,
"slug": "merry-christmas",
"url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"
},
{
"preview": {
"width": 300,
"url": "https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm",
"height": 500
},
"new": true,
"premium": true,
"is_ai_generated": true,
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "White t-shirt with copy space on gray background",
"id": 15667327,
"type": "vector",
"has_prompt": true,
"slug": "merry-christmas",
"url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"
}
],
"same_collection": {
"items": [
{
"preview": {
"width": 300,
"url": "https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm",
"height": 500
},
"new": true,
"premium": true,
"is_ai_generated": true,
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "White t-shirt with copy space on gray background",
"id": 15667327,
"type": "vector",
"has_prompt": true,
"slug": "merry-christmas",
"url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"
},
{
"preview": {
"width": 300,
"url": "https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm",
"height": 500
},
"new": true,
"premium": true,
"is_ai_generated": true,
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "White t-shirt with copy space on gray background",
"id": 15667327,
"type": "vector",
"has_prompt": true,
"slug": "merry-christmas",
"url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"
}
],
"url": "https://www.freepik.com/collection/shining"
},
"same_series": {
"items": [
{
"preview": {
"width": 300,
"url": "https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm",
"height": 500
},
"new": true,
"premium": true,
"is_ai_generated": true,
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "White t-shirt with copy space on gray background",
"id": 15667327,
"type": "vector",
"has_prompt": true,
"slug": "merry-christmas",
"url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"
},
{
"preview": {
"width": 300,
"url": "https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm",
"height": 500
},
"new": true,
"premium": true,
"is_ai_generated": true,
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "White t-shirt with copy space on gray background",
"id": 15667327,
"type": "vector",
"has_prompt": true,
"slug": "merry-christmas",
"url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"
}
],
"url": "https://www.freepik.com/serie/32689488"
}
},
"name": "White t-shirt with copy space on gray background",
"id": 15667327,
"has_prompt": true,
"download_size": 1024,
"slug": "merry-christmas",
"related_tags": [
{
"name": "Merry Christmas",
"slug": "merry-christmas",
"url": "https://www.freepik.com/dog"
},
{
"name": "Merry Christmas",
"slug": "merry-christmas",
"url": "https://www.freepik.com/dog"
}
],
"dimensions": {
"width": 2000,
"height": 3000
}
}
}
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"
}
404: Not Found - The server can not find the requested resource.
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 |
|---|---|---|---|
| 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. | |
| resource-id | Yes | Photo, video or PSD resource ID |
Input Schema (JSON Schema)
{
"properties": {
"Accept-Language": {
"description": "Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n",
"type": "string"
},
"resource-id": {
"description": "Photo, video or PSD resource ID",
"type": "string"
}
},
"required": [
"resource-id"
],
"type": "object"
}