+1 (888) 674-2299

29,671,968 Royalty Free Stock Photos

How to use the Fotolia API

Method: user/getLastOnlineContents

This method return last online files for the current user

Authentication

This method requires authentication.

HTTP method

This method is called with HTTP method GET.

Arguments

Argument Type Element (array) Valid Values Default Value Detail
offset Int 0 any integer value
limit Int any integer between 1 and 100 50
from_date string date as of 7 days ago any valid date following YYYY-MM-DD format
to_date string any valid date following YYYY-MM-DD format
thumbnail_size int
  • 110
  • 160
  • 400
  • Medium (110px)
  • big (160px)
  • Large (400px - watermarked)
language_id Int
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 11
  • 12
  • 13
  • 14
  • 15
  • 22
  • 23
2
  • French
  • American
  • English
  • German
  • Spanish
  • Italian
  • Portuguese
  • Brazilian
  • Japanese
  • Polish
  • Russian
  • Chinese
  • Turkish
  • Korean
  • Dutch
  • Swedish

Returned Values

Element (path) Name Type Description
/id/ id int media unique ID
/id/ title string media title (orginal name)
/id/ creator_name string media creator name
/id/ creator_id int media creator id
/id/ media_type_id int media type :
  • 1 : photo
  • 2 : illustration
  • 3 : vector
/id/ thumbnail_url string media thumbnail url
/id/ thumbnail_width int media thumbnail width
/id/ thumbnail_height int media thumbnail_height
/id/ thumbnail_html_tag string media thumbnail html source code
/id/ country_id int media country ID
/id/ country_name string media unique name
/id/ nb_views int media views number
/id/ nb_downloads int media downloads number
/id/keywords/[n]/ name string media keywords (ranked by pertinence)
/id/licenses/ name string media license name
/id/licenses/ price int media license price (credit)
/id/licenses_details/ name string media license name
/id/licenses_details/name/ width int media license width
/id/licenses_details/name/ height int media license height
/id/licenses_details/name/ dpi int media license resolution (dpi)
/id/licenses_details/phrase/ phrase string media license format description
/id/cat1/ id int media representative category ID
/id/cat1/ name string media representative category name
/id/cat2/ id int media conceptual category ID
/id/cat2/ name string media conceptual category name
/id/cat1_hierarchy/[n]/ id int media representative category ID (n depends on hierarchy level)
/id/cat1_hierarchy/[n]/ name string media representative category name (n depends on hierarchy level)
/id/cat2_hierarchy/[n]/ id int media conceptual category ID (n depends on hierarchy level)
/id/cat2_hierarchy/[n]/ name string media conceptual category name (n depends on hierarchy level)

Example Query

GET http://API_KEY@api.fotolia.com/Rest/1/user/getLastOnlineContents?offset=200&limit=75

Example Response


    [
    "20": {
    	"id":20,
    	"title":"insecte sans issue",
    	"creator_name":"Guy Turro",
    	"creator_id":18,
    	"media_type_id":1,
    	"thumbnail_url":"http:\/\/static-p1.fotolia.com\/jpg\/00\/00\/00\/00\/400_F_20_xSvckxpOlCJSU4hLrMyJTnhBbXX3Jt.jpg",
    	"thumbnail_width":400,
    	"thumbnail_height":294,
    	"thumbnail_html_tag":"",
    	"country_id":756,
    	"country_name":"Switzerland",
    	"nb_views":845,
    	"nb_downloads":1,
    	"keywords":[
    		{
    			"name":"insect"
    		},
    		{
    			"name":"macro"
    		},
    		{
    			"name":"celebrity"
    		}
    	],
    	"licenses":[
    		{
    			"name":"M",
    			"price":5
    		}
    	],
    	"licenses_details":{
    		"M":{
    			"ratio":1.245663,
    			"width":1606,
    			"height":1183,
    			"dpi":72,
    			"phrase":"1606 x 1183 (1,8 MP), 22,3 '' x 16,4 '' @72 dpi"
    		}
    	},
    	"cat1":{
    		"id":4001008,
    		"name":"Insect"
    	},
    	"cat1_hierarchy":[
    		{
    			"id":4000000,
    			"name":"Fauna & Flora"
    		},
    		{
    			"id":4001000,
    			"name":"Animal"
    		},
    		{
    			"id":4001008,
    			"name":"Insect"
    		}
    	]
    },
    "35290674": { 
        "id":35290674,
        "title":"Christmas gifts shopping girl thinking looking up",
        "creator_name":"Maridav",
        "creator_id":200914328,
        "creation_date":"2011-09-12 11:00:10.483986",
        "media_type_id":1,
        "thumbnail_url":"http:\/\/t1.ftcdn.net\/jpg\/00\/35\/29\/06\/110_F_35290674_Wo66ZYf66BsDv6ZYhFt87mMa02IzQ8Pm.jpg",
        "thumbnail_width":83,
        "thumbnail_height":110,
        "thumbnail_html_tag":"<img src=\"http:\/\/t1.ftcdn.net\/jpg\/00\/35\/29\/06\/110_F_35290674_Wo66ZYf66BsDv6ZYhFt87mMa02IzQ8Pm.jpg\" alt=\"Christmas gifts shopping girl thinking looking up\" title=\"Christmas gifts shopping girl thinking looking up\" width=\"83\" height=\"110\" \/>",
        "flv_url":null,
        "country_id":124,
        "nb_views":451,
        "nb_downloads":177,
        "country_name":"Canada",
        "width":3576,
        "height":4768,
        "licenses":[
            {
                "name":"XS",
                "price":1
            },
            {
                "name":"S",
                "price":3
            }
        ],
        "cat1":
            {
                "id":3001002,
                "name":"Woman"
            },
        "licenses_details":
            {
                "XS":{
                    "dpi":72,
                    "license_name":"XS",
                    "ratio":11.92,
                    "width":300,
                    "height":400,
                    "dimensions":"300 x 400 (0.1 MP)",
                    "dimensions_local":"4.2 '' x 5.6 '' (72 dpi)",
                    "phrase":"300 x 400 (0.1 MP), 4.2 '' x 5.6 '' (72
                    dpi)"
                },
                "S":{
                    "dpi":72,
                    "license_name":"S",
                    "ratio":5.96,
                    "width":600,
                    "height":800,
                    "dimensions":"600 x 800 (0.1 MP)",
                    "dimensions_local":"8.3 '' x 11.1 '' (72 dpi)",
                    "phrase":"600 x 800 (0.5 MP), 8.3 '' x 11.1 '' (72 dpi)"
                }
            },
        "keywords":[
             {
                 "name":"christmas"
             },
             {
                 "name":"gifts"
             }
        ],
        "cat1_hierarchy":[
            {
                "id":3000000,
                "name":"People"
            },
            {
                "id":3001000,
                "name":"In Studio"
            }
        ]
    }
}
    ]

Error Codes

001: Service currently unavailable
The requested service is temporarily unavailable.
002: Failed to parse request
The request could not be parsed.
010: Missing API Key
The API key passed is missing.
011: Invalid API Key
The API key passed is not valid or has expired.
031: Invalid Method
This method does not exist in the method list.
032: Method not Available
This method is not available for this API Key.
2101: Invalid Thumbnail Size
The thumbnail size passed is not valid or doesn't exist in the fotolia available thumbnail size list.
6003: Invalid Date Format
Invalid date format or invalid date