Shutterstock · JSON Structure
Shutterstock Image Structure
JSON structure documentation for Shutterstock stock image objects returned from the API
Type:
Properties: 0
ImagesMediaPhotosStock ImagesVideosAudioLicensingCreative Content
Shutterstock Image Structure is a JSON Structure definition published by Shutterstock.
Meta-schema:
JSON Structure
{
"title": "Shutterstock Image Structure",
"description": "JSON structure documentation for Shutterstock stock image objects returned from the API",
"version": "1.0.30",
"source": "https://api.shutterstock.com",
"fields": [
{
"name": "id",
"type": "string",
"required": true,
"description": "Unique Shutterstock image identifier"
},
{
"name": "description",
"type": "string",
"description": "Text description of the image content"
},
{
"name": "image_type",
"type": "string",
"enum": ["photo", "illustration", "vector"],
"description": "Category of image asset type"
},
{
"name": "is_editorial",
"type": "boolean",
"description": "True if the image requires an editorial license (news/documentary use only)"
},
{
"name": "is_adult",
"type": "boolean",
"description": "True if the image contains adult content"
},
{
"name": "is_illustration",
"type": "boolean",
"description": "True if the image is an illustration or vector art"
},
{
"name": "media_type",
"type": "string",
"enum": ["image"],
"description": "Type of media (always 'image' for image results)"
},
{
"name": "added_date",
"type": "string",
"format": "date",
"description": "Date the image was first added to Shutterstock (YYYY-MM-DD)"
},
{
"name": "contributor",
"type": "object",
"description": "The photographer or artist who created and uploaded the image",
"fields": [
{ "name": "id", "type": "string", "description": "Contributor's Shutterstock ID" }
]
},
{
"name": "assets",
"type": "object",
"description": "Available resolution and format variants for download",
"fields": [
{ "name": "preview", "type": "object", "description": "Standard watermarked preview (300px)" },
{ "name": "small_thumb", "type": "object", "description": "Small thumbnail (67px)" },
{ "name": "large_thumb", "type": "object", "description": "Large thumbnail (150px)" },
{ "name": "huge_thumb", "type": "object", "description": "Huge thumbnail (260px)" },
{ "name": "preview_1000", "type": "object", "description": "1000px preview" },
{ "name": "preview_1500", "type": "object", "description": "1500px preview" },
{ "name": "small", "type": "object", "description": "Small licensed download" },
{ "name": "medium", "type": "object", "description": "Medium licensed download" },
{ "name": "huge", "type": "object", "description": "Huge licensed download" },
{ "name": "supersize", "type": "object", "description": "Maximum resolution licensed download" },
{ "name": "vector_eps", "type": "object", "description": "Vector EPS format (vectors only)" },
{ "name": "huge_tiff", "type": "object", "description": "Uncompressed TIFF format" }
]
},
{
"name": "categories",
"type": "array",
"description": "Shutterstock content categories assigned to this image",
"fields": [
{ "name": "id", "type": "string", "description": "Category identifier" },
{ "name": "name", "type": "string", "description": "Category display name" }
]
},
{
"name": "keywords",
"type": "array",
"items": "string",
"description": "Search keywords describing the image content and context"
},
{
"name": "releases",
"type": "array",
"description": "Model and property release documents for this image"
}
],
"searchResponse": {
"description": "Structure of search results from /v2/images/search",
"fields": [
{ "name": "data", "type": "array", "description": "Array of Image objects" },
{ "name": "page", "type": "integer", "description": "Current result page" },
{ "name": "per_page", "type": "integer", "description": "Results per page" },
{ "name": "total_count", "type": "integer", "description": "Total matching results" },
{ "name": "search_id", "type": "string", "description": "Unique search session ID for tracking" }
]
}
}