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:
  • jp
  • es
  • fr
  • ru
  • de
  • kr

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"
}