Get Media Details
This API will get media details by using unique media ID
GET https://www.123rfapis.com/?method=getInfo&id=
Parameters
Field | Type | Description |
---|---|---|
api_key | string | API Key Value cannot be left empty |
id | int | Media's unique identifier (add 10 infront the id for 123rf images, 11 for StockUnlimited, 12 for StockUnlimited Free, 13 for 123RF PLUS, 14 for 123RF FREE) |
Responses
Field | Type | Description |
---|---|---|
id | int | Media's ID |
id | int | Footage media's ID |
thumbnail | string | Media's thumbnail URL (450px with watermark) |
thumbnail | string | Media's thumbnail URL (600px with watermark) |
description | string | Media's description |
keywords | array | Keywords relevance to the Media |
file_name | string | Media's filename |
file_name | string | Footage's filename |
folder | string | Contributor's folder which the Media is located |
media_type | string | Media's media type; either is Media or footage |
contributor | object | Contributor's information: |
id | string | Contributor's ID |
realname | string | Contributor's real name (Availability based on contributor's privacy) |
location | string | Contributor's location (Availability based on contributor's privacy) |
datejoined | string | Contributor's date joined (Availability based on contributor's privacy) |
release | object | Media's release information |
model | bool | Model release is available if this value is 'true' |
property | bool | Property release is available if this value is 'true' |
file_type | string | Filetype |
orientation | string | Media's media type; either is horizontal, vertical, or square |
width | int | Media's width in pixels |
height | int | Media's height in pixels |
sizes | object | Available download types of the media |
res | string | Media's resolution |
format | string | Media's format available (jpg, eps, png, etc..) |
format | string | Footage's format available (mov) |
width | int | Media's width in pixels |
height | int | Media's height in pixels |
output_width | int | Media's output width |
output_height | int | Media's output height |
output_unit | string | Media's output unit |
dpi | int | Media's DPI |
uncompressed | float | Media's raw size |
filesize | int | Media's file size |
file_size | string | Footage's file size |
editorial | bool | Return 'true' if the file is editorial type |
frame_rate | float | Footage's frame rate |
duration | int | Footage's Duration |
preview | string | Footage preview URL |
Response Codes
Code | Description |
---|---|
200 | OK |
400 | Bad request |
Sample Request
GET http://www.123rfapis.com/?api_key={api key}&method=getInfo&id=1024698356
GET http://www.123rfapis.com/?api_key={api key}&method=getInfo&id=1027927891
GET http://www.123rfapis.com/?api_key={api key}&method=getInfo&id=111542017
GET http://www.123rfapis.com/?api_key={api key}&method=getInfo&id=13127236130
GET http://www.123rfapis.com/?api_key={api key}&method=getInfo&id=14126866067
Sample Responses
{
"id": "1024698356",
"description": "Paddy field in a sunny day",
"keywords": {
"1": "agriculture",
"2": "asia",
"3": "building",
"4": "cloud",
"5": "cloudy",
"6": "countryside",
"7": "day",
"8": "farm",
"9": "field",
"10": "grain",
"11": "grass",
"12": "harvest",
"13": "japan",
"14": "landscape",
"15": "nagaoka",
"16": "nature",
"17": "outdoor",
"18": "paddy",
"19": "paddy field",
"20": "padi",
"21": "plant",
"22": "rice",
"23": "scenery",
"24": "summer",
"25": "sunny",
"26": "wide"
},
"file_name": "urgent131200006",
"folder": "urgent1312",
"media_type": "image",
"contributor": {
"id": "urgent",
"realname": "JihChuan Lai",
"location": "MY",
"datejoined": "2013-03-28"
},
"release": {
"model": false,
"property": false
},
"orientation": "horizontal",
"sizes": {
"s": {
"res": "s",
"format": "jpg",
"width": 450,
"height": 300,
"output_width": 6.25,
"output_height": 4.17,
"output_unit": "inch",
"dpi": 72,
"uncompressed": 0.39
},
"m": {
"res": "m",
"format": "jpg",
"width": 848,
"height": 565,
"output_width": 11.78,
"output_height": 7.85,
"output_unit": "inch",
"dpi": 72,
"uncompressed": 1.37
},
"ml": {
"res": "ml",
"format": "jpg",
"width": 1678,
"height": 1119,
"output_width": 5.59,
"output_height": 3.73,
"output_unit": "inch",
"dpi": 300,
"uncompressed": 5.37
},
"l": {
"res": "l",
"format": "jpg",
"width": 2508,
"height": 1672,
"output_width": 8.36,
"output_height": 5.57,
"output_unit": "inch",
"dpi": 300,
"uncompressed": 12
},
"xl": {
"res": "xl",
"format": "jpg",
"width": 3831,
"height": 2554,
"output_width": 12.77,
"output_height": 8.51,
"output_unit": "inch",
"dpi": 300,
"uncompressed": 27.99
},
"xxl": {
"res": "xxl",
"format": "jpg",
"width": 4368,
"height": 2912,
"output_width": 14.56,
"output_height": 9.71,
"output_unit": "inch",
"dpi": 300,
"uncompressed": 36.39
},
"tiff": {
"res": "tiff",
"format": "tiff",
"width": 5460,
"height": 3640,
"output_width": 18.2,
"output_height": 12.13,
"output_unit": "inch",
"dpi": 300,
"uncompressed": 56.86
}
},
"editorial": false,
"thumbnail": "http://images.assetsdelivery.com/compings_v2/urgent/urgent1312/urgent131200006.jpg"
}
{
"id": "1027927891",
"description": "Man relaxing on the hammock in a beautiful day. Slow motion",
"keywords": {
"1": "background",
"2": "backyard",
"3": "bed",
"4": "canine",
"5": "comfortable",
"6": "domestic",
"7": "enjoy",
"8": "enjoyment",
"9": "feet",
"10": "foot",
"11": "funny",
"12": "garden",
"13": "green",
"14": "hammock",
"15": "happy",
"16": "holiday",
"17": "idyllic",
"18": "laziness",
"19": "lazy",
"20": "leg",
"21": "leisure",
"22": "loneliness",
"23": "lying",
"24": "male",
"25": "man",
"26": "nature",
"27": "outdoors",
"28": "paradise",
"29": "people",
"30": "person",
"31": "relax",
"32": "relaxation",
"33": "relaxing",
"34": "resort",
"35": "rest",
"36": "resting",
"37": "rope",
"38": "serene",
"39": "sleep",
"40": "sleeping",
"41": "slow",
"42": "solitude",
"43": "summer",
"44": "swing",
"45": "tourist",
"46": "travel",
"47": "tree",
"48": "tropical",
"49": "vacation",
"50": "white"
},
"file_name": "zefart140401645",
"folder": "zefart1404",
"media_type": "footage",
"contributor": {
"id": "zefart",
"realname": "-",
"location": "-",
"datejoined": "2012-09-20"
},
"release": {
"model": false,
"property": false
},
"orientation": "horizontal",
"sizes": {
"1080": {
"width": 1920,
"height": 1080,
"file_size": "277.32 MB",
"format": "mov"
}
},
"editorial": false,
"frame_rate": 29.97,
"duration": 31532,
"preview": "http://vidcdn.123rf.com/preview/zefart/zefart1404/zefart140401645.mp4"
}
{
"id": "111542017",
"thumbnail": "http://images.stockunlimited.net/illustration/business-infographic_1542017.png",
"description": "business infographic",
"keywords": {
"1": "avatar",
"2": "avatars",
"3": "business",
"4": "businesses",
"5": "clock",
"6": "clocks",
"7": "data",
"8": "datum",
"9": "design",
"10": "designs",
"11": "electronic",
"12": "electronics",
"13": "element",
"14": "elements",
"15": "envelope",
"16": "envelopes",
"17": "gadget",
"18": "gadgets",
"19": "info",
"20": "infographic",
"21": "infographics",
"22": "information",
"23": "infos",
"24": "layout",
"25": "mail",
"26": "mails",
"27": "message",
"28": "messages",
"29": "office",
"30": "offices",
"31": "smartphone",
"32": "smartphones",
"33": "technologies",
"34": "technology",
"35": "template",
"36": "templates",
"37": "time",
"38": "timepiece",
"39": "visualization",
"40": "visualize",
"41": "wifi",
"42": "wireless"
},
"file_type": "illustration",
"orientation": "horizontal",
"width": "3508",
"height": "2480",
"editorial": false,
"sizes": {
"eps": {
"res": "eps",
"format": "eps",
"filesize": "8343614"
},
"svg": {
"res": "svg",
"format": "svg",
"filesize": "1320930"
},
"png": {
"res": "png",
"format": "png",
"filesize": "1021633"
},
"jpg": {
"res": "jpg",
"format": "jpg",
"filesize": "162183"
}
}
}
{
"id": "13127236130",
"description": "Cute woman in a blossoming sunflower field",
"keywords": {
"1": "beautiful",
"2": "bloom",
"3": "carefree",
"4": "fashionable",
"5": "field",
"6": "flower",
"7": "fun",
"8": "girl",
"9": "happiness",
"10": "rural",
"11": "she",
"12": "smile",
"13": "summer",
"14": "sunflower",
"15": "ukraine",
"16": "woman",
"17": "yellow"
},
"file_name": "titovstudio190700058",
"folder": "titovstudio1907",
"media_type": "image",
"contributor": {
"id": "titovstudio",
"realname": "Dmytro Titov",
"location": "UA",
"datejoined": "2011-11-30 00:00:00"
},
"release": {
"model": true,
"property": false
},
"orientation": "horizontal",
"sizes": {
"format": "jpg",
"width": 869,
"height": 551,
"output_width": 12.07,
"output_height": 7.65,
"output_unit": "inch",
"dpi": 72,
"uncompressed": 1.37
},
"editorial": false,
"thumbnail": "https://images.assetsdelivery.com/compings_v2/titovstudio/titovstudio1907/titovstudio190700058.jpg"
}
{
"id": "14126866067",
"description": "Young man with a mobile phone",
"keywords": {
"1": "apartment",
"2": "building",
"3": "casual",
"4": "chinese",
"5": "city",
"6": "day",
"7": "digital device",
"8": "happy",
"9": "low angle",
"10": "malay",
"11": "malaysian",
"12": "man",
"13": "message",
"14": "messaging",
"15": "mixed race",
"16": "mobile phone",
"17": "modern",
"18": "one person",
"19": "outdoors",
"20": "selective focus",
"21": "smartphone",
"22": "smile",
"23": "smiling",
"24": "technology",
"25": "text",
"26": "texting",
"27": "urban",
"28": "young adult",
"29": "young man"
},
"file_name": "imagehitasia190700106",
"folder": "imagehitasia1907",
"media_type": "image",
"contributor": {
"id": "imagehitasia",
"realname": "-",
"location": "-",
"datejoined": "2011-12-20 00:00:00"
},
"release": {
"model": false,
"property": true
},
"orientation": "horizontal",
"sizes": {
"format": "jpg",
"width": 2508,
"height": 1672,
"output_width": 8.36,
"output_height": 5.57,
"output_unit": "inch",
"dpi": 300,
"uncompressed": 12
},
"editorial": false,
"thumbnail": "https://images.assetsdelivery.com/compings_v2/imagehitasia/imagehitasia1907/imagehitasia190700106.jpg"}
Error responses
Code | Description |
---|---|
1100 | Invalid API Key Please ensure input value is valid. |
1300 | Invalid input Please ensure input of Media's id is valid. |
1301 | Invalid source Please ensure input value is valid. |
1302 | File not found Please ensure input value(s) is valid. |
Sample error response
{
"error_code": "1302",
"error_message": "File not found"
}