How to use the Fotolia API

Method: search/getSearchResults

• Authentication
• HTTP method
• Arguments
• Returned Values
• Example Query
• Example Response
• Error Codes

Authentication

This method does not require authentication.

HTTP method

This method is called with HTTP method GET.

Arguments

Returned Values

Example Query

GET http://API_KEY@api.fotolia.com/Rest/1/search/getSearchResults?search_parameters%5Bwords%5D=test&search_parameters%5Blanguage_id%5D=2&search_parameters%5Blimit%5D=2

Example Response

{
    "nb_results":459,
    "0":{
        "id":1384045,
        "title":"scientist with test tube radiant gradient bg",
        "creator_name":"Jose Gil",
        "creator_id":6537,
        "thumbnail_url":"http:\/\/static-p1.fotolia.com\/jpg\/00\/01\/38\/40\/110_F_1384045_waKUmRkPuVSQSK9T4lDNc5YvkqSp4x.jpg",
        "thumbnail_html_tag":"",
        "thumbnail_width":81,
        "thumbnail_height":110,
        "licences":[
            {
                "name":"M",
                "price":1
            },
            {
                "name":"L",
                "price":2
            },
            {
                "name":"X",
                "price":50
            }
        ]
    },
    "1":{
        "id":1247723,
        "title":"antique tube tester",
        "creator_name":"James Steidl",
        "creator_id":140159,
        "thumbnail_url":"http:\/\/static-p2.fotolia.com\/jpg\/00\/01\/24\/77\/110_F_1247723_MB9BPAu0TMbhI2UEUNCQKCRpvXdEyR.jpg",
        "thumbnail_html_tag":"",
        "thumbnail_width":74,
        "thumbnail_height":110,
        "licences":[
            {
                "name":"M",
                "price":1
            },
            {
                "name":"L",
                "price":2
            },
            {
                "name":"XL",
                "price":3
            },
            {
                "name":"X",
                "price":20
            }
        ]
    }
}

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.

2101: Invalid Thumbnail Size

The thumbnail size passed is not valid or doesn't exist in the fotolia available thumbnail size list.