{"info":{"_postman_id":"f6431688-2a46-46a3-bdc3-7954a93bc631","name":"Website categorization API","description":"

Introduction to Website categorization API

\n

Website categorization API is one of the most accurate website categorization restful APIs with large number of categories supported.

\n

A valid API key is needed to obtain results from our API endpoints and are available by purchasing subscription to our plans.

\n

You can use our API service with websites, but also on texts. URL classification accepts full-path URLs and returns real-time, live URL based website categorization.

\n

We use two different definitions for categorizations:

\n

- IAB Taxonomy, supporting two Tiers

\n

- Products Taxonomy

\n

Authentication

\n

Our API service expects for the API key to be included in all API requests to the server, as parameter:

\n

api_key: b4dade2ce5fb2d0b189b5f0cd

\n

You must replace b4dade2ce5fb2d0b189b5f0cd with your own API key.

\n

E-commerce categorization of Texts, Tier 1

\n

This API endpoint is especially suitable for E-Commerce related
websites, like online stores. For general websites please check our IAB
classifier, documented further below.

\n

Tier 1 categorization returns probabilities of text being classified as one of 21 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/gpt/gpt_category1.php?query=polaroid land camera&api_key=b4dcde2ce5fb2d0b887b5e

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
\n
curl https://www.websitecategorizationapi.com/api/gpt/gpt_category1.php?query=polaroid land camera&api_key=b4dcde2ce5fb2d0b887b5e\n\n
\n

The above command returns JSON structured like this:

\n
\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\n

E-Commerce categorization of Texts, Tier 2

\n

This API endpoint is especially suitable for E-Commerce related
websites, like online stores. For general websites please check our IAB
classifier, documented further below.

\n

Tier 2 website categorization returns probabilities of text being classified as one of 182 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/gpt/gpt_category2.php?query=polaroid camera&api_key=b4dcde2ce5fb2d0b887b5e

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
\n
curl https://www.websitecategorizationapi.com/api/gpt/gpt_category2.php?query=polaroid camera&api_key=b4dcde2ce5fb2d0b887b5e\n\n
\n

The above command returns JSON structured like this:

\n
\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\n

E-Commerce categorization of Texts, Tier 3

\n

This API endpoint is especially suitable for E-Commerce related
websites, like online stores. For general websites please check our IAB
classifier, documented further below.

\n

Tier 1 website categorization returns probabilities of text being classified as one of 1113 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/gpt/gpt_category3.php?query=polaroid camera&api_key=b4dcde2ce5fb2d0b887b5e

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
\n
curl https://www.websitecategorizationapi.com/api/gpt/gpt_category3.php?query=polaroid camera&api_key=b4dcde2ce5fb2d0b887b5e\n\n
\n

The above command returns JSON structured like this:

\n
\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\n

E-Commerce website categorization of URLs, Tier 1

\n

This API endpoint is especially suitable for E-Commerce related
websites, like online stores. For general websites please check our IAB
classifier, documented further below.

\n

Tier 1 categorization returns probabilities of text from URL being classified as one of 21 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/gpt/gpt_category1.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5e&data_type=url

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
data_typestringshould be set to 'url'
\n
curl https://www.websitecategorizationapi.com/api/gpt/gpt_category1.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5e&data_type=url\n\n
\n

The above command returns JSON structured like this:

\n
\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\n

E-Commerce categorization of URLs, Tier 2

\n

This API endpoint is especially suitable for E-Commerce related
websites, like online stores. For general websites please check our IAB
classifier, documented further below.

\n

Tier 1 categorization returns probabilities of text from URL being classified as one of 186 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/gpt/gpt_category2.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5e&data_type=url

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
data_typestringshould be set to 'url'
\n
curl https://www.websitecategorizationapi.com/api/gpt/gpt_category2.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5e&data_type=url\n\n
\n

The above command returns JSON structured like this:

\n
\n
{\n  \"classification\": [\n    {\n      \"category\": \"Cameras\",\n      \"value\": 0.9245012943174596\n    },\n    {\n      \"category\": \"Presentation Supplies\",\n      \"value\": 0.004850704982243057\n    },...]\n}\n\n

E-Commerce categorization of URLs, Tier 3

\n

This API endpoint is especially suitable for E-Commerce related
websites, like online stores. For general websites please check our IAB
classifier, documented further below.

\n

Tier 1 categorization returns probabilities of text from URL being classified as one of 1113 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/gpt/gpt_category3.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5e&data_type=url

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
data_typestringshould be set to 'url'
\n
curl https://www.websitecategorizationapi.com/api/gpt/gpt_category3.php?query=https://eu.polaroid.com/collections/instant-cameras&api_key=b4dcde2ce5fb2d0b887b5e&data_type=url\n\n
\n

The above command returns JSON structured like this:

\n
\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\n

IAB Categorization of Texts, Tier 1

\n

IAB categorization is based on taxonomy from IAB organization.

\n

Tier 1 categorization returns probabilities of text being classified as one of 29 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/iab/gpt_category1.php?query=credit card&api_key=b4dcde2ce5fb2d0b887b5e

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
\n
curl https://www.websitecategorizationapi.com/api/iab/gpt_category1.php?query=credit card&api_key=b4dcde2ce5fb2d0b887b5e\n\n
\n

The above command returns JSON structured like this:

\n
\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\n

IAB Categorization of Texts, Tier 2

\n

IAB categorization is based on taxonomy from IAB organization.

\n

Tier 1 categorization returns probabilities of text being classified as one of 447 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/iab/gpt_category2.php?query=credit card&api_key=b4dcde2ce5fb2d0b887b5e

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
\n
curl https://www.websitecategorizationapi.com/api/iab/gpt_category2.php?query=credit card&api_key=b4dcde2ce5fb2d0b887b5e\n\n
\n

The above command returns JSON structured like this:

\n
\n
{\n  \"classification\": [\n    {\n      \"category\": \"Personal Debt\",\n      \"value\": 0.8993637222986489\n    },...]\n}\n\n

IAB Categorization of URLs, Tier 1

\n

IAB categorization is based on taxonomy from IAB organization.

\n

Tier 1 categorization returns probabilities of text being classified as one of 29 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/iab/iab_category1_url.php?query=https://www.theverge.com/&api_key=b4dcde2ce5fb2d0b887b5e

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
\n
curl https://www.websitecategorizationapi.com/api/iab/iab_category1_url.php?query=https://www.theverge.com/&api_key=b4dcde2ce5fb2d0b887b5e\n\n
\n

The above command returns JSON structured like this:

\n
\n
{\n  \"classification\": [\n    {\n      \"category\": \"Technology & Computing\",\n      \"value\": 0.4171649489395124\n    },\n    {\n      \"category\": \"Video Gaming\",\n      \"value\": 0.18616746555063265\n    },\n    {\n      \"category\": \"Hobbies & Interests\",\n      \"value\": 0.08888010984131789\n    },\n    {\n      \"category\": \"Television\",\n      \"value\": 0.08364788502170598\n    },\n    {\n      \"category\": \"Personal Finance\",\n      \"value\": 0.026911980291179315\n    },...]\n}\n\n

IAAB Categorization of URLs, Tier 2

\n

IAB categorization is based on taxonomy from IAB organization.

\n

Tier 1 categorization returns probabilities of text being classified as one of 447 possible categories.

\n

HTTP Request

\n

GET https://www.websitecategorizationapi.com/api/gpt/gpt_category2.php?query=https://www.theverge.com/&api_key=b4dcde2ce5fb2d0b887b5e&data_type=url

\n

Query Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
querystringtext to be categorized
api_keystringAPI key
data_typestringshould be set to 'url'
\n
curl https://www.websitecategorizationapi.com/api/gpt/gpt_category2.php?query=https://www.theverge.com/&api_key=b4dcde2ce5fb2d0b887b5e&data_type=url\n\n
\n

The above command returns JSON structured like this:

\n
\n
{\n  \"classification\": [\n    {\n      \"category\": \"Consumer Electronics\",\n      \"value\": 0.09432289580458242\n    },\n    {\n      \"category\": \"Video Game Genres\",\n      \"value\": 0.08423966799607889\n    },\n    {\n      \"category\": \"Home Utilities\",\n      \"value\": 0.03011371130949797\n    },\n    {\n      \"category\": \"Astrology\",\n      \"value\": 0.021293901078053422\n    },\n    {\n      \"category\": \"Business\",\n      \"value\": 0.01665557793073325\n    },\n    {\n      \"category\": \"Feature\",\n      \"value\": 0.016627965249943578\n    },\n    {\n      \"category\": \"Console Games\",\n      \"value\": 0.015979094081886563\n    },...]\n}\n\n

Errors

\n

The BittsAnalytics API uses the following error codes:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Error CodeMeaning
400Bad Request -- Your request is invalid.
401Unauthorized -- Your API key is wrong.
406Not Acceptable -- You requested a format that isn't json.
429Too Many Requests
500Internal Server Error -- We had a problem with our server. Try again later.
503Service Unavailable -- We're temporarily offline for maintenance. Please try again later.
\n

Interesting resources on the topic of Website Categorization API:

\n

* https://support.google.com/merchants/answer/6324436?hl=en
* API to categorize products in E-commerce
* https://iabtechlab.com/press-releases/tech-lab-releases-content-taxonomy-3-0/
* IP Address Lookup API
* Software for portfolio optimization

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction to Website categorization API","slug":"introduction-to-website-categorization-api"},{"content":"Authentication","slug":"authentication"},{"content":"E-commerce categorization of Texts, Tier 1","slug":"e-commerce-categorization-of-texts-tier-1"},{"content":"E-Commerce categorization of Texts, Tier 2","slug":"e-commerce-categorization-of-texts-tier-2"},{"content":"E-Commerce categorization of Texts, Tier 3","slug":"e-commerce-categorization-of-texts-tier-3"},{"content":"E-Commerce website categorization of URLs, Tier 1","slug":"e-commerce-website-categorization-of-urls-tier-1"},{"content":"E-Commerce categorization of URLs, Tier 2","slug":"e-commerce-categorization-of-urls-tier-2"},{"content":"E-Commerce categorization of URLs, Tier 3","slug":"e-commerce-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":"18208142","collectionId":"f6431688-2a46-46a3-bdc3-7954a93bc631","publishedId":"Uyr7Hdmj","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-09-08T11:30:00.000Z"},"item":[{"name":"https://www.websitecategorizationapi.com/api/gpt/gpt_category1.php?query=polaroid land camera","id":"d45720fa-e86c-4d5a-9ff5-f51de6afe1f0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"https://www.websitecategorizationapi.com/api/gpt/gpt_category1.php?query=polaroid land camera","urlObject":{"protocol":"https","path":["api","gpt","gpt_category1.php"],"host":["www","websitecategorizationapi","com"],"query":[{"key":"query","value":"polaroid land camera"}],"variable":[]}},"response":[],"_postman_id":"d45720fa-e86c-4d5a-9ff5-f51de6afe1f0"}]}