{"_id":"55abb04da36ccd0d00fdebc1","category":{"_id":"55a7aee94a33f92b00b7a154","__v":21,"project":"55a7aee84a33f92b00b7a150","version":"55a7aee84a33f92b00b7a153","pages":["55a7aee94a33f92b00b7a156","55a7ea403efe0c2f0074cb75","55a80eb23ec2ec0d00bd66ea","55a811fc6e61e619004f703e","55a8c513cf45e1390093f18c","55a8d9fa27a17d210052516d","55a8f048cf45e1390093f248","55aba4ba63a6b60d006616e1","55abab0a0685ce0d0049fb8d","55abb04da36ccd0d00fdebc1","55abc1cc63a6b60d006616f4","55abcdbd63a6b60d006616fa","55abd36763a6b60d00661700","55abd50ea36ccd0d00fdebdb","55abd8c3a36ccd0d00fdebdf","55abd9cc0685ce0d0049fbb5","55abdb6b63a6b60d00661706","55abdc9b0685ce0d0049fbb8","55c1f5fca131980d005be95b","55fac407bc972f0d0005f644","569f68e766a5640d00efa52d"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-16T13:17:29.102Z","from_sync":false,"order":2,"slug":"endpoints","title":"Endpoints"},"user":"55a7ae50bf1be93100d89df1","version":{"_id":"55a7aee84a33f92b00b7a153","__v":6,"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"},"__v":2,"parentDoc":null,"project":"55a7aee84a33f92b00b7a150","editedParams":true,"editedParams2":true,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-07-19T14:12:29.569Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"method":"get","results":{"codes":[{"name":"","code":"{\n  \"language\":\"en\",\n  \"categories\":[\n    {\n      \"label\":\"economy, business and finance - computing and information technology\",\n      \"code\":\"04003000\",\n      \"confidence\":1\n    }\n  ],\n  \"text\":\"When Microsoft announced its wrenching...\"\n}","language":"json","status":200}]},"settings":"","examples":{"codes":[{"language":"curl","code":"curl https://api.aylien.com/api/v1/classify \\\n   -H \"X-AYLIEN-TextAPI-Application-Key: [[app:key]]\" \\\n   -H \"X-AYLIEN-TextAPI-Application-ID: [[app:id]]\" \\\n   -d url\"=http://techcrunch.com/2015/07/16/microsoft-will-never-give-up-on-mobile\""},{"language":"javascript","code":"textapi.classify({\n  url: 'http://techcrunch.com/2015/07/16/microsoft-will-never-give-up-on-mobile'\n}, function(error, response) {\n  if (error === null) {\n    response['categories'].forEach(function(c) {\n      console.log(c);\n    });\n  }\n});"},{"language":"python","code":"url = \"http://techcrunch.com/2015/07/16/microsoft-will-never-give-up-on-mobile\"\nclassifications = client.Classify({\"url\": url})\nfor category in classifications['categories']:\n  print category"},{"language":"php","code":"<?php\n$url = 'http://techcrunch.com/2015/07/16/microsoft-will-never-give-up-on-mobile';\n$classifications = $textapi->Classify(array('url' => $url));\nforeach($classifications->categories as $category) {\n  var_dump($category);\n}\n?>"},{"code":"ClassifyParams.Builder builder = ClassifyParams.newBuilder();\njava.net.URL url = new java.net.URL(\"http://techcrunch.com/2015/07/16/microsoft-will-never-give-up-on-mobile\");\nbuilder.setUrl(url);\nClassifications classifications = client.classify(builder.build());\nfor (Category category: classifications.getCategories()) {\n\t\tSystem.out.println(category);\n}","language":"java"},{"language":"ruby","code":"url = \"http://techcrunch.com/2015/07/16/microsoft-will-never-give-up-on-mobile\"\n\nclassifications = client.classify(url: url)\n\nclassifications[:categories].each do |category|\n  puts category\nend"},{"language":"go","code":"url := \"http://techcrunch.com/2015/07/16/microsoft-will-never-give-up-on-mobile\"\nclassifyPrams := &textapi.ClassifyParams{URL: url}\nclassifications, err := client.Classify(classifyPrams)\nif err != nil {\n\t\tpanic(err)\n}\nfor _, c := range classifications.Categories {\n\t\tfmt.Printf(\"%v\\n\", c)\n}"},{"language":"csharp","code":"string url = \"http://techcrunch.com/2015/07/16/microsoft-will-never-give-up-on-mobile\";\n\nClassify classifications = client.Classify(url: url);\n\nforeach (var category in classifications.Categories)\n{\n  Console.Write(category.Label);\n}"}]},"auth":"required","params":[{"_id":"55aba608a36ccd0d00fdebbb","ref":"","in":"query","required":false,"desc":"Text to classify","default":"","type":"string","name":"text"},{"_id":"55a8f048cf45e1390093f249","ref":"","in":"query","required":false,"desc":"Article or webpage to classify","default":"","type":"string","name":"url"},{"_id":"55a8f18bc8bd450d000dd113","ref":"","in":"query","required":false,"desc":"Language (refer to [Language Support](/docs/language-support))","default":"auto","type":"string","name":"language"}],"url":"/classify"},"isReference":false,"order":0,"body":"Knowing the high-level semantic category of an unlabelled document such as a webpage or article can be extremely helpful in various applications. The **Classification** endpoint helps you categorize any text or URL according to a predefined taxonomy.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Custom classification schemes\",\n  \"body\": \"We help our users build their own classification schemes based on pre-existing systems or seed data. [Drop us a line](mailto:support:::at:::aylien.com) to find out more.\"\n}\n[/block]","excerpt":"/classify","slug":"classify","type":"endpoint","title":"Classification"}

getClassification

/classify

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

text:
string
Text to classify
url:
string
Article or webpage to classify
language:
stringauto
Language (refer to [Language Support](/docs/language-support))

Examples


Result Format


Documentation

Knowing the high-level semantic category of an unlabelled document such as a webpage or article can be extremely helpful in various applications. The **Classification** endpoint helps you categorize any text or URL according to a predefined taxonomy. [block:callout] { "type": "info", "title": "Custom classification schemes", "body": "We help our users build their own classification schemes based on pre-existing systems or seed data. [Drop us a line](mailto:support@aylien.com) to find out more." } [/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 }}