{"__v":0,"_id":"55abd50ea36ccd0d00fdebdb","category":{"__v":21,"_id":"55a7aee94a33f92b00b7a154","pages":["55a7aee94a33f92b00b7a156","55a7ea403efe0c2f0074cb75","55a80eb23ec2ec0d00bd66ea","55a811fc6e61e619004f703e","55a8c513cf45e1390093f18c","55a8d9fa27a17d210052516d","55a8f048cf45e1390093f248","55aba4ba63a6b60d006616e1","55abab0a0685ce0d0049fb8d","55abb04da36ccd0d00fdebc1","55abc1cc63a6b60d006616f4","55abcdbd63a6b60d006616fa","55abd36763a6b60d00661700","55abd50ea36ccd0d00fdebdb","55abd8c3a36ccd0d00fdebdf","55abd9cc0685ce0d0049fbb5","55abdb6b63a6b60d00661706","55abdc9b0685ce0d0049fbb8","55c1f5fca131980d005be95b","55fac407bc972f0d0005f644","569f68e766a5640d00efa52d"],"project":"55a7aee84a33f92b00b7a150","version":"55a7aee84a33f92b00b7a153","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-16T13:17:29.102Z","from_sync":false,"order":2,"slug":"endpoints","title":"Endpoints"},"editedParams":true,"editedParams2":true,"parentDoc":null,"project":"55a7aee84a33f92b00b7a150","user":"55a7ae50bf1be93100d89df1","version":{"__v":6,"_id":"55a7aee84a33f92b00b7a153","project":"55a7aee84a33f92b00b7a150","createdAt":"2015-07-16T13:17:28.411Z","releaseDate":"2015-07-16T13:17:28.411Z","categories":["55a7aee94a33f92b00b7a154","55a7fefa3efe0c2f0074cbdf","55a8fb10c8bd450d000dd130","55a936b1cf45e1390093f362","55abddeaa36ccd0d00fdebe1","5624db675a86b423009462e1"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-07-19T16:49:18.640Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"curl https://api.aylien.com/api/v1/image-tags \\\n   -H \"X-AYLIEN-TextAPI-Application-Key: [[app:key]]\" \\\n   -H \"X-AYLIEN-TextAPI-Application-ID: [[app:id]]\" \\\n   -d url=\"https://c1.staticflickr.com/5/4112/5170590074_714d36db83_b.jpg\"","language":"curl"},{"code":"textapi.imageTags({\n  url: 'https://c1.staticflickr.com/5/4112/5170590074_714d36db83_b.jpg'\n}, function(error, response) {\n  if (error === null) {\n    console.log(response.tags);\n  }\n});","language":"javascript"},{"code":"url = \"https://c1.staticflickr.com/5/4112/5170590074_714d36db83_b.jpg\"\nimageTags = client.ImageTags({\"url\": url})\nfor tag in imageTags['tags']:\n  print tag","language":"python"},{"code":"<?php\n$url = 'https://c1.staticflickr.com/5/4112/5170590074_714d36db83_b.jpg';\n$imageTags = $textapi->ImageTags(array('url' => $url));\nvar_dump($imageTags->tags);\n?>","language":"php"},{"code":"ImageTagsParams.Builder builder = ImageTagsParams.newBuilder();\njava.net.URL url = new java.net.URL(\"https://c1.staticflickr.com/5/4112/5170590074_714d36db83_b.jpg\");\nbuilder.setUrl(url);\nImageTags imageTags = client.imageTags(builder.build());\nfor (ImageTag tag: imageTags.getTags()) {\n\t\tSystem.out.println(tag.getName() + \" (\" + tag.getConfidence() + \")\");\n}","language":"java"},{"code":"url = \"https://c1.staticflickr.com/5/4112/5170590074_714d36db83_b.jpg\"\n\nimage_tags = client.image_tags(url: url)\n\nimage_tags[:tags].each do |tag|\n  puts tag\nend","language":"ruby"},{"code":"url := \"https://c1.staticflickr.com/5/4112/5170590074_714d36db83_b.jpg\"\nimageTagsParams := &textapi.ImageTagsParams{URL: url}\nimageTags, err := client.ImageTags(imageTagsParams)\nif err != nil {\n\t\tpanic(err)\n}\nfor _, t := range imageTags.Tags {\n\t\tfmt.Printf(\"%s: %f\\n\", t.Tag, t.Confidence)\n}","language":"go"},{"code":"string url = \"https://c1.staticflickr.com/5/4112/5170590074_714d36db83_b.jpg\";\n\nvar imageTags = client.ImageTags(url: url);\n\nforeach (var tag in imageTags.Tags)\n{\n  Console.WriteLine(tag.name);\n}","language":"csharp"}]},"method":"get","results":{"codes":[{"status":200,"language":"json","code":"{\n  \"image-tags\":{\n    \"image\":\"https://c1.staticflickr.com/5/4112/5170590074_714d36db83_b.jpg\",\n    \"tags\":[\n      {\n        \"tag\":\"retriever\",\n        \"confidence\":1\n      },\n      {\n        \"tag\":\"dog\",\n        \"confidence\":0.5238458474035048\n      },\n      {\n        \"tag\":\"puppy\",\n        \"confidence\":0.491276660821357\n      },\n      {\n        \"tag\":\"golden retriever\",\n        \"confidence\":0.45781040296243847\n      },\n      {\n        \"tag\":\"sporting dog\",\n        \"confidence\":0.3530136438969765\n      },\n      {\n        \"tag\":\"pet\",\n        \"confidence\":0.3424180096828097\n      },\n      {\n        \"tag\":\"animal\",\n        \"confidence\":0.3275342905609307\n      },\n      {\n        \"tag\":\"canine\",\n        \"confidence\":0.32542232693250833\n      },\n      {\n        \"tag\":\"hunting dog\",\n        \"confidence\":0.2352370599209015\n      },\n      {\n        \"tag\":\"domestic\",\n        \"confidence\":0.23093645875753763\n      },\n      {\n        \"tag\":\"cute\",\n        \"confidence\":0.2301391739973289\n      },\n      {\n        \"tag\":\"mammal\",\n        \"confidence\":0.21657780405730664\n      },\n      {\n        \"tag\":\"breed\",\n        \"confidence\":0.21163459710684665\n      },\n      {\n        \"tag\":\"purebred\",\n        \"confidence\":0.20249160453182505\n      },\n      {\n        \"tag\":\"studio\",\n        \"confidence\":0.20216780563244377\n      },\n      {\n        \"tag\":\"portrait\",\n        \"confidence\":0.18600926331322554\n      },\n      {\n        \"tag\":\"pedigree\",\n        \"confidence\":0.17719667584138027\n      },\n      {\n        \"tag\":\"labrador retriever\",\n        \"confidence\":0.16258786114221727\n      },\n      {\n        \"tag\":\"adorable\",\n        \"confidence\":0.16169756228905477\n      },\n      {\n        \"tag\":\"sitting\",\n        \"confidence\":0.15313338933195716\n      },\n      {\n        \"tag\":\"looking\",\n        \"confidence\":0.13775000432919968\n      },\n      {\n        \"tag\":\"friend\",\n        \"confidence\":0.13089530857102546\n      },\n      {\n        \"tag\":\"labrador\",\n        \"confidence\":0.12107924743272552\n      },\n      {\n        \"tag\":\"golden\",\n        \"confidence\":0.11614024021375728\n      },\n      {\n        \"tag\":\"fur\",\n        \"confidence\":0.11585503733985654\n      },\n      {\n        \"tag\":\"doggy\",\n        \"confidence\":0.11374004465350197\n      },\n      {\n        \"tag\":\"pets\",\n        \"confidence\":0.11138761245234406\n      },\n      {\n        \"tag\":\"pedigreed\",\n        \"confidence\":0.1092708183645368\n      },\n      {\n        \"tag\":\"happy\",\n        \"confidence\":0.10270134453447863\n      },\n      {\n        \"tag\":\"dogs\",\n        \"confidence\":0.09538712413124423\n      },\n      {\n        \"tag\":\"brown\",\n        \"confidence\":0.09500553402412462\n      },\n      {\n        \"tag\":\"obedient\",\n        \"confidence\":0.09488980642236614\n      },\n      {\n        \"tag\":\"pup\",\n        \"confidence\":0.09138146069099179\n      },\n      {\n        \"tag\":\"face\",\n        \"confidence\":0.08523292846225221\n      },\n      {\n        \"tag\":\"fun\",\n        \"confidence\":0.08438423283034363\n      },\n      {\n        \"tag\":\"friendship\",\n        \"confidence\":0.0809029253040725\n      },\n      {\n        \"tag\":\"tongue\",\n        \"confidence\":0.07836080610069839\n      },\n      {\n        \"tag\":\"lying\",\n        \"confidence\":0.07778642595433763\n      },\n      {\n        \"tag\":\"cut out\",\n        \"confidence\":0.07546393385187228\n      },\n      {\n        \"tag\":\"look\",\n        \"confidence\":0.07484668017614332\n      },\n      {\n        \"tag\":\"outdoors\",\n        \"confidence\":0.07137406714099012\n      },\n      {\n        \"tag\":\"training\",\n        \"confidence\":0.07099472086236791\n      }\n    ]\n  }\n}","name":""}]},"settings":"","auth":"required","params":[{"_id":"55a8f048cf45e1390093f249","ref":"","in":"query","required":false,"desc":"URL of the image","default":"","type":"string","name":"url"}],"url":"/image-tags"},"isReference":false,"order":8,"body":"The **Image Tagging** endpoint identifies common shapes, objects and concepts in an image and returns them as a list of tags along with a confidence score which indicates how confident the system is about the assignment.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"Image Tagging is a premium feature, meaning it's only available to our paid users at the moment. If you would like to trial it please [drop us a line](mailto:support:::at:::aylien.com).\",\n  \"title\": \"Premium feature\"\n}\n[/block]","excerpt":"/image-tags","slug":"image-tags","type":"endpoint","title":"Image Tagging"}

getImage Tagging

/image-tags

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

url:
string
URL of the image

Examples


Result Format


Documentation

The **Image Tagging** endpoint identifies common shapes, objects and concepts in an image and returns them as a list of tags along with a confidence score which indicates how confident the system is about the assignment. [block:callout] { "type": "success", "body": "Image Tagging is a premium feature, meaning it's only available to our paid users at the moment. If you would like to trial it please [drop us a line](mailto:support@aylien.com).", "title": "Premium feature" } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}