![\"\"](\"https://www.productcategorization.com/iab1.png\")
Welcome to the documentation for our text classification API, that can be used for product categorizations and general text classifications.
\nOur E-commerce categorization API classifies texts such as products into 1113 possible categories.
\nOur second, IAB taxonomy based API, classifies general texts into 440 possible categories.
\nYou need an API key to access API endpoints, you can get it by subscribing here.
\nYou can start categorizing products and general texts in just 2 minutes, by following our tutorial at:
\nhttps://www.productcategorization.com/tutorial1.php
\nWe also offer offline databases of categorized websites. Example of distribution of Tier 1 categories for around 800,000 domains:
\n
API service expects for the API key to be included in all API requests to the server, as parameter:
\napi_key: b4dade2ce5fb2d0b189b5eb6f0cd
You must replace b4dade2ce5fb2d0b189b5eb6f0cd with your own API key.
HTTP responses that are successful will have the status code 200 and the response formatted according to specification, please see documentation for examples.
\nServers return API data in JSON format by default.
\nProduct categorization is based on taxonomy tailored to E-Commerce.
Tier 1 categorization returns probabilities of text being classified as one of 21 possible categories.
GET https://www.productcategorization.com/api/gpt/gpt_category1.php?query=polaroid land camera&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v
curl https://www.productcategorization.com/api/gpt/gpt_category1.php?query=polaroid land camera&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Cameras & Optics\",\n \"value\": 0.9987253421912741\n },\n {\n \"category\": \"Electronics\",\n \"value\": 0.000562862622295886\n },\n {\n \"category\": \"Home & Garden\",\n \"value\": 0.0005436545440954681\n },\n {\n \"category\": \"Business & Industrial\",\n \"value\": 0.00007432249947499341\n },\n {\n \"category\": \"Office Supplies\",\n \"value\": 0.000033526685721586356\n },\n {\n \"category\": \"Apparel & Accessories\",\n \"value\": 0.000027410018876003828\n },\n {\n \"category\": \"Arts & Entertainment\",\n \"value\": 0.000007521376738994588\n },\n {\n \"category\": \"Toys & Games\",\n \"value\": 0.000005882323386026919\n },\n {\n \"category\": \"Sporting Goods\",\n \"value\": 0.0000054131118222522225\n },\n {\n \"category\": \"Hardware\",\n \"value\": 0.0000033494618317838667\n },\n {\n \"category\": \"Baby & Toddler\",\n \"value\": 0.000002964992638430485\n },\n {\n \"category\": \"Food, Beverages & Tobacco\",\n \"value\": 0.0000016666852257013246\n },\n {\n \"category\": \"Vehicles & Parts\",\n \"value\": 0.0000011971066840144845\n },\n {\n \"category\": \"Media\",\n \"value\": 0.0000011131512981848846\n },\n {\n \"category\": \"Animals & Pet Supplies\",\n \"value\": 0.0000010786729107985125\n },\n {\n \"category\": \"Furniture\",\n \"value\": 8.600872153899655e-7\n },\n {\n \"category\": \"Luggage & Bags\",\n \"value\": 7.425740758731358e-7\n },\n {\n \"category\": \"Mature\",\n \"value\": 4.101005623841621e-7\n },\n {\n \"category\": \"Health & Beauty\",\n \"value\": 3.4821204250832534e-7\n },\n {\n \"category\": \"Religious & Ceremonial\",\n \"value\": 2.798537689428336e-7\n },\n {\n \"category\": \"Software\",\n \"value\": 5.3728060390120276e-8\n }\n ],\n \"language\": \"en\"\n}\n\nProduct categorization is based on taxonomy tailored to E-Commerce.
Tier 2 categorization returns probabilities of text being classified as one of 182 possible categories.
GET https://www.productcategorization.com/api/gpt/gpt_category2.php?query=polaroid camera&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v
curl https://www.productcategorization.com/api/gpt/gpt_category2.php?query=polaroid camera&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Cameras\",\n \"value\": 0.9160965830309336\n },\n {\n \"category\": \"Camera & Optic Accessories\",\n \"value\": 0.014408161930182316\n },\n {\n \"category\": \"Presentation Supplies\",\n \"value\": 0.013201065065928974\n },\n {\n \"category\": \"Video\",\n \"value\": 0.009239226281822454\n },\n {\n \"category\": \"Electronics Accessories\",\n \"value\": 0.00527737163793613\n },\n ,...]\n}\n\nProduct categorization is based on taxonomy tailored to E-Commerce.
Tier 1 categorization returns probabilities of text being classified as one of 1113 possible categories.
For more information about taxonomies, please check out article on this topic: What are the benefits of using product categorization or product tagging?
\nGET https://www.productcategorization.com/api/gpt/gpt_category3.php?query=polaroid camera&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v
curl https://www.productcategorization.com/api/gpt/gpt_category3.php?query=polaroid camera&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Film Cameras\",\n \"value\": 0.5330920056393742\n },\n {\n \"category\": \"Digital Cameras\",\n \"value\": 0.25333581946019373\n },\n {\n \"category\": \"Disposable Cameras\",\n \"value\": 0.0663910677556255\n },\n {\n \"category\": \"Trail Cameras\",\n \"value\": 0.01740226805363727\n },\n {\n \"category\": \"Document Cameras\",\n \"value\": 0.015069146377420819\n },\n {\n \"category\": \"Surveillance Cameras\",\n \"value\": 0.011664482862068214\n },\n {\n \"category\": \"Borescopes\",\n \"value\": 0.008395065450695205\n },\n {\n \"category\": \"Video Cameras\",\n \"value\": 0.007260418504801398\n },\n {\n \"category\": \"Camera Lens Accessories\",\n \"value\": 0.00650744791929527\n },,...]\n}\n\nProduct categorization is based on taxonomy tailored to E-Commerce.
Tier 1 categorization returns probabilities of text from URL being classified as one of 21 possible categories.
GET https://www.productcategorization.com/api/gpt/gpt_category1.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v&data_type=url
curl https://www.productcategorization.com/api/gpt/gpt_category1.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v&data_type=url\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Cameras & Optics\",\n \"value\": 0.9992289896015756\n },\n {\n \"category\": \"Home & Garden\",\n \"value\": 0.0006520692868512297\n },\n {\n \"category\": \"Apparel & Accessories\",\n \"value\": 0.00004644383948321836\n },\n {\n \"category\": \"Electronics\",\n \"value\": 0.00003771973664942523\n },\n {\n \"category\": \"Business & Industrial\",\n \"value\": 0.000008166161487290707\n },\n {\n \"category\": \"Office Supplies\",\n \"value\": 0.000007549115352502271\n },...]\n}\n\nProduct categorization is based on taxonomy tailored to E-Commerce.
Tier 1 categorization returns probabilities of text from URL being classified as one of 186 possible categories.
GET https://www.productcategorization.com/api/gpt/gpt_category2.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v&data_type=url
curl https://www.productcategorization.com/api/gpt/gpt_category2.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v&data_type=url\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Cameras\",\n \"value\": 0.9245012943174596\n },\n {\n \"category\": \"Presentation Supplies\",\n \"value\": 0.004850704982243057\n },...]\n}\n\nProduct categorization is based on taxonomy tailored to E-Commerce.
Tier 1 categorization returns probabilities of text from URL being classified as one of 1113 possible categories.
GET https://www.productcategorization.com/api/gpt/gpt_category3.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v&data_type=url
curl https://www.productcategorization.com/api/gpt/gpt_category3.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v&data_type=url\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Film Cameras\",\n \"value\": 0.8221396513265392\n },\n {\n \"category\": \"Digital Cameras\",\n \"value\": 0.03174787172824993\n },\n {\n \"category\": \"Disposable Cameras\",\n \"value\": 0.02434788833270771\n },\n {\n \"category\": \"Picture Frames\",\n \"value\": 0.0020415917541745025\n },\n {\n \"category\": \"Watch Accessories\",\n \"value\": 0.0019267665992148237\n },\n {\n \"category\": \"Video Cameras\",\n \"value\": 0.0018906391929454846\n },\n {\n \"category\": \"Surveillance Cameras\",\n \"value\": 0.001548661227171665\n },...]\n}\n\nIAB categorization is based on taxonomy from IAB organization.
\nTier 1 categorization returns probabilities of text being classified as one of 29 possible categories.
\nGET https://www.productcategorization.com/api/iab/gpt_category1.php?query=credit card&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v
curl https://www.productcategorization.com/api/iab/gpt_category1.php?query=credit card&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Personal Finance\",\n \"value\": 0.9761399141331873\n },\n {\n \"category\": \"Hobbies & Interests\",\n \"value\": 0.012164815580256418\n },\n {\n \"category\": \"Automotive\",\n \"value\": 0.0025196087021092215\n },\n {\n \"category\": \"Music and Audio\",\n \"value\": 0.0008752506600661922\n },\n {\n \"category\": \"Style & Fashion\",\n \"value\": 0.0008616063832503892\n },\n {\n \"category\": \"Fine Art\",\n \"value\": 0.0007356838538989182\n },\n {\n \"category\": \"Events and Attractions\",\n \"value\": 0.0006860379172393203\n },\n {\n \"category\": \"Business and Finance\",\n \"value\": 0.0006617396989540662\n },\n {\n \"category\": \"Shopping\",\n \"value\": 0.0005497554147123015\n },\n {\n \"category\": \"Sports\",\n \"value\": 0.0005244575592904009\n },\n {\n \"category\": \"Food & Drink\",\n \"value\": 0.0005127335219828095\n },\n {\n \"category\": \"Technology & Computing\",\n \"value\": 0.00047175450468135173\n },\n {\n \"category\": \"Medical Health\",\n \"value\": 0.00037166903273757674\n },\n {\n \"category\": \"Pop Culture\",\n \"value\": 0.00033420130176418624\n },\n {\n \"category\": \"Travel\",\n \"value\": 0.00033124861987561744\n },\n {\n \"category\": \"Science\",\n \"value\": 0.0003090364749867773\n },\n {\n \"category\": \"Movies\",\n \"value\": 0.00029288123865858144\n },\n {\n \"category\": \"Education\",\n \"value\": 0.0002908401351480208\n },\n {\n \"category\": \"News and Politics\",\n \"value\": 0.00022847415444144793\n },\n {\n \"category\": \"Home & Garden\",\n \"value\": 0.0002152725238608538\n },\n {\n \"category\": \"Pets\",\n \"value\": 0.00017486261718002182\n },\n {\n \"category\": \"Television\",\n \"value\": 0.000124120100803851\n },\n {\n \"category\": \"Healthy Living\",\n \"value\": 0.00011409833413449834\n },\n {\n \"category\": \"Religion & Spirituality\",\n \"value\": 0.00011219133637975148\n },\n {\n \"category\": \"Family and Relationships\",\n \"value\": 0.00010729327394592739\n },\n {\n \"category\": \"Careers\",\n \"value\": 0.00010286095832155701\n },\n {\n \"category\": \"Books and Literature\",\n \"value\": 0.00009633052630078263\n },\n {\n \"category\": \"Real Estate\",\n \"value\": 0.00008766190043931586\n },\n {\n \"category\": \"Video Gaming\",\n \"value\": 0.000003599541392274362\n }\n ],\n \"language\": \"en\"\n}\n\nIAB categorization is based on taxonomy from IAB organization.
\nTier 1 categorization returns probabilities of text being classified as one of 447 possible categories.
\nGET https://www.productcategorization.com/api/iab/gpt_category2.php?query=credit card&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v
curl https://www.productcategorization.com/api/iab/gpt_category2.php?query=credit card&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Personal Debt\",\n \"value\": 0.8993637222986489\n },...]\n}\n\nIAB categorization is based on taxonomy from IAB organization.
\nTier 1 categorization returns probabilities of text being classified as one of 29 possible categories.
\nGET https://www.productcategorization.com/api/iab/iab_category1_url.php?query=https://www.elle.com/&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v
curl https://www.productcategorization.com/api/iab/iab_category1_url.php?query=https://www.elle.com/&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Style & Fashion\",\n \"value\": 0.7445648974299292\n },\n {\n \"category\": \"Pop Culture\",\n \"value\": 0.19117375948105383\n },\n {\n \"category\": \"Events and Attractions\",\n \"value\": 0.05735528094741476\n },,...]\n}\n\nIAB categorization is based on taxonomy from IAB organization.
\nTier 1 categorization returns probabilities of text being classified as one of 447 possible categories.
\nGET https://www.productcategorization.com/api/gpt/gpt_category2.php?query=https://www.elle.com/&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v&data_type=url
curl https://www.productcategorization.com/api/gpt/gpt_category2.php?query=https://www.elle.com/&api_key=b4dcde2ce5fb2d0b887b5eb6f0cd2000v&data_type=url\n\n\n\nThe above command returns JSON structured like this:
\n
{\n \"classification\": [\n {\n \"category\": \"Street Style\",\n \"value\": 0.4850728519866097\n },\n {\n \"category\": \"Celebrity Style\",\n \"value\": 0.23190837126729394\n },\n {\n \"category\": \"Fashion Trends\",\n \"value\": 0.12005606546256739\n },\n {\n \"category\": \"Fashion Events\",\n \"value\": 0.10266536418561253\n },\n {\n \"category\": \"Beauty\",\n \"value\": 0.007215169792467588\n },\n {\n \"category\": \"Designer Clothing\",\n \"value\": 0.004916532775707807\n },\n {\n \"category\": \"Astrology\",\n \"value\": 0.0035571097795627895\n },\n {\n \"category\": \"High Fashion\",\n \"value\": 0.00282184801599979\n },,...]\n}\n\nThe API uses the following error codes:
\nProductcategorization.com API, supporting taxonomies with 1000+ categories is one of the most accurate e-commerce categorisation services.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Get your API key","slug":"get-your-api-key"},{"content":"Authentication","slug":"authentication"},{"content":"Product Categorization of Texts, Tier 1","slug":"product-categorization-of-texts-tier-1"},{"content":"Product Categorization of Texts, Tier 2","slug":"product-categorization-of-texts-tier-2"},{"content":"Product Categorization of Texts, Tier 3","slug":"product-categorization-of-texts-tier-3"},{"content":"Product Categorization of URLs, Tier 1","slug":"product-categorization-of-urls-tier-1"},{"content":"Product Categorization of URLs, Tier 2","slug":"product-categorization-of-urls-tier-2"},{"content":"Product Categorization of URLs, Tier 3","slug":"product-categorization-of-urls-tier-3"},{"content":"IAB Categorization of Texts, Tier 1","slug":"iab-categorization-of-texts-tier-1"},{"content":"IAB Categorization of Texts, Tier 2","slug":"iab-categorization-of-texts-tier-2"},{"content":"IAB Categorization of URLs, Tier 1","slug":"iab-categorization-of-urls-tier-1"},{"content":"IAAB Categorization of URLs, Tier 2","slug":"iaab-categorization-of-urls-tier-2"},{"content":"Errors","slug":"errors"}],"owner":"20674041","collectionId":"bad8f551-505c-4341-b3c0-5a050c754a64","publishedId":"UyrBjGSV","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-08-14T21:28:17.000Z"},"item":[]}