{"info":{"_postman_id":"44f50f9d-c5c3-4d99-b4a6-1553de19876b","name":"Best Stores API","description":"<html><head></head><body><h1 id=\"introduction-to-documentation-for-the-beststoresio-api\">Introduction to Documentation for the Beststores.io API</h1>\n<p>Beststores.io Product Categorization and Trends API is an API which provides you with information on search engine trends for 1+ million products.</p>\n<p>For categorization of products, it is using a machine learning based Product Categorization API that supports more than 1000+ categories.</p>\n<p>This categorization of products to show top trending products in any major or minor vertical. One can thus select a specific vertical and see the top trending products in that vertical.</p>\n<p>Here are a few examples of trending products for Category = Animals &amp; Pets.</p>\n<img src=\"https://www.beststores.io/1.png\">\n\n<h1 id=\"authentication\">Authentication</h1>\n<p>API requests should be sent to the URL: <a href=\"https://www.beststores.io/api.php/\">https://www.beststores.io/api.php/</a></p>\n<p>An API key is needed to obtain results from our API endpoint. You can get it by <a href=\"https://www.beststores.io\">purchasing subscription to our plans</a>.</p>\n<p>You need to include API key in all API requests to the server, like this:</p>\n<p><code>api_key: b4dade2ce5fb2d0b189b</code></p>\n<p>In usage, make sure to replace <code>b4dade2ce5fb2d0b189b</code> with your own API key that we sent you when you purchased one of our plans at beststores.io.</p>\n<h1 id=\"keywords\">Keywords</h1>\n<p>This API endpoint returns one or more keywords in our database.</p>\n<h3 id=\"http-request\">HTTP Request</h3>\n<p><code>GET https://www.beststores.io/api.php/records/keywords/?include=id,keyword&amp;order=id&amp;page=10,30</code></p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>include</td>\n<td>string</td>\n<td>list of columns to be included</td>\n</tr>\n<tr>\n<td>api_key</td>\n<td>string</td>\n<td>API key</td>\n</tr>\n<tr>\n<td>order</td>\n<td>string</td>\n<td>column by which to order results</td>\n</tr>\n<tr>\n<td>page</td>\n<td>string</td>\n<td>minimum and maximum number of pages of results</td>\n</tr>\n</tbody>\n</table>\n</div><pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>curl --location --request GET 'https://www.beststores.io/api.php/records/keywords/?order=id&amp;page=10,30&amp;include=id,keyword'\n\n</code></pre><blockquote>\n<p>The above command returns JSON structured like this:</p>\n</blockquote>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n    \"records\": [\n        {\n            \"id\": 271,\n            \"keyword\": \"heel\"\n        },\n        {\n            \"id\": 272,\n            \"keyword\": \"chrome\"\n        },\n        {\n            \"id\": 273,\n            \"keyword\": \"masks\"\n        },\n        {\n            \"id\": 274,\n            \"keyword\": \"owl\"\n        },\n        {\n            \"id\": 275,\n            \"keyword\": \"paste\"\n        },\n        {\n            \"id\": 276,\n            \"keyword\": \"rack\"\n        },\n        {\n            \"id\": 277,\n            \"keyword\": \"breeze\"\n        },\n        {\n            \"id\": 278,\n            \"keyword\": \"fragments\"\n        },\n        {\n            \"id\": 279,\n            \"keyword\": \"gel\"\n        },\n        {\n            \"id\": 280,\n            \"keyword\": \"catalog\"\n        },\n        {\n            \"id\": 281,\n            \"keyword\": \"nickel\"\n        },\n        {\n            \"id\": 282,\n            \"keyword\": \"sleeve\"\n        },\n        {\n            \"id\": 283,\n            \"keyword\": \"candle\"\n        },\n        {\n            \"id\": 284,\n            \"keyword\": \"snack\"\n        },\n        {\n            \"id\": 285,\n            \"keyword\": \"sofa\"\n        },\n        {\n            \"id\": 286,\n            \"keyword\": \"rom\"\n        },\n        {\n            \"id\": 287,\n            \"keyword\": \"teddy\"\n        },\n        {\n            \"id\": 288,\n            \"keyword\": \"wheelchair\"\n        },\n        {\n            \"id\": 289,\n            \"keyword\": \"pillow\"\n        },\n        {\n            \"id\": 290,\n            \"keyword\": \"heavens\"\n        },\n        {\n            \"id\": 291,\n            \"keyword\": \"moss\"\n        },\n        {\n            \"id\": 292,\n            \"keyword\": \"skirt\"\n        },\n        {\n            \"id\": 293,\n            \"keyword\": \"vinyl\"\n        },\n        {\n            \"id\": 294,\n            \"keyword\": \"gasoline\"\n        },\n        {\n            \"id\": 295,\n            \"keyword\": \"cleaner\"\n        },\n        {\n            \"id\": 296,\n            \"keyword\": \"cooler\"\n        },\n        {\n            \"id\": 297,\n            \"keyword\": \"barn\"\n        },\n        {\n            \"id\": 298,\n            \"keyword\": \"jewelry\"\n        },\n        {\n            \"id\": 299,\n            \"keyword\": \"leon\"\n        },\n        {\n            \"id\": 300,\n            \"keyword\": \"starter\"\n        }\n    ],\n    \"results\": 1214678\n}\n\n</code></pre><h1 id=\"trends-and-search-volume-changes\">Trends and search volume changes</h1>\n<p>In order to obtain trends and keywords volume changes for 1.2 million<br>product names and keywords that we store in our database, you need to<br>use this API endpoint.</p>\n<h3 id=\"http-request-1\">HTTP Request</h3>\n<p><code>GET https://www.beststores.io/api.php/records/keywords_volume_change/?order=id&amp;page=10,20&amp;include=id,category,category_type,change_3m,change_6m,change_12m</code></p>\n<h3 id=\"query-parameters-1\">Query Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div><p>include | string | list of columns to be included<br>api_key | string | API key<br>order | string | column by which to order results<br>page | string | minimum and maximum number of pages of results</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>curl --location --request GET 'https://www.beststores.io/api.php/records/keywords_volume_change/?order=id&amp;include=id,category,category_type,change_3m,change_6m,change_12m&amp;page=10,30'\n\n</code></pre><blockquote>\n<p>The above command returns JSON structured like this:</p>\n</blockquote>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n    \"records\": [\n        {\n            \"id\": 216,\n            \"category_type\": \"1\",\n            \"category\": \"17\",\n            \"change_3m\": 0,\n            \"change_6m\": 22.31404958677686,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 216,\n            \"category_type\": \"2\",\n            \"category\": \"83\",\n            \"change_3m\": 0,\n            \"change_6m\": 22.31404958677686,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 219,\n            \"category_type\": \"1\",\n            \"category\": \"9\",\n            \"change_3m\": 22,\n            \"change_6m\": 22,\n            \"change_12m\": 22\n        },\n        {\n            \"id\": 219,\n            \"category_type\": \"2\",\n            \"category\": \"68\",\n            \"change_3m\": 22,\n            \"change_6m\": 22,\n            \"change_12m\": 22\n        },\n        {\n            \"id\": 221,\n            \"category_type\": \"1\",\n            \"category\": \"13\",\n            \"change_3m\": 0,\n            \"change_6m\": 48.588410104011885,\n            \"change_12m\": 48.588410104011885\n        },\n        {\n            \"id\": 221,\n            \"category_type\": \"2\",\n            \"category\": \"201\",\n            \"change_3m\": 0,\n            \"change_6m\": 48.588410104011885,\n            \"change_12m\": 48.588410104011885\n        },\n        {\n            \"id\": 222,\n            \"category_type\": \"1\",\n            \"category\": \"10\",\n            \"change_3m\": -18.27637444279346,\n            \"change_6m\": 0,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 222,\n            \"category_type\": \"2\",\n            \"category\": \"166\",\n            \"change_3m\": -18.27637444279346,\n            \"change_6m\": 0,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 223,\n            \"category_type\": \"1\",\n            \"category\": \"3\",\n            \"change_3m\": 22.282608695652176,\n            \"change_6m\": 22.282608695652176,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 223,\n            \"category_type\": \"2\",\n            \"category\": \"183\",\n            \"change_3m\": 22.282608695652176,\n            \"change_6m\": 22.282608695652176,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 224,\n            \"category_type\": \"1\",\n            \"category\": \"13\",\n            \"change_3m\": 0,\n            \"change_6m\": 0,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 224,\n            \"category_type\": \"2\",\n            \"category\": \"196\",\n            \"change_3m\": 0,\n            \"change_6m\": 0,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 225,\n            \"category_type\": \"1\",\n            \"category\": \"8\",\n            \"change_3m\": -18.0327868852459,\n            \"change_6m\": 21.506682867557714,\n            \"change_12m\": 21.506682867557714\n        },\n        {\n            \"id\": 225,\n            \"category_type\": \"2\",\n            \"category\": \"74\",\n            \"change_3m\": -18.0327868852459,\n            \"change_6m\": 21.506682867557714,\n            \"change_12m\": 21.506682867557714\n        },\n        {\n            \"id\": 226,\n            \"category_type\": \"1\",\n            \"category\": \"8\",\n            \"change_3m\": 22.259136212624586,\n            \"change_6m\": 22.259136212624586,\n            \"change_12m\": 22.259136212624586\n        },\n        {\n            \"id\": 226,\n            \"category_type\": \"2\",\n            \"category\": \"74\",\n            \"change_3m\": 22.259136212624586,\n            \"change_6m\": 22.259136212624586,\n            \"change_12m\": 22.259136212624586\n        },\n        {\n            \"id\": 228,\n            \"category_type\": \"1\",\n            \"category\": \"17\",\n            \"change_3m\": 21.818181818181817,\n            \"change_6m\": 21.818181818181817,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 228,\n            \"category_type\": \"2\",\n            \"category\": \"167\",\n            \"change_3m\": 21.818181818181817,\n            \"change_6m\": 21.818181818181817,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 229,\n            \"category_type\": \"1\",\n            \"category\": \"7\",\n            \"change_3m\": 0,\n            \"change_6m\": 0,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 229,\n            \"category_type\": \"2\",\n            \"category\": \"197\",\n            \"change_3m\": 0,\n            \"change_6m\": 0,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 230,\n            \"category_type\": \"1\",\n            \"category\": \"11\",\n            \"change_3m\": 0,\n            \"change_6m\": 0,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 230,\n            \"category_type\": \"2\",\n            \"category\": \"159\",\n            \"change_3m\": 0,\n            \"change_6m\": 0,\n            \"change_12m\": 0\n        },\n        {\n            \"id\": 231,\n            \"category_type\": \"1\",\n            \"category\": \"11\",\n            \"change_3m\": -18.29268292682927,\n            \"change_6m\": 0,\n            \"change_12m\": -18.29268292682927\n        },\n        {\n            \"id\": 232,\n            \"category_type\": \"1\",\n            \"category\": \"5\",\n            \"change_3m\": 0,\n            \"change_6m\": 0,\n            \"change_12m\": 22.363636363636363\n        },\n        {\n            \"id\": 232,\n            \"category_type\": \"2\",\n            \"category\": \"213\",\n            \"change_3m\": 0,\n            \"change_6m\": 0,\n            \"change_12m\": 22.363636363636363\n        },\n        {\n            \"id\": 233,\n            \"category_type\": \"1\",\n            \"category\": \"13\",\n            \"change_3m\": 22.282608695652176,\n            \"change_6m\": 22.282608695652176,\n            \"change_12m\": 22.282608695652176\n        },\n        {\n            \"id\": 236,\n            \"category_type\": \"1\",\n            \"category\": \"13\",\n            \"change_3m\": 22.950819672131146,\n            \"change_6m\": 22.950819672131146,\n            \"change_12m\": 22.950819672131146\n        },\n        {\n            \"id\": 239,\n            \"category_type\": \"1\",\n            \"category\": \"8\",\n            \"change_3m\": 0,\n            \"change_6m\": -18.27637444279346,\n            \"change_12m\": -18.27637444279346\n        },\n        {\n            \"id\": 239,\n            \"category_type\": \"2\",\n            \"category\": \"173\",\n            \"change_3m\": 0,\n            \"change_6m\": -18.27637444279346,\n            \"change_12m\": -18.27637444279346\n        },\n        {\n            \"id\": 240,\n            \"category_type\": \"1\",\n            \"category\": \"8\",\n            \"change_3m\": 0,\n            \"change_6m\": 0,\n            \"change_12m\": 0\n        }\n    ],\n    \"results\": 1086174\n}\n\n</code></pre><h1 id=\"categories\">Categories</h1>\n<p>This API endpoint provides you with the list of categories used in categorization of products. We use <a href=\"https://ocrapi.io/\">image to text extraction service</a> to categorize those websites that do not have text.</p>\n<h3 id=\"http-request-2\">HTTP Request</h3>\n<p><code>POST https://www.beststores.io/api.php/records/categories</code></p>\n<h3 id=\"query-parameters-2\">Query Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>query</td>\n<td>string</td>\n<td>text to be categorized</td>\n</tr>\n<tr>\n<td>api_key</td>\n<td>string</td>\n<td>API key</td>\n</tr>\n</tbody>\n</table>\n</div><pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>curl --location --request POST 'https://www.beststores.io/api.php/records/categories' \n\n</code></pre><blockquote>\n<p>The above command returns JSON structured like this:</p>\n</blockquote>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\"records\":[{\"id\":1,\"category_type\":\"category1\",\"category\":\"Vehicles &amp; Parts\"},{\"id\":2,\"category_type\":\"category1\",\"category\":\"Health &amp; Beauty\"},{\"id\":3,\"category_type\":\"category1\",\"category\":\"Toys &amp; Games\"},{\"id\":4,\"category_type\":\"category1\",\"category\":\"Media\"},{\"id\":5,\"category_type\":\"category1\",\"category\":\"Sporting Goods\"},{\"id\":6,\"category_type\":\"category1\",\"category\":\"Arts &amp; Entertainment\"},{\"id\":7,\"category_type\":\"category1\",\"category\":\"Software\"},{\"id\":8,\"category_type\":\"category1\",\"category\":\"Apparel &amp; Accessories\"},{\"id\":9,\"category_type\":\"category1\",\"category\":\"Furniture\"},{\"id\":10,\"category_type\":\"category1\",\"category\":\"Food, Beverages &amp; Tobacco\"},{\"id\":11,\"category_type\":\"category1\",\"category\":\"Hardware\"},{\"id\":12,\"category_type\":\"category1\",\"category\":\"Cameras &amp; Optics\"},{\"id\":13,\"category_type\":\"category1\",\"category\":\"Home &amp; Garden\"},{\"id\":14,\"category_type\":\"category1\",\"category\":\"Business &amp; Industrial\"},{\"id\":15,\"category_type\":\"category1\",\"category\":\"Mature\"},{\"id\":16,\"category_type\":\"category1\",\"category\":\"Baby &amp; Toddler\"},{\"id\":17,\"category_type\":\"category1\",\"category\":\"Office Supplies\"},{\"id\":18,\"category_type\":\"category1\",\"category\":\"Religious &amp; Ceremonial\"},{\"id\":19,\"category_type\":\"category1\",\"category\":\"Electronics\"},{\"id\":20,\"category_type\":\"category1\",\"category\":\"Animals &amp; Pet Supplies\"},{\"id\":21,\"category_type\":\"category1\",\"category\":\"Luggage &amp; Bags\"},{\"id\":22,\"category_type\":\"category2\",\"category\":\"Filing &amp; Organization\"},{\"id\":23,\"category_type\":\"category2\",\"category\":\"Material Handling\"},{\"id\":24,\"category_type\":\"category2\",\"category\":\"Futons\"},{\"id\":25,\"category_type\":\"category2\",\"category\":\"Religious Items\"},{\"id\":26,\"category_type\":\"category2\",\"category\":\"Dentistry\"},{\"id\":27,\"category_type\":\"category2\",\"category\":\"Music &amp; Sound Recordings\"},{\"id\":28,\"category_type\":\"category2\",\"category\":\"Baby Bathing\"},{\"id\":29,\"category_type\":\"category2\",\"category\":\"Mining &amp; Quarrying\"},{\"id\":30,\"category_type\":\"category2\",\"category\":\"Indoor Games\"},{\"id\":31,\"category_type\":\"category2\",\"category\":\"Diaper Bags\"},{\"id\":32,\"category_type\":\"category2\",\"category\":\"Forestry &amp; Logging\"},{\"id\":33,\"category_type\":\"category2\",\"category\":\"Baby Toys &amp; Activity Equipment\"},{\"id\":34,\"category_type\":\"category2\",\"category\":\"Food Service\"},{\"id\":35,\"category_type\":\"category2\",\"category\":\"Optics\"},{\"id\":36,\"category_type\":\"category2\",\"category\":\"Networking\"},{\"id\":37,\"category_type\":\"category2\",\"category\":\"Building Consumables\"},{\"id\":38,\"category_type\":\"category2\",\"category\":\"Desk Pads &amp; Blotters\"},{\"id\":39,\"category_type\":\"category2\",\"category\":\"Baby Gift Sets\"},{\"id\":40,\"category_type\":\"category2\",\"category\":\"Event Tickets\"},{\"id\":41,\"category_type\":\"category2\",\"category\":\"Advertising &amp; Marketing\"},{\"id\":42,\"category_type\":\"category2\",\"category\":\"Pet Supplies\"},{\"id\":43,\"category_type\":\"category2\",\"category\":\"Heating, Ventilation &amp; Air Conditioning\"},{\"id\":44,\"category_type\":\"category2\",\"category\":\"Emergency Preparedness\"},{\"id\":45,\"category_type\":\"category2\",\"category\":\"Lighting\"},{\"id\":46,\"category_type\":\"category2\",\"category\":\"Weapons\"},{\"id\":47,\"category_type\":\"category2\",\"category\":\"Vehicles\"},{\"id\":48,\"category_type\":\"category2\",\"category\":\"Video Game Software\"},{\"id\":49,\"category_type\":\"category2\",\"category\":\"Piercing &amp; Tattooing\"},{\"id\":50,\"category_type\":\"category2\",\"category\":\"Shelving Accessories\"},{\"id\":51,\"category_type\":\"category2\",\"category\":\"Puzzles\"},{\"id\":52,\"category_type\":\"category2\",\"category\":\"Office Furniture\"},{\"id\":53,\"category_type\":\"category2\",\"category\":\"Game Timers\"},...]\n}\n\n</code></pre><h2 id=\"other-apis-and-resources\">Other APIs and resources</h2>\n<p>On topic of Website Categorization: <a href=\"https://medium.com/website-categorization/website-categorization-api-ca6c3e0f6c4d\">What is Website Categorization</a></p>\n<p>Introduction to Voice Search using AI: <a href=\"http://www.aisapiens.net/definitive-guide-to-voice-search-in-2019/\">Definitive guide to Voice Search</a></p>\n<p><a href=\"https://www.unicornseo.com/\">Best keywords research</a></p>\n<p>Sentiment API for blockchain assets: <a href=\"https://www.bittsanalytics.com/cryptocurrency_api.php\">Cryptocurrency Sentiment API</a></p>\n<p>Physik nachhilfe münchen : <a href=\"https://www.boplnachhilfe.de/\">Physik Nachhilfe in München</a></p>\n<h2 id=\"useful-libraries-for-categorization\">Useful libraries for categorization</h2>\n<p><a href=\"https://www.npmtrends.com/websitecategorization\">https://www.npmtrends.com/websitecategorization</a></p>\n<p><a href=\"https://openhub.net/p/websitecategorizationapi\">https://openhub.net/p/websitecategorizationapi</a></p>\n<p><a href=\"https://yarnpkg.com/package/productcategorization\">https://yarnpkg.com/package/productcategorization</a></p>\n<p><a href=\"https://www.npmjs.com/package/productcategorization\">https://www.npmjs.com/package/productcategorization</a></p>\n<p><a href=\"https://yarnpkg.com/package/urldatabase\">https://yarnpkg.com/package/urldatabase</a></p>\n<h1 id=\"errors\">Errors</h1>\n<p>The BittsAnalytics API uses the following error codes:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Error Code</th>\n<th>Meaning</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>400</td>\n<td>Bad Request -- Your request is invalid.</td>\n</tr>\n<tr>\n<td>401</td>\n<td>Unauthorized -- Your API key is wrong.</td>\n</tr>\n<tr>\n<td>406</td>\n<td>Not Acceptable -- You requested a format that isn't json.</td>\n</tr>\n<tr>\n<td>429</td>\n<td>Too Many Requests</td>\n</tr>\n<tr>\n<td>500</td>\n<td>Internal Server Error -- We had a problem with our server. Try again later.</td>\n</tr>\n<tr>\n<td>503</td>\n<td>Service Unavailable -- We're temporarily offline for maintenance. Please try again later.</td>\n</tr>\n</tbody>\n</table>\n</div></body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction to Documentation for the Beststores.io API","slug":"introduction-to-documentation-for-the-beststoresio-api"},{"content":"Authentication","slug":"authentication"},{"content":"Keywords","slug":"keywords"},{"content":"Trends and search volume changes","slug":"trends-and-search-volume-changes"},{"content":"Categories","slug":"categories"},{"content":"Errors","slug":"errors"}],"owner":"18208142","collectionId":"44f50f9d-c5c3-4d99-b4a6-1553de19876b","publishedId":"UzXUQumZ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-10-15T12:49:08.000Z"},"item":[]}