{"name":"websitecategorization","version":"1.0.8","description":"","_id":"websitecategorization@1.0.8","_nodeVersion":"12.13.0","_npmVersion":"6.14.7","dist":{"integrity":"sha512-v4wzQZFDHSJARw4Qm26tun+N+HGwkbOCOXEeTjG2RYG5whqB4gX5FuZNnq3lTztWLkG5mpaLGDw8CHkhz5zV7w==","shasum":"abae6c0fe93a50a11b31d1abedb6f028203783b6","tarball":"https://registry.npmmirror.com/websitecategorization/-/websitecategorization-1.0.8.tgz","fileCount":3,"unpackedSize":7671,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIE5JUmJO88Yql+1O2kYdDZ2JoPqmSvJFnJo9B32cd4mHAiBwuDbAySpXAKrcEZc2zz+lAq/EcSZ9LamiJMnFO0VPnA=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJinw2MACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoBjBAAmrTjq/1ApAuAUVT6UQ9oSb6Gyqu13tRNAIP0MkAEI5KG13Df\r\nyH7mwP28BmZ2HM05BwEIxbbF9cRxWU5qOs958sboses1RGbhF8titAJUpaX9\r\ngPdZ11bTO8q0xAHaYh2RL0/vx6vTBZME0NUWC2Ty5gmRQM6eX5mLsG/5kLQe\r\nJnswDBMLqxXstSh0JqpeQTI30EtXfyUffyDMMfxQr1HWEyqgF+AviF2pX+Y8\r\n2jzSjz4He5ZBjUkb5V0Hx3kNI9oz7xSG2s2tO9MGNzav6jSQaykozv9HmLtn\r\nxJ1i1PfQ2/4hTDMuFE0LZ2FY+UEfFAAwhWH8s6Prv64vVvodS6VRk594uzrY\r\nbue2JLkX4ckKacXje8g+hs7QaHzzAlZwhZVPzZS0MDGmkVgiiCEm49un20vu\r\nD2g0eJUafCTR7LGzLVUU+Z6h3z4LC/5p3/3/F8+8WFBUdeAKYmxQaRuCMqbD\r\nVw5Wn6ENpMeDL7ztHCP2z+0DI9qAcIGkeHq2rAdHDVwMDaf6VelnnjmBhu3k\r\nUSd8mIidV0WUlkOf5PqpF9Aks2VQp+dkz20qliQYUlTSnVJSGpWrBnX0C90I\r\nQKIH7+7spgbOgI+JEuDTGYWVfvBxy5KgzvqG8rISYaqAOxPjbiujfKC5KcWH\r\nXpxkib3JJoKJWOG+uutDwDvPZcHGH2lYTrM=\r\n=S4Hy\r\n-----END PGP SIGNATURE-----\r\n","size":2649},"_npmUser":{"name":"websitecategorization","email":"info@websitecategorizationapi.com"},"directories":{},"maintainers":[{"name":"websitecategorization","email":"info@websitecategorizationapi.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/websitecategorization_1.0.8_1654590860315_0.8089972578832676"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2022-06-07T08:34:44.303Z","readme":"\n\n# Website / Domain Categorization API for Node.js\n\n Website / Domain Categorization API is a Node.js module that uses machine learning model to classify arbitrary blocks of input texts or URLs into content categories. \n \n Content categories are based on two taxonomies: \n\n - Ecommerce (21 Tier 1 categories, 192 Tier 2 categories and 1113 Tier 3 categories)\n - IAB based (29 Tier 1 categories, 447 Tier 2 categories)\n\n# Installation \n\n```\nnpm i @websitecategorization/websitecategorization\n```\n\n\n# Usage example\n\n```\nvar request = require('request');\nvar options = {\n 'method': 'POST',\n 'url': 'https://www.websitecategorizationapi.com/api/gpt/gpt_category1.php',\n 'headers': {\n 'Content-Type': 'application/x-www-form-urlencoded'\n },\n form: {\n 'query': 'earphone buds'\n }\n};\nrequest(options, function (error, response) {\n if (error) throw new Error(error);\n console.log(response.body);\n});\n```\n\n# Use cases\n\nWeb Categorization API is used by a wide variety of companies for many different use cases. \n\nIt is suitable for Ad Exchanges, Demand Side Platforms (DSPs), Supply Side Platforms (SSPs) and Ad Networks. SSP (Supply Side Platform) companies can e.g. use it to identify the advertiser’s category to check its eligibility for real-time bidding. \n\nOther use cases include Web Content Filtering where a company can employ it to filter out non-work related websites, such as social media networks, shopping platforms and similar. \n\n[Website / Domain categorization API](https://www.websitecategorizationapi.com) is based on a machine learning model that has been extensively tested and used both in small and large scale classification projects, including on a project with 30+ million texts. \n\nIt is continuously developed and regularly updated (in terms of training data set) to reflect and include new verticals arising each year. \n\n# UI Dashboard\n\nWebsite categorization service can also be used in form of dashboard UI, as seen here: \n\n![image](https://user-images.githubusercontent.com/58834207/171235279-f5c67b23-46be-4474-be5a-fd7d859ab16d.png)\n\n# Form of json\n\nExample output from IAB1 Website Categorization API on example domain: \n```\n{\n \"classification\": [\n {\n \"category\": \"Style & Fashion\",\n \"value\": 0.6335134346543948\n },\n {\n \"category\": \"Religion & Spirituality\",\n \"value\": 0.31965677636420087\n },\n {\n \"category\": \"Events and Attractions\",\n \"value\": 0.028203161466589827\n },\n {\n \"category\": \"Pop Culture\",\n \"value\": 0.008486557302356994\n },\n {\n \"category\": \"Books and Literature\",\n \"value\": 0.0028975322143729425\n },\n {\n \"category\": \"Shopping\",\n \"value\": 0.0014989265842864407\n },\n {\n \"category\": \"Fine Art\",\n \"value\": 0.0014698938766846063\n },\n {\n \"category\": \"Family and Relationships\",\n \"value\": 0.0008695569530150543\n },\n {\n \"category\": \"Hobbies & Interests\",\n \"value\": 0.0007021051093678122\n },\n {\n \"category\": \"Travel\",\n \"value\": 0.00045551400716377827\n },\n {\n \"category\": \"Movies\",\n \"value\": 0.0003105774008160576\n },\n {\n \"category\": \"Television\",\n \"value\": 0.0002812439624312471\n },\n {\n \"category\": \"Healthy Living\",\n \"value\": 0.00027001968240167887\n },\n {\n \"category\": \"Careers\",\n \"value\": 0.0002666186301324818\n },\n {\n \"category\": \"Food & Drink\",\n \"value\": 0.0002460227720972317\n },\n {\n \"category\": \"Home & Garden\",\n \"value\": 0.00021331353597162862\n },\n {\n \"category\": \"Medical Health\",\n \"value\": 0.00018344636503169902\n },\n {\n \"category\": \"Music and Audio\",\n \"value\": 0.00007348860474246987\n },\n {\n \"category\": \"Video Gaming\",\n \"value\": 0.00006822010822593386\n },\n {\n \"category\": \"Real Estate\",\n \"value\": 0.00006517844821148466\n },\n {\n \"category\": \"Pets\",\n \"value\": 0.00006069812911973799\n },\n {\n \"category\": \"Education\",\n \"value\": 0.00004860296854985923\n },\n {\n \"category\": \"News and Politics\",\n \"value\": 0.000035123587801619264\n },\n {\n \"category\": \"Sports\",\n \"value\": 0.00003402965849228489\n },\n {\n \"category\": \"Science\",\n \"value\": 0.000026461875107857055\n },\n {\n \"category\": \"Automotive\",\n \"value\": 0.000024825949895016523\n },\n {\n \"category\": \"Personal Finance\",\n \"value\": 0.00001581204114251354\n },\n {\n \"category\": \"Technology & Computing\",\n \"value\": 0.000015037047929356491\n },\n {\n \"category\": \"Business and Finance\",\n \"value\": 0.000007820699466562138\n }\n ],\n \"language\": \"en\"\n}\n```\n\n# Curl\n\nSupported API calls (in curl) that can be adapted to javascript: \n\n```\ncurl --location --request POST 'https://www.websitecategorizationapi.com/api/gpt/gpt_category1.php' \\\n--header 'Content-Type: application/x-www-form-urlencoded' \\\n--data-urlencode 'query=polaroid land camera' \\\n--data-urlencode 'api_key=b4dcde2ce5fb2d0b887b5e'\n\ncurl --location --request POST 'https://www.websitecategorizationapi.com/api/gpt/gpt_category2.php' \\\n--header 'Content-Type: application/x-www-form-urlencoded' \\\n--data-urlencode 'query=polaroid land camera' \\\n--data-urlencode 'api_key=b4dcde2ce5fb2d0b887b5e'\n\ncurl --location --request POST 'https://www.websitecategorizationapi.com/api/gpt/gpt_category3.php' \\\n--header 'Content-Type: application/x-www-form-urlencoded' \\\n--data-urlencode 'query=polaroid land camera' \\\n--data-urlencode 'api_key=b4dcde2ce5fb2d0b887b5e'\n\ncurl --location --request POST 'https://www.websitecategorizationapi.com/api/iab/gpt_category1.php' \\\n--header 'Content-Type: application/x-www-form-urlencoded' \\\n--data-urlencode 'query=credit card' \\\n--data-urlencode 'api_key=b4dcde2ce5fb2d0b887b5e'\n\ncurl --location --request POST 'https://www.websitecategorizationapi.com/api/iab/gpt_category2.php' \\\n--header 'Content-Type: application/x-www-form-urlencoded' \\\n--data-urlencode 'query=credit card' \\\n--data-urlencode 'api_key=b4dcde2ce5fb2d0b887b5e'\n```\n\n# Support for languages\n\nService supports website categorization of texts written in german, french, italian, spanish, portuguese and many other languages. \n\n# Useful resources\n\n- IAB taxonomy: [https://iabtechlab.com/press-releases/tech-lab-releases-content-taxonomy-3-0/](https://iabtechlab.com/press-releases/tech-lab-releases-content-taxonomy-3-0/)\n\n- Facebook Taxonomy: [https://www.facebook.com/business/help/526764014610932?id=725943027795860](https://www.facebook.com/business/help/526764014610932?id=725943027795860)\n\n- [Introduction to Website Categorization](https://www.alpha-quantum.com/blog/website-categorization/website-categorization-api/)\n\n- Survey of text classification models: [https://github.com/kk7nc/Text_Classification](https://github.com/kk7nc/Text_Classification)\n\n- [Introduction to product classification machine learning models:](https://medium.com/product-categorization/product-categorization-introduction-d62bb92e8515)\n\n\n\n\n"}