Media search
This API will get media search results based on keywords
GET https://www.123rfapis.com/?method=search&keyword=
Parameters
Field | Type | Description |
---|---|---|
api_key | string | API Key Value cannot be left empty |
keyword | string | Keyword usage for search "Value(s) can contain alphanumeric Separate multiple keywords by comma ' , ' (e.g: &keyword=bicycle,skateboard) Value cannot be left empty" |
itemsperpage | int | To display how many item(s) per page Default value will be 100 Value accepted from 1 to 100 |
itemsperpage_su | int | To display how many item(s) per page Default value will be 100 Value accepted from 1 to 100 |
itemsperpage_free | int | To display how many item(s) per page Default value will be 100 Value accepted from 1 to 100 |
page | int | Page / Paging of the results Default value will be 1 Value accepted from 1 to 10000 |
orderby | int | Sorting result according to relevance of keyword(s), newest or popularity Default value will be 1 1 = Relevance 2 = Newest 3 = Popularity |
media_type | int | "Filter search by media type Media from source 123RF, Stockunlimited, Stockunlimited Free images Footage from source 123RF" Default value will be 1 1 = Images 2 = Footage |
media_type | int | "Filter search by media type Media from source 123RF PLUS Default value will be 1 1 = Images |
media_type | int | "Filter search by media type Media from source 123RF FREE Default value will be 1 1 = Images |
orientation | int | Filter search by orientation Default value will be all orientation 1 = Horizontal 2 = Portrait 3 = Square 4 = Panorama |
color | int | Filter search by color Default value will be all color Value accepted from 1 to 39 |
size_footage | string | Filter search footage by size Default value will be all sizes Separate multiple values by comma ' , ' (e.g.: &size_footage=720,1080) Value options: 720, 1080, 4000 |
fps_footage | int | Filter search for footage by frame per second (FPS) Default value will be all FPS Value options: 24, 25, 30, 60, and 100 |
source | string | Filter search by source (123RF, Stockunlimited, Free images) "Default value is all sources Value options: 123rf , su , free Separate multiple values by comma ' , ' (e.g.: &source=123rf,su)" |
source | string | Filter search by source (123RF PLUS) Value options: plus |
source | string | Filter search by source (123RF FREE) Value options: 123rffree |
filetype | filetype | Filter search by file type Default value will be all filetype Value options: 1 = Photo 2 = Vector |
style | style | Filter search by image styles Default value will be all styles Value options for Photos: 1 = Authentic 2 = Abstract 3 = Macro/Close Up 4 = Object Value options for Vectors: 5 = Watercolor 6 = Flat 7 = Cartoon 8 = Geometric 9 = Gradient 10 = Isometric 11 = 3D 12 = Hand-drawn |
mood | mood | Filter search by mood (Only applicable to Photos) Default value will be all Value options: 1 = Natural 2 = Warm 3 = Dramatic 4 = Vivid and Bold 5 = Black and White |
ethnicity | ethnicity | Filter search by ethnicity (Only applicable to Photos) Default value will be all Value options: 1 = Caucasian 2 = African American 3 = Asian |
num_ppl | num_ppl | Filter search by number of people (Only applicable to Photos) Default value will be all Value options: 0 = Without People 1 = 1 Person 2 = 2 People 3 = 3 People 4 = More than 4 people |
safe_search | int | Filter search by safe search Default value of safe search is 1 1 = on 0 = off |
exclude | string | Remove content with keyword(s) indicated "Value(s) can contain alphanumeric Separate multiple keywords by comma ' , ' (e.g: &exclude=bicycle,skateboard)" |
usage | int | Filter search by type of media's usage Default value will be all usage Value options: 1 = RF commercial 2 = RF editorial |
hideeditorial | int | Filter search by media editorial Default value is display editorial Value accepted will be 1 , to exclude all editorial |
no_ai | int | Filter search by AI-generated content Default value is display AI-generated content Value accepted will be 1 , to exclude all AI-generated content |
app | int | Required field for search result to return width & height info. 0 = Disabled 1 = Enabled |
lang | string | Language option for foreign keyword search Translation available for keyword in:
|
Responses
Field | Type | Description |
---|---|---|
file_type | object | Object of search results based on the filetype |
source | object | Object of search results based on the source |
page | int | Page number |
pages | int | Total page number |
perpage | int | Total result per page |
total | int | Total result |
media | object | Object of results |
id | int | Media's ID |
link_image | int | Media thumbnail |
description | int | Media description |
width | int | *Requred field "app" to be enabled *Only return in Images search ( media_type=1 ) Images width |
height | int | *Requred field "app" to be enabled *Only return in Images search ( media_type=1 ) Images height |
file_name | int | Media File Name |
media_type | int | Media Type |
Response Codes
Code | Description |
---|---|
200 | OK |
400 | Bad request |
Sample Request
GET http://www.123rfapis.com/?method=search&keyword=baby
GET http://www.123rfapis.com/?method=search&keyword=baby&media_type=2
Sample Responses
[
{
"images": {
"123RF": {
"page": 1,
"pages": 10000,
"perpage": "5",
"total": 1311002,
"image": [
{
"id": "1047381298",
"link_image": "https://us-cdn4.123rf.com/168nwm/lemuana/lemuana1403/lemuana140300027/47381298-newborn-baby-girl-asleep-on-a-blanket.jpg",
"description": "Newborn baby girl asleep on a blanket."
},
{
"id": "1046810988",
"link_image": "https://us-cdn2.123rf.com/168nwm/oksun70/oksun701510/oksun70151000133/46810988-cute-little-baby-girl-looking-into-the-camera-and-weared-in-white-hat.jpg",
"description": "Cute little baby girl looking into the camera and weared in white hat."
},
{
"id": "1051236159",
"link_image": "https://us-cdn1.123rf.com/168nwm/evgenyatamanenko/evgenyatamanenko1601/evgenyatamanenko160100282/51236159-cute-newborn-baby-sleeps-with-a-toy-teddy-bear-white.jpg",
"description": "Cute newborn baby sleeps with a toy teddy bear white"
},
{
"id": "1048716721",
"link_image": "https://us-cdn3.123rf.com/168nwm/graphicbee/graphicbee1511/graphicbee151100148/48716721-little-baby-boy-and-baby-girl-adorable-babies-with-pacifiers-and-thinking-bubbles.jpg",
"description": "Little baby boy and baby girl. Adorable babies with pacifiers and thinking bubbles."
},
{
"id": "1048829812",
"link_image": "https://us-cdn2.123rf.com/168nwm/famveldman/famveldman1511/famveldman151100146/48829812-adorable-baby-boy-in-white-sunny-bedroom-newborn-child-relaxing-in-bed-nursery-for-young-children-te.jpg",
"description": "Adorable baby boy in white sunny bedroom. Newborn child relaxing in bed. Nursery for young children. Textile and bedding for kids. Family morning at home. New born kid during tummy time with toy bear."
}
]
},
"stockunlimited": {
"page": 1,
"pages": 174,
"perpage": "5",
"total": 3478,
"image": [
{
"id": "111675190",
"link_image": "https://images.cdn4.stockunlimited.net/thumb/baby-boy-smiling-while-clapping-his-hands_1675190.jpg",
"description": "baby boy smiling while clapping his hands"
},
{
"id": "111706763",
"link_image": "https://images.cdn1.stockunlimited.net/thumb/baby-girl-wrapped-in-a-towel_1706763.jpg",
"description": "baby girl wrapped in a towel"
},
{
"id": "111527253",
"link_image": "https://images.cdn3.stockunlimited.net/clipart/baby-shower-card_1527253.jpg",
"description": "baby shower card"
},
{
"id": "111526536",
"link_image": "https://images.cdn2.stockunlimited.net/clipart/baby-animals_1526536.jpg",
"description": "baby animals"
},
{
"id": "111679077",
"link_image": "https://images.cdn3.stockunlimited.net/thumb/mother-and-daughter-playing-with-soap-bubbles_1679077.jpg",
"description": "mother and daughter playing with soap bubbles"
}
]
},
"freeimages": {
"page": 1,
"pages": 83,
"perpage": "5",
"total": 1658,
"image": [
{
"id": "121290806",
"link_image": "https://images.cdn4.stockunlimited.net/clipart/baby-animals_1290806.jpg",
"description": "baby animals"
},
{
"id": "121244719",
"link_image": "https://images.cdn1.stockunlimited.net/clipart/collection-of-baby-activities_1244719.jpg",
"description": "collection of baby activities"
},
{
"id": "121243711",
"link_image": "https://images.cdn1.stockunlimited.net/clipart/parent-holding-a-child-logo_1243711.jpg",
"description": "parent holding a child logo"
},
{
"id": "121243159",
"link_image": "https://images.cdn1.stockunlimited.net/clipart/a-toy-car_1243159.jpg",
"description": "a toy car"
},
{
"id": "121292253",
"link_image": "https://images.cdn3.stockunlimited.net/clipart/lion_1292253.jpg",
"description": "lion"
}
]
}
}
}
]
[
{
"images": {
"123RF_PLUS": {
"page": 1,
"pages": 10000,
"perpage": "100",
"total": 1379482,
"image": [
{
"id": "13124983610",
"link_image": "https://images.assetsdelivery.com/compings_v2/yacobchuk/yacobchuk1905/yacobchuk190502905.jpg",
"description": "Here I am. Cheerful female keeping smile on her face while drinking tea on the terrace"
},
{
"id": "13125213242",
"link_image": "https://images.assetsdelivery.com/compings_v2/saddako/saddako1906/saddako190600058.jpg",
"description": "Baby Raccoon walking side view isolated on white background"
},
{
"id": "13125550885",
"link_image": "https://images.assetsdelivery.com/compings_v2/seraxion/eraxion1906/eraxion190600709.jpg",
"description": "3d rendered illustration of twin fetuses - week 40"
},
{
"id": "13127797465",
"link_image": "https://images.assetsdelivery.com/compings_v2/tevion25/tevion251907/tevion25190700050.jpg",
"description": "an elephant with his child"
},
{
"id": "13125453782",
"link_image": "https://images.assetsdelivery.com/compings_v2/byrdyak/byrdyak1906/byrdyak190600153.jpg",
"description": "Brown bear cub playing on the summer field. Ursus arctos in grass with yellow flowers"
}
]
}
}
}
]
[
{
"images": {
"123RF_freeimages": {
"page": 1,
"pages": 48,
"perpage": "100",
"total": 4772,
"image": [
{
"id": "14189144017",
"link_image": "",
"description": ""
},
{
"id": "14188597812",
"link_image": "",
"description": ""
},
{
"id": "14185886760",
"link_image": "",
"description": ""
},
{
"id": "14189108966",
"link_image": "",
"description": ""
},
{
"id": "14189309002",
"link_image": "",
"description": ""
}
]
}
}
}
]
[
{
"footages": {
"123RF": {
"page": 1,
"pages": 1512,
"perpage": "5",
"total": 30235,
"footage": [
{
"id": "1050889068",
"link_image": "http://vidcdn.123rf.com/168nwm/ivz/ivz1512/ivz151200226/50889068-six-month-baby-girl.jpg",
"description": "Six month baby girl"
},
{
"id": "1044779109",
"link_image": "http://vidcdn.123rf.com/168nwm/jakerbreaker/jakerbreaker1508/jakerbreaker150803548/44779109-expensive-baby.jpg",
"description": "Expensive Baby"
},
{
"id": "1052283285",
"link_image": "http://vidcdn.123rf.com/168nwm/dtiberio/dtiberio1601/dtiberio160100616/52283285-baby-boy-with-lollipop.jpg",
"description": "Baby Boy With Lollipop"
},
{
"id": "1052283327",
"link_image": "http://vidcdn.123rf.com/168nwm/dtiberio/dtiberio1601/dtiberio160100728/52283327-baby-boy-avoids-lollipop.jpg",
"description": "Baby Boy Avoids Lollipop"
},
{
"id": "1044822633",
"link_image": "http://vidcdn.123rf.com/168nwm/aleksejplatonov/aleksejplatonov1509/aleksejplatonov150900010/44822633-mother-feeding-little-baby.jpg",
"description": "Mother Feeding Little Baby"
}
]
}
}
}
]
Error responses
Code | Description |
---|---|
1200 | Keyword not found Please ensure keyword input is valid word(s). |
1201 | Invalid 'itemperpage'input Please ensure input values for 'itemperpage' is numeric. |
1202 | Invalid 'page' input Please ensure input values for 'page' is numeric and range from 1 to 10000 |
1203 | Invalid 'orderby' input Please ensure input value is valid and numeric. |
1204 | Invalid 'media_type' input Please ensure input value is valid and numeric. |
1205 | Invalid 'orientation' input Please ensure input value is valid and numeric. |
1206 | Invalid 'color' input Please ensure input value is numeric. |
1207 | Invalid 'source' input Please ensure input value is valid. |
1208 | Invalid 'filetype' input Please ensure input value is valid and numeric. |
1209 | Invalid 'nudity' input Please ensure input value is valid and numeric. |
1210 | Invalid 'usage' input Please ensure input value is valid and numeric. |
1211 | Invalid 'size_footage' input Please ensure input value is valid and numeric. |
1212 | Invalid 'fps_footage' input Please ensure input value is valid and numeric. |
Sample error response
{
"error_code": "1200",
"error_message": "Keyword not found"
}