+1 (888) 674-2299

31,633,386 Royalty Free Stock Photos

How to use the Fotolia API

Method: search/getSeasonalGalleries

This methods returns public galleries for a defined language

Authentication

This method does not require authentication.

HTTP method

This method is called with HTTP method GET.

Arguments

Argument Type Valid Values Default Value Detail
language_id Int
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 11
  • 12
  • 13
  • 14
  • 15
2
  • French
  • English US
  • English UK
  • German
  • Spanish
  • Italian
  • Portuguese PT
  • Portuguese BR
  • Japanese
  • Polish
  • Russian
  • Chinese
  • Turkish
  • Korea
thumbnail_size Int
  • 110
  • 160
  • 400
110
  • Small (110px)
  • Medium (160px)
  • Large (400px - watermarked)
theme_id Int   110  

Returned Values

Element (path) Name Type Description
/[n]/ id int theme ID
/[n]/ theme_url string theme URL
/[n]/ name string theme name
/[n]/ thumbnail_url string theme thumbnail URL
/[n]/ thumbnail_img string them thumbnail html img tag
/[n]/galleries/[n]/ nb_media int number of files available in this gallery
/[n]/galleries/[n]/ id string gallery unique ID
/[n]/galleries/[n]/ name string name of the gallery
/[n]/galleries/[n]/ thumbnail_html_tag string gallery thumbnail html tag
/[n]/galleries/[n]/ thumbnail_url string gallery thumbnail URL
/[n]/galleries/[n]/ thumbnail_width string gallery thumbnail width (px)
/[n]/galleries/[n]/ thumbnail_height string gallery thumbnail height (px)

Example Query

GET http://API_KEY@api.fotolia.com/Rest/1/search/getSeasonalGalleries?language_id=2

Example Response

[
     {
         "theme_id":2,
         "name":"Carnival",
         "thumbnail_url":"http:\/\/s.ftcdn.net\/v2010\/pics\/all\/page\/SeasonalTheme\/y1ttn5XdMKmBYhOOOWNjlycun7mCxgdl.jpg",
         "thumbnail_img":"\"Carnival\"",
         "galleries":
         [
             {
                "nb_media":101,
                "id":"Ni21V7Ts1ELnh1KOASnJK4hHCXb3Wx2j",
                "name":"[Season: Carnival]: Children",
                "thumbnail_html_tag":"\"fashion",
                "thumbnail_url":"http:\/\/t2.ftcdn.net\/jpg\/00\/26\/12\/57\/110_F_26125725_zJsK08U5B9J8V9vEtIEOFPNeuNAQWXzL.jpg",
                "thumbnail_width":110,
                "thumbnail_height":73
             },
             {
                "nb_media":124,
                "id":"WvasttakymNWeYkeqNn1HL8KiZE4N7ej",
                "name":"[Season: Carnival]: Costumes",
                "thumbnail_html_tag":"\"Le",
                "thumbnail_url":"http:\/\/t2.ftcdn.net\/jpg\/00\/08\/07\/81\/110_F_8078128_ymoTEe8iXlQ9lllfsXNR9IMxCPD3lDRZ.jpg",
                "thumbnail_width":110,
                "thumbnail_height":73
             }
         ]
      },
      {
         "theme_id":5,
         "name":"Earth",
         "thumbnail_url":"http:\/\/s.ftcdn.net\/v2010\/pics\/all\/page\/SeasonalTheme\/wIUFdsQ6bsDuqD9Xgwl32BJ3pDVBOnTB.jpg",
         "thumbnail_img":"\"Earth\"",
         "galleries":
         [
             {
                "nb_media":91,
                "id":"AnHpWJIqY7fCXyWBvhw4rrlQrMCoSYUT",
                "name":"[Season: Earth]: Ecology and Nature",
                "thumbnail_html_tag":"\"new",
                "thumbnail_url":"http:\/\/t1.ftcdn.net\/jpg\/00\/04\/17\/24\/110_F_4172417_CFy34BDjJIZBQFGX8ymF5BHPpRM0atxd.jpg",
                "thumbnail_width":110,
                "thumbnail_height":75
             },
             {
                "nb_media":101,
                "id":"Cb8YlHE9FkBdZYeK6QFn8q3q25VLUpfW",
                "name":"[Season: Earth]: Planet Earth",
                "thumbnail_html_tag":"\"eye",
                "thumbnail_url":"http:\/\/t2.ftcdn.net\/jpg\/00\/03\/97\/77\/110_F_3977748_aKrewHgNO165gxzrO0xNOiHtQ2vDtHaJ.jpg",
                "thumbnail_width":110,
                "thumbnail_height":73
             }
         ]
     },
]

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.
2001: Invalid Language ID
The language ID passed is not valid or doesn't exist in the fotolia available language list.