Skip to main content

Requirements

What is needed​

To use the image detection API, the following are required:

  • Processing credits on the API subscription.
  • For logo detection, the list of logos
  • Domain URLs (required if you want to pass images as URL). If no domain URLs are provided, only the file upload method will be supported.

If you try to query on a URL which is not whitelisted​

For any of the 3 types of models, if the URL is not whitelisted on your account on Talkwalker side, the API will return error code 50 with the following details:

{
    "status_code": "50",
    "status_message": "Url is not approved for processing",
    "request": "GET /api/v2/detect/images/object?access_token=***&image_url=https://pouringmyartout.files.wordpress.com/2013/03/a-411.jpg",
    "result_error": {
        "data": [
            {
                "key": "param_url",
                "value": ["https://pouringmyartout.files.wordpress.com/2013/03/a-411.jpg"]
            }
        ]
    },
    "request_id": "#qz656h1pchsl#"
}

If you try to detect a logo which is not in your predefined list​

For logo detection, if you try to detect a logo with an ID which is not in the configured list, the API will return error code 45 with following details:

{
    "status_code": "45",
    "status_message": "Unknown image detection model",
    "request": "GET /api/v2/detect/images/logo?access_token=***&image_url=http://blog.car-n-cash.com/wp-content/uploads/2015/09/logos.jpg&detect=suzuki",
    "result_error": {
        "data": [
            {
                "key": "details",
                "value": ["Unauthorized query ids"]
            },
            {
                "key": "query_id",
                "value": ["suzuki"]
            }
        ]
    },
    "request_id": "#qz65f6rjqqe8#"
}