{"info":{"_postman_id":"b0b07fae-e70a-4be9-9528-9a9f364822b0","name":"VueTag API","description":"## Introduction\n\nWelcome to the API documentation for [VueTag](https://vue.ai/vuetag) - the attribute extraction product of Vue.ai. An AI-powered catalog management tool with automated and accurate tags for better product discovery. VueTag also has a web app, which you can sign up [here](https://app.vuetag.ai/signup) to use the functionalities of VueTag. The API and the app mirror the core functions of the product and can be used by customers as deemed fit for their business needs.\n\n## How it works\n\nA high level flow of how VueTag can be used is:\n\n![Flow image](https://hf-files-oregon.s3.amazonaws.com/hdpmsdtech_kb_attachments/2019/02-12/02f87d20-e3d3-465e-9237-9db01a072d01/Screenshot%202019-02-07%2012.19.49.png)\n\n## Available on\n\n* API access is available only on Vuetag Pro accounts. \n* You can refer to [this article](http://support.vuetag.ai/kb/article/41-how-to-use-vuetag-api/) to know how you can access your API key from your Vuetag account. \n* See plans [here](https://vue.ai/automated-product-tagging/pricing.html)\n* You can [Contact us](mailto:support@vuetag.ai) to know what plan you're on.\n\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json"},"item":[{"name":"API End points","item":[{"name":"Tag API","id":"1b7f7a56-a25f-4747-9ef1-0d64bb4d4a1d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"api_key\": \"21250c78a5c2480ba787e110e151667f\",\n  \"image_url\": \"https://i.pinimg.com/736x/65/ef/52/65ef52b0ec7db57eadf70079b0d370c1--green-bodycon-dress-sweater-dresses.jpg\",\n  \"correlation_key\": \"d1d61d5f28064151b4b00aabe657f625\"\n}"},"url":"https://vuetag.madstreetden.com/api/v1/tag","description":"This API returns visual attributes (tags) for the given input image url. The API accepts the following parameters -\n\n\nFields   |   Type    |    Description                |     Condition\n------   |   ----    |    -----------                |     ---------\napi_key   |  string   |   Unique api key per client ([contact us](http://support.vuetag.ai/new) to get access to the API key) |     Mandatory\nimage_url     |  string     |   url of the image to be attributed          |     Mandatory\ncorrelation key     |  string     |   reference key that can be passed to identify each request and compare against response          |     Optional\n\nRefer to the example request and response on the right side. \n\n**Notes:**\n\nStructure of the API response is given below. In this, \n\n* `mad_id ` is the ID assigned to the image by our system and is returned in the response. Users can store this on their end and use it for reference (of an image/product)\n* `message` indicates whether the image has been tagged\n* `processing_time` - time taken for generating the attributes\n* `msd_tags` is the set of tags which are returned for the image. This corresponds to the default dictionary of tags that we use\n* `tags` is the set of tags as per the mapping (optional) of the MSD tags to tags of your choice. \n* `category` or `productType` is the category as identified by our system for the image tagged. Below this is the attributes list for that specific category\n* The confidence score (of the network) of the prediction is returned along with each tag result\n* `object_id` is used when there are multiple categories of products identified in an image which is tagged. Example: `0_msd_4EEF31B4971B429FD55C1997A97CB621B8D5386F_0` could refer to a category - **Tops** and `0_msd_4EEF31B4971B429FD55C1997A97CB621B8D5386F_1` could refer to the **Bottomwear** detected in the image\n\nOutput JSON format - \n\n```\n{\n    \"status\": \"SUCCESS\",\n    \"correlation_key\": \"d1d61d5f28064151b4b00aabe657f625\",\n    \"image_type\": [\n        [\n            \"#FFFFFF\",\n            1\n        ],\n        [\n            \"#F6F6F6\",\n            1\n        ]\n    ],\n    \"meta\": {\n        \"processing_time\": 0.608116865158081,\n        \"total_time\": 0.7349929809570312,\n        \"image_download_time\": 0.12661290168762207\n    },\n    \"image_url\": \"https://i.pinimg.com/736x/65/ef/52/65ef52b0ec7db57eadf70079b0d370c1--green-bodycon-dress-sweater-dresses.jpg\",\n    \"mad_id\": \"4EEF31B4971B429FD55C1997A97CB621B8D5386F\",\n    \"message\": \"Image Tagged Successfully\",\n    \"data\": [\n        {\n            \"category\": [\n                \"dress\",\n                0.883\n            ],\n            \"msd_tags\": {\n                \"DressType\": [\n                    [\n                        \"Sheath\",\n                        0.948,\n                        true\n                    ]\n                ],\n                \"Pattern\": [\n                    [\n                        \"solid\",\n                        1,\n                        true\n                    ]\n                ],\n                \"DressLength\": [\n                    [\n                        \"knee\",\n                        0.456,\n                        true\n                    ]\n                ],\n                \"Neckline\": [\n                    [\n                        \"cowl\",\n                        0.519,\n                        true\n                    ]\n                ],\n                \"SleeveLength\": [\n                    [\n                        \"full\",\n                        0.679,\n                        true\n                    ]\n                ]\n            },\n            \"object_id\": \"0_msd_4EEF31B4971B429FD55C1997A97CB621B8D5386F_0\",\n            \"productType\": [\n                \"Dress\",\n                0.883\n            ],\n            \"tags\": {\n                \"Sleeve Length\": [\n                    [\n                        \"Long Sleeve\",\n                        0.679\n                    ]\n                ],\n                \"Neckline\": [\n                    [\n                        \"Drape/Cowl\",\n                        0.519\n                    ]\n                ],\n                \"Dress Style\": [\n                    [\n                        \"Lace Dress\",\n                        0.992\n                    ],\n                    [\n                        \"Body-Con\",\n                        0.948\n                    ],\n                    [\n                        \"Sheath\",\n                        0.948\n                    ]\n                ],\n                \"Dress Length\": [\n                    [\n                        \"Knee Length\",\n                        0.456\n                    ]\n                ],\n                \"Fabric Pattern\": [\n                    [\n                        \"Solid\",\n                        1\n                    ]\n                ]\n            }\n        }\n    ]\n}\n```"},"response":[{"id":"de5dcf45-dcb4-4f62-b79b-8fa84043c376","name":"Tag API (using image_url)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"api_key\": \"21250c78a5c2480ba787e110e151667f\",\n    \"image_url\": \"https://i.pinimg.com/736x/65/ef/52/65ef52b0ec7db57eadf70079b0d370c1--green-bodycon-dress-sweater-dresses.jpg\",\n    \"correlation_key\": \"d1d61d5f28064151b4b00aabe657f625\"\n}"},"url":"https://vuetag.madstreetden.com/api/v1/tag"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"correlation_key\": \"d1d61d5f28064151b4b00aabe657f625\",\n    \"image_type\": [\n        [\n            \"#FFFFFF\",\n            1\n        ],\n        [\n            \"#F6F6F6\",\n            1\n        ]\n    ],\n    \"meta\": {\n        \"processing_time\": 0.0013890266418457031,\n        \"total_time\": 0.03260207176208496,\n        \"image_download_time\": 0.03090500831604004\n    },\n    \"image_url\": \"https://i.pinimg.com/736x/65/ef/52/65ef52b0ec7db57eadf70079b0d370c1--green-bodycon-dress-sweater-dresses.jpg\",\n    \"mad_id\": \"4EEF31B4971B429FD55C1997A97CB621B8D5386F\",\n    \"message\": \"Image Tagged Successfully\",\n    \"data\": [\n        {\n            \"category\": [\n                \"dress\",\n                0.883\n            ],\n            \"msd_tags\": {\n                \"DressType\": [\n                    [\n                        \"Sheath\",\n                        0.948,\n                        true\n                    ]\n                ],\n                \"Pattern\": [\n                    [\n                        \"solid\",\n                        1,\n                        true\n                    ]\n                ],\n                \"DressLength\": [\n                    [\n                        \"knee\",\n                        0.456,\n                        true\n                    ]\n                ],\n                \"Neckline\": [\n                    [\n                        \"cowl\",\n                        0.519,\n                        true\n                    ]\n                ],\n                \"SleeveLength\": [\n                    [\n                        \"full\",\n                        0.679,\n                        true\n                    ]\n                ]\n            },\n            \"object_id\": \"0_msd_4EEF31B4971B429FD55C1997A97CB621B8D5386F_0\",\n            \"productType\": [\n                \"Dress\",\n                0.883\n            ],\n            \"tags\": {\n                \"Sleeve Length\": [\n                    [\n                        \"Long Sleeve\",\n                        0.679\n                    ]\n                ],\n                \"Neckline\": [\n                    [\n                        \"Drape/Cowl\",\n                        0.519\n                    ]\n                ],\n                \"Dress Style\": [\n                    [\n                        \"Lace Dress\",\n                        0.992\n                    ],\n                    [\n                        \"Body-Con\",\n                        0.948\n                    ],\n                    [\n                        \"Sheath\",\n                        0.948\n                    ]\n                ],\n                \"Dress Length\": [\n                    [\n                        \"Knee Length\",\n                        0.456\n                    ]\n                ],\n                \"Fabric Pattern\": [\n                    [\n                        \"Solid\",\n                        1\n                    ]\n                ]\n            }\n        }\n    ]\n}"}],"_postman_id":"1b7f7a56-a25f-4747-9ef1-0d64bb4d4a1d"},{"name":"Tag API - Using Image Binary","id":"16387ac1-a952-417d-a6f7-cf144c7f4f15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","disabled":true},{"key":"x-mock-response-name","value":"Tag - Success - Product Found"},{"key":"x-api-key","value":"21250c78a5c2480ba787e110e151667f"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","value":null},{"key":"api_key","value":"21250c78a5c2480ba787e110e151667f","type":"text"},{"key":"correlation_key","value":"d1d61d5f28064a151b4b00aabe657f625","type":"text"}]},"url":"https://vuetag.madstreetden.com/api/v1/tag","description":"This is the same as the `/tag` endpoint but instead of sending the `image_url` in the request, users can send the image binary. Refer to the example request on the right."},"response":[{"id":"9e711759-82b3-424e-88ad-6b495b7ce79f","name":"Tag API (using Image Binary)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","disabled":true},{"key":"x-mock-response-name","value":"Tag - Success - Product Found"},{"key":"x-api-key","value":"ed91e96a0fb645419a6a1f3017edc3cb"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","src":"/Users/msd/Desktop/Scribbles/jump_romp/SHEIN-Pink-Pastel-Floral-Lace-Rompers-Womens-Jumpsuit-Sexy-Jumpsuits-High-Waist-Wide-Leg-Applique-See.jpg"},{"key":"api_key","value":"21250c78a5c2480ba787e110e151667f","type":"text"},{"key":"correlation_key","value":"d1d61d5f28064151b4b00aabe657f625","type":"text"}]},"url":"https://df35626e-a909-4f45-8d4d-e79bbbb298fc.mock.pstmn.io/api/v1/tag"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Credentials","value":"","name":"Access-Control-Allow-Credentials","description":"Indicates whether or not the response to the request can be exposed when the credentials flag is true. When used as part of a response to a preflight request, this indicates whether or not the actual request can be made using credentials."},{"key":"Access-Control-Allow-Headers","value":"","name":"Access-Control-Allow-Headers","description":"Used in response to a preflight request to indicate which HTTP headers can be used when making the actual request."},{"key":"Access-Control-Allow-Methods","value":"","name":"Access-Control-Allow-Methods","description":"Specifies the method or methods allowed when accessing the resource. This is used in response to a preflight request."},{"key":"Access-Control-Allow-Origin","value":"*","name":"Access-Control-Allow-Origin","description":"Specifies a URI that may access the resource. For requests without credentials, the server may specify '*' as a wildcard, thereby allowing any origin to access the resource."},{"key":"Access-Control-Expose-Headers","value":"","name":"Access-Control-Expose-Headers","description":"Lets a server whitelist headers that browsers are allowed to access."},{"key":"Connection","value":"keep-alive","name":"Connection","description":"Options that are desired for the connection"},{"key":"Content-Encoding","value":"gzip","name":"Content-Encoding","description":"The type of encoding used on the data."},{"key":"Content-Type","value":"text/html; charset=utf-8","name":"Content-Type","description":"The mime type of this content"},{"key":"Date","value":"Thu, 08 Feb 2018 18:45:32 GMT","name":"Date","description":"The date and time that the message was sent"},{"key":"ETag","value":"W/\"9af-5nFpeSIrvDz2zq6Z40Fr3g\"","name":"ETag","description":"An identifier for a specific version of a resource, often a message digest"},{"key":"Server","value":"nginx","name":"Server","description":"A name for the server"},{"key":"Vary","value":"Accept-Encoding","name":"Vary","description":"Tells downstream proxies how to match future request headers to decide whether the cached response can be used rather than requesting a fresh one from the origin server."},{"key":"X-RateLimit-Limit","value":"60","name":"X-RateLimit-Limit","description":"Custom header"},{"key":"X-RateLimit-Remaining","value":"59","name":"X-RateLimit-Remaining","description":"Custom header"},{"key":"X-RateLimit-Reset","value":"1518115592","name":"X-RateLimit-Reset","description":"Custom header"},{"key":"transfer-encoding","value":"chunked","name":"transfer-encoding","description":"The form of encoding used to safely transfer the entity to the user. Currently defined methods are: chunked, compress, deflate, gzip, identity."}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"correlation_key\": \"d1d61d5f28064a151b4b00aabe657f625\",\n    \"image_type\": [\n        [\n            \"#D4D5D6\",\n            1\n        ],\n        [\n            \"#D4D5D6\",\n            1\n        ]\n    ],\n    \"meta\": {\n        \"processing_time\": 0.9619359970092773,\n        \"total_time\": 0.9822461605072021,\n        \"image_download_time\": 0.019932031631469727\n    },\n    \"image_url\": \"\",\n    \"mad_id\": \"DB799BD7-5A2A-4F56-94C9-64C37447E390\",\n    \"message\": \"Image Tagged Successfully\",\n    \"data\": [\n        {\n            \"category\": [\n                \"outerwear\",\n                0.914\n            ],\n            \"msd_tags\": {},\n            \"object_id\": \"0_msd_DB799BD7-5A2A-4F56-94C9-64C37447E390_0\",\n            \"productType\": [\n                \"Blazer\",\n                0.914\n            ],\n            \"tags\": {}\n        }\n    ]\n}"}],"_postman_id":"16387ac1-a952-417d-a6f7-cf144c7f4f15"},{"name":"Tag API (with product metadata)","id":"b0310917-e5ec-4414-a5dd-05c1f5b37837","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\"api_key\": \"f88cb3cc3d45df6521581a570c512420a79c3d07\",\n\"image_url\" : \"http://dieseldamtest.chalco.net/Test_Image_madstreetden/00S0KW_00MXZ.jpg\",\n\"product_matadata\":{\n            \"ID\":1076981,\n            \"Product_Code\":\"00S0KW00MXZ\",\n            \"Model_Code\":\"00S0KW\",\n            \"Fabric\":\"00MXZ\",\n            \"Season\":\"SS 2017\",\n            \"ImageName\":\"DIESEL_SS17_24_01_17.000181T_SN057089_CLOSEUP01_WEB.jpg\",\n            \"Creative_Theme\":\"\",\n            \"Gender\":\"Male\",\n            \"Model_Name\":\"T-FREE\",\n            \"Fit\":\"\",\n            \"Family\":\"\",\n            \"Style\":\"\",\n            \"Product_Main_Group\":\"Apparel\",\n            \"Product_Group\":\"Polos\",\n            \"Age_Range\":\"\",\n            \"Made_In\":\"CHINA\",\n            \"Size_Scale\":\"Jackets - Generic\"\n    }\n}"},"url":"https://vuetag-dev.madstreetden.com/pocclient/api/v1/tag","description":"Users can optionally supply product information from their database of products. Like this, \n\nFields   |   Type    |    Description                |     Condition\n------   |   ----    |    -----------                |     ---------\napi_key   |  string   |   Unique api key per client ([contact us](http://support.vuetag.ai/new) to get access to the API key) |     Mandatory\nimage_url     |  string     |   url of the image to be attributed          |     Mandatory\ncorrelation key     |  string     |   reference key that can be passed to identify each request and compare against response          |     Optional\nproduct_metadata | dict | To send information like `product_id` | Optional\n\nIn the response, `location` indicates the coordinates of the ROI in the image from where the object has been picked.\n\n```\nlocation\": [\n                103,\n                23,\n                672,\n                1156\n            ]\n```\n"},"response":[{"id":"cd4b8a3a-1d1c-4b35-a63f-17167ade0b00","name":"Tag API (with product metadata)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\"api_key\": \"b983fcda452f33e1888a233be898d740d272a528\",\n\"image_url\" : \"https://cdn.shopify.com/s/files/1/1708/7943/products/26306_copyright_reddressboutique_2017.jpg?v=1517349774322\",\n\"product_metadata\" : {\n    \"id\" : \"EXT_53424\"\n}\n}"},"url":"https://vuetag.madstreetden.com/api/v1/tag"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 12 Feb 2019 12:33:20 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"2204"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"WSGIServer/0.1 Python/2.7.12"},{"key":"X-Frame-Options","value":"SAMEORIGIN"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"correlation_key\": null,\n    \"image_type\": {\n        \"BGColor\": [\n            \"#E1BE9A\",\n            1\n        ],\n        \"BGColorNew\": [\n            \"#F2CFAA\",\n            1\n        ]\n    },\n    \"meta\": {\n        \"processing_time\": 0.003401041030883789,\n        \"total_time\": 0.04678702354431152,\n        \"image_download_time\": 0.042962074279785156\n    },\n    \"image_url\": \"https://cdn.shopify.com/s/files/1/1708/7943/products/26306_copyright_reddressboutique_2017.jpg?v=1517349774322\",\n    \"mad_id\": \"9DD01A57A6018FF0D934F864C49B93EC771202FB\",\n    \"message\": \"Image Tagged Successfully\",\n    \"data\": [\n        {\n            \"category\": [\n                \"Dresses\",\n                0.92\n            ],\n            \"tags\": {\n                \"Base Color\": [\n                    [\n                        \"Orange\",\n                        0.9780454217817691\n                    ]\n                ],\n                \"Description\": [\n                    [\n                        \"An excellent choice, this dresss has beautiful detailing that won't blend in but stand out from the crowd. Boasts a stylish crewnecks. This style is officially back on the fashion map. Light up the room on your next big night out in this 'wow'-worthy dress. Dress it up with mid calf boots and a shoulder bags.\",\n                        1\n                    ]\n                ],\n                \"Color Hex\": [\n                    [\n                        \"#FF3300\",\n                        0.9780454217817691\n                    ]\n                ],\n                \"Color\": [\n                    [\n                        \"orangered\",\n                        0.9780454217817691\n                    ]\n                ],\n                \"Pattern\": [\n                    [\n                        \"Colorblock\",\n                        0.978\n                    ]\n                ],\n                \"Style & Occasion\": [\n                    [\n                        \"Chic\",\n                        0.774\n                    ],\n                    [\n                        \"Party\",\n                        0.485\n                    ]\n                ],\n                \"Neckline\": [\n                    [\n                        \"Crewneck\",\n                        0.494\n                    ]\n                ],\n                \"Title\": [\n                    [\n                        \"A-line dress\",\n                        1\n                    ]\n                ],\n                \"Sleeve Length\": [\n                    [\n                        \"3-4th Sleeve\",\n                        0.859\n                    ]\n                ],\n                \"Type\": [\n                    [\n                        \"A-Line\",\n                        0.748\n                    ]\n                ],\n                \"Dress Length\": [\n                    [\n                        \"Thigh Length\",\n                        0.993\n                    ]\n                ]\n            },\n            \"msd_tags\": {\n                \"Base Color\": [\n                    [\n                        \"Orange\",\n                        0.9780454217817691\n                    ]\n                ],\n                \"Description\": [\n                    [\n                        \"An excellent choice, this dresss has beautiful detailing that won't blend in but stand out from the crowd. Boasts a stylish crewnecks. This style is officially back on the fashion map. Light up the room on your next big night out in this 'wow'-worthy dress. Dress it up with mid calf boots and a shoulder bags.\",\n                        1\n                    ]\n                ],\n                \"Color Hex\": [\n                    [\n                        \"#FF3300\",\n                        0.9780454217817691\n                    ]\n                ],\n                \"Color\": [\n                    [\n                        \"orangered\",\n                        0.9780454217817691\n                    ]\n                ],\n                \"Pattern\": [\n                    [\n                        \"Colorblock\",\n                        0.978\n                    ]\n                ],\n                \"Style & Occasion\": [\n                    [\n                        \"Chic\",\n                        0.774\n                    ],\n                    [\n                        \"Party\",\n                        0.485\n                    ]\n                ],\n                \"Neckline\": [\n                    [\n                        \"Crewneck\",\n                        0.494\n                    ]\n                ],\n                \"Title\": [\n                    [\n                        \"A-line dress\",\n                        1\n                    ]\n                ],\n                \"Sleeve Length\": [\n                    [\n                        \"3-4th Sleeve\",\n                        0.859\n                    ]\n                ],\n                \"Type\": [\n                    [\n                        \"A-Line\",\n                        0.748\n                    ]\n                ],\n                \"Dress Length\": [\n                    [\n                        \"Thigh Length\",\n                        0.993\n                    ]\n                ]\n            },\n            \"object_id\": \"0_msd_9DD01A57A6018FF0D934F864C49B93EC771202FB_0\",\n            \"location\": [\n                103,\n                23,\n                672,\n                1156\n            ],\n            \"productType\": [\n                \"Dresses\",\n                0.92\n            ]\n        }\n    ]\n}"}],"_postman_id":"b0310917-e5ec-4414-a5dd-05c1f5b37837"},{"name":"Tag API (with multiple images)","id":"573d4648-f3e6-4a5f-8a5e-cf04b8f5dcc6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\"api_key\": \"653470c8174adbdefe599bad41e7ed379ca557bc\",\n\"image_url\" : [\"https://images-na.ssl-images-amazon.com/images/I/91mrpw%2B%2B9rL._UL1500_.jpg\",\"https://images-na.ssl-images-amazon.com/images/I/91xjO3oOBzL._UY879_.jpg\"]\n}"},"url":"https://vuetag.madstreetden.com/api/v1/tag","description":"Users can optionally supply multiple images for each product. The `image_urls` is to be provided in a list. Like this, \n\nFields   |   Type    |    Description                |     Condition\n------   |   ----    |    -----------                |     ---------\napi_key   |  string   |   Unique api key per client ([contact us](http://support.vuetag.ai/new) to get access to the API key) |     Mandatory\nimage_url     |  list of strings     |  list of image urls of the product to be attributed          |     Mandatory\ncorrelation key     |  string     |   reference key that can be passed to identify each request and compare against response          |     Optional\n\n**Notes**:\n\n- Currently, we only use the first image in the list for the purpose of tagging. In the coming months, the multiple images for a product will be used for tagging various attributes and the results will be reconciled\n- The VueTag app currently does not support display of the multiple images for a product. This is in the roadmap for the product."},"response":[{"id":"333b66f1-0db1-407d-a0b6-f4bbe1f0499d","name":"Tag API (with multiple images)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\"api_key\": \"653470c8174adbdefe599bad41e7ed379ca557bc\",\n\"image_url\" : [\"https://images-na.ssl-images-amazon.com/images/I/91mrpw%2B%2B9rL._UL1500_.jpg\",\"https://images-na.ssl-images-amazon.com/images/I/91xjO3oOBzL._UY879_.jpg\"]\n}"},"url":"https://vuetag.madstreetden.com/api/v1/tag"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 18 Feb 2019 06:35:15 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"1417"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"WSGIServer/0.1 Python/2.7.12"},{"key":"X-Frame-Options","value":"SAMEORIGIN"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"correlation_key\": null,\n    \"image_type\": {\n        \"BGColor\": [\n            \"#FFFFFF\",\n            1\n        ],\n        \"BGColorNew\": [\n            \"#F6F6F6\",\n            1\n        ]\n    },\n    \"meta\": {\n        \"processing_time\": 0.9079668521881104,\n        \"total_time\": 0.9537060260772705,\n        \"image_download_time\": 0.04542398452758789\n    },\n    \"image_url\": [\n        \"https://images-na.ssl-images-amazon.com/images/I/91mrpw%2B%2B9rL._UL1500_.jpg\",\n        \"https://images-na.ssl-images-amazon.com/images/I/91xjO3oOBzL._UY879_.jpg\"\n    ],\n    \"mad_id\": \"992E5F9DDD14D9681A03043329FB540709D2E0EE\",\n    \"message\": \"Image Tagged Successfully\",\n    \"data\": [\n        {\n            \"category\": [\n                \"Jackets\",\n                0.593\n            ],\n            \"tags\": {\n                \"Color\": [\n                    [\n                        \"white\",\n                        0.45579041284992394\n                    ],\n                    [\n                        \"lavender\",\n                        0.3570377950955645\n                    ],\n                    [\n                        \"darkslateblue\",\n                        0.1871717920545116\n                    ]\n                ],\n                \"Sleeve Length\": [\n                    [\n                        \"Long Sleeve\",\n                        0.717\n                    ]\n                ],\n                \"Jacket Length\": [\n                    [\n                        \"Short\",\n                        0.997\n                    ]\n                ],\n                \"Base Color\": [\n                    [\n                        \"White\",\n                        1\n                    ]\n                ],\n                \"Color Hex\": [\n                    [\n                        \"#F5F6F8\",\n                        0.45579041284992394\n                    ],\n                    [\n                        \"#A4A2B8\",\n                        0.3570377950955645\n                    ],\n                    [\n                        \"#3E3A5B\",\n                        0.1871717920545116\n                    ]\n                ]\n            },\n            \"msd_tags\": {\n                \"Color\": [\n                    [\n                        \"white\",\n                        0.45579041284992394\n                    ],\n                    [\n                        \"lavender\",\n                        0.3570377950955645\n                    ],\n                    [\n                        \"darkslateblue\",\n                        0.1871717920545116\n                    ]\n                ],\n                \"Sleeve Length\": [\n                    [\n                        \"Long Sleeve\",\n                        0.717\n                    ]\n                ],\n                \"Jacket Length\": [\n                    [\n                        \"Short\",\n                        0.997\n                    ]\n                ],\n                \"Base Color\": [\n                    [\n                        \"White\",\n                        1\n                    ]\n                ],\n                \"Color Hex\": [\n                    [\n                        \"#F5F6F8\",\n                        0.45579041284992394\n                    ],\n                    [\n                        \"#A4A2B8\",\n                        0.3570377950955645\n                    ],\n                    [\n                        \"#3E3A5B\",\n                        0.1871717920545116\n                    ]\n                ]\n            },\n            \"object_id\": \"972_msd-internal20_992E5F9DDD14D9681A03043329FB540709D2E0EE_0\",\n            \"location\": [\n                169,\n                36,\n                962,\n                1081\n            ],\n            \"productType\": [\n                \"Jackets\",\n                0.593\n            ]\n        }\n    ]\n}"}],"_postman_id":"573d4648-f3e6-4a5f-8a5e-cf04b8f5dcc6"},{"name":"Feedback API","id":"bcfcf05d-d879-4dcc-bb91-328fe85bf7ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"api_key\": \"{{api_key}}\",\n    \"correlation_key\": \"d1d61d5f28064151b4b00aabe657f625\",\n    \"feedback\": {\n        \"image_url\": [\n            \"https://images-cdn.vuetag.ai/2234_migration/957a4aa77a85c958817e46a73b42681f31998ff02e57676659e8689d318dc6e2512X512.jpg\"\n        ],\n        \"mad_id\": \"350b77db-4997-537c-b6c4-e2e77eca1ca0\",\n        \"data\": [\n            {\n                \"tags\": {\n                    \"Sleeve Length\": [\n                        {\n                            \"value\": \"Sleeveless\"\n                        }\n                    ],\n                    \"Primary Pattern\": [\n                        {\n                            \"value\": \"Lines\"\n                        }\n                    ],\n                    \"Secondary Pattern\": [\n                        {\n                            \"value\": \"Checks\"\n                        }\n                    ],\n                    \"Features\": [\n                        {\n                            \"value\": \"Crochet / Lace\"\n                        }\n                    ],\n                    \"Base Color\": [\n                        {\n                            \"value\": \"Black\"\n                        }\n                    ]\n                },\n                \"productType\": {\n                    \"value\": \"Blazers\"\n                }\n            }\n        ]\n    }\n}"},"url":"https://vuetag.madstreetden.com/api/v1/feedback","description":"This API receives feedback from the user for reponses given by the tag API.\n\n\nFields   |   Type    |    Description                |     Condition\n------   |   ----    |    -----------                |     ---------\napi_key   |  string   |   Unique api key per client  |     Mandatory\nfeedback     |  dict     |   JSON with the structure the same as the response returned by the tag API, but with corrected data.          |     Mandatory\ncorrelation_key     |  string     |   correlation key to be sent back in the response           |     Mandatory\nuser_id  |  string  | (optional) unique user_id of user sending feedback  | Optional"},"response":[{"id":"ef18a9ea-169a-4c20-ad7d-33d54bcbdfec","name":"Feedback API","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"api_key\": \"{{api_key}}\",\n    \"correlation_key\": \"d1d61d5f28064151b4b00aabe657f625\",\n    \"feedback\": {\n        \"image_url\": [\n            \"https://images-cdn.vuetag.ai/2234_migration/957a4aa77a85c958817e46a73b42681f31998ff02e57676659e8689d318dc6e2512X512.jpg\"\n        ],\n        \"mad_id\": \"350b77db-4997-537c-b6c4-e2e77eca1ca0\",\n        \"data\": [\n            {\n                \"tags\": {\n                    \"Sleeve Length\": [\n                        {\n                            \"value\": \"Sleeveless\"\n                        }\n                    ],\n                    \"Primary Pattern\": [\n                        {\n                            \"value\": \"Lines\"\n                        }\n                    ],\n                    \"Secondary Pattern\": [\n                        {\n                            \"value\": \"Checks\"\n                        }\n                    ],\n                    \"Features\": [\n                        {\n                            \"value\": \"Crochet / Lace\"\n                        }\n                    ],\n                    \"Base Color\": [\n                        {\n                            \"value\": \"Black\"\n                        }\n                    ]\n                },\n                \"productType\": {\n                    \"value\": \"Blazers\"\n                }\n            }\n        ]\n    }\n}"},"url":"https://vuetag.madstreetden.com/api/v1/feedback"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 12 Feb 2019 18:40:48 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"281"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"WSGIServer/0.1 Python/2.7.12"},{"key":"X-Frame-Options","value":"SAMEORIGIN"}],"cookie":[],"responseTime":null,"body":"{\n    \"mad_id\": \"144cfa468bd74b6889e9bee143ff4762\",\n    \"status\": \"SUCCESS\",\n    \"message\": \"Feedback Received\",\n    \"image_url\": [\n        \"https://i.pinimg.com/736x/65/ef/52/65ef52b0ec7db57eadf70079b0d370c1--green-bodycon-dress-sweater-dresses.jpg\"\n    ],\n    \"correlation_key\": \"d1d61d5f28064151b4b00aabe657f625\"\n}"}],"_postman_id":"bcfcf05d-d879-4dcc-bb91-328fe85bf7ab"},{"name":"Async put_tag API","id":"106ec344-3e49-4cbe-8124-890bc6fdca0c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"api_key\": \"653470c8174adbdefe599bad41e7ed379ca557bc\",\n  \"image_url\": \"https://proxy.duckduckgo.com/iu/?u=https%3A%2F%2Fimg.promgirl.com%2F_img%2FPGPRODUCTS%2F1548614%2F1000%2Fred-dress-MT-7418-1-a.jpg&f=1\",\n  \"correlation_key\": \"140520191047\"\n}"},"url":"https://vuetag.madstreetden.com/api/v1/put_tag","description":"`put_tag` is an asynchronous API that accepts requests with input image (image_url or binary image or product metadata). The corresponding `get_tag` API returns visual attributes (tags) for the given input image url or binary image or product_metadata. \n\nThe `put_tag` API accepts requests in the following modes - \n\nMode 1. Put tag request for a image / image_url / product_metadata. This generates and sends back in `mad_id` in the repsponse, that can be used with the `get_tag` API to return tags later.\n\nMode 2. (Not supported currently) - Accept a batch input of images that will be tagged asynchronously. This will generate and return a list of mad_ids.\n\nThe API accepts the following parameters -\n\nFields   |   Type    |    Description                |     Condition\n------   |   ----    |    -----------                |     ---------\napi_key   |  string   |   Unique api key per client  |     Mandatory\nimage_url     |  string or list    |   url or list of urls of the images to be attributed          |     Conditionally Mandatory\nimage     |  file     |   the image to be attributed as a binary          |     Conditionally Mandatory\ncorrelation key     |  string     |   client correlation key to be sent back in the response          |     Optional\nproduct_metadata  |  dict    |  Extra fields that might need to be passed. This can include metadata fields that should be agreed to be received by the API.  | Optional\n\nNote 1: image_url and image are conditionally mandatory for mode 1 - one of the two are necessary. If product_metadata is being passed in the API which has the image_url, then the API can be customized to use it.\n\nSample (Json) Input Format - \n```\n{\n  \"api_key\": \"3ff2fa395a884b838fcc5d586ab78434\",\n  \"image_url\": \"http://dieseldamtest.chalco.net/Test_Image_madstreetden/00SBHI_0GARN.jpg\",\n  \"correlation_key\": \"d1d61d5f28064151b4b00aabe657f625\"\n}\n```\n\nOutput (Json) format - \n```\n{\n    \"mad_id\": \"00SBHI0GARN\",\n    \"image_url\": \"http://dieseldamtest.chalco.net/Test_Image_madstreetden/00SBHI_0GARN.jpg\",\n    \"correlation_key\": \"d1d61d5f28064151b4b00aabe657f625\"\n}\n```"},"response":[],"_postman_id":"106ec344-3e49-4cbe-8124-890bc6fdca0c"},{"name":"Async get_tag API","id":"35a9c98e-0fa0-4aff-a5a8-4724b8277e45","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"api_key\": \"653470c8174adbdefe599bad41e7ed379ca557bc\",\n  \"mad_id\" : \"57161B2B55B8001B7138C74D7B103397F4FE7E20\"\n}"},"url":"https://vuetag.madstreetden.com/api/v1/get_tag","description":"`put_tag` is an asynchronous API that accepts requests with input image (image_url or binary image or product metadata). The corresponding `get_tag` API returns visual attributes (tags) for the given input image url or binary image or product_metadata. \n\nThe `get_tag` API accepts the following parameters - \n\nThe API accepts the following parameters -\n\nFields   |   Type    |    Description                |     Condition\n------   |   ----    |    -----------                |     ---------\napi_key   |  string   |   Unique api key per client  |     Mandatory\nmad_id     |  string     |   mad_id returned by the put_tag API  |     Mandatory\nextras  |  dict    |  (optional) extra additional fields that might need to be passed.  | Optional"},"response":[{"id":"7ddc7e97-344e-43dc-b8fa-c6139eda360b","name":"Async get_tag API","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"api_key\": \"653470c8174adbdefe599bad41e7ed379ca557bc\",\n  \"mad_id\" : \"57161B2B55B8001B7138C74D7B103397F4FE7E20\"\n}"},"url":"https://vuetag.madstreetden.com/api/v1/get_tag"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 15 May 2019 03:25:19 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"1886"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"WSGIServer/0.1 Python/2.7.12"},{"key":"X-Frame-Options","value":"SAMEORIGIN"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"correlation_key\": \"140520191047\",\n    \"image_type\": {\n        \"BGColor\": [\n            \"#676869\",\n            1\n        ],\n        \"BGColorNew\": [\n            \"#767678\",\n            1\n        ]\n    },\n    \"meta\": {\n        \"processing_time\": 0.8413658142089844,\n        \"image_download_time\": 0.2228868007659912\n    },\n    \"image_url\": \"https://images-cdn.vuetag.ai/972_msd-internal20/972_msd-internal20_57161B2B55B8001B7138C74D7B103397F4FE7E20.jpg\",\n    \"mad_id\": \"57161B2B55B8001B7138C74D7B103397F4FE7E20\",\n    \"message\": \"Image Tagged Successfully - Product Found\",\n    \"data\": [\n        {\n            \"category\": [\n                \"Dresses\",\n                0.823\n            ],\n            \"taggedat\": \"2019-05-15 03:25:19 UTC\",\n            \"tags\": {\n                \"Base Color\": [\n                    [\n                        \"Pink\",\n                        0.6922400775777601\n                    ],\n                    [\n                        \"Grey\",\n                        0.2156393072054129\n                    ]\n                ],\n                \"Color Hex\": [\n                    [\n                        \"#D50030\",\n                        0.6922400775777601\n                    ],\n                    [\n                        \"#777678\",\n                        0.2156393072054129\n                    ]\n                ],\n                \"Color\": [\n                    [\n                        \"crimson\",\n                        0.6922400775777601\n                    ],\n                    [\n                        \"gray/grey\",\n                        0.2156393072054129\n                    ]\n                ],\n                \"Pattern\": [\n                    [\n                        \"Solid\",\n                        0.026\n                    ],\n                    [\n                        \"Graphic\",\n                        0.013\n                    ]\n                ],\n                \"Style & Occasion\": [\n                    [\n                        \"Chic\",\n                        0.905\n                    ],\n                    [\n                        \"Party\",\n                        0.698\n                    ]\n                ],\n                \"Neckline\": [\n                    [\n                        \"V Neck\",\n                        0.551\n                    ]\n                ],\n                \"Sleeve Length\": [\n                    [\n                        \"Sleeveless\",\n                        0.648\n                    ]\n                ],\n                \"Type\": [\n                    [\n                        \"Fit Flare\",\n                        0.799\n                    ]\n                ],\n                \"Dress Length\": [\n                    [\n                        \"Thigh Length\",\n                        0.464\n                    ]\n                ]\n            },\n            \"msd_tags\": {\n                \"Base Color\": [\n                    [\n                        \"Pink\",\n                        0.6922400775777601\n                    ],\n                    [\n                        \"Grey\",\n                        0.2156393072054129\n                    ]\n                ],\n                \"Color Hex\": [\n                    [\n                        \"#D50030\",\n                        0.6922400775777601\n                    ],\n                    [\n                        \"#777678\",\n                        0.2156393072054129\n                    ]\n                ],\n                \"Color\": [\n                    [\n                        \"crimson\",\n                        0.6922400775777601\n                    ],\n                    [\n                        \"gray/grey\",\n                        0.2156393072054129\n                    ]\n                ],\n                \"Pattern\": [\n                    [\n                        \"Solid\",\n                        0.026\n                    ],\n                    [\n                        \"Graphic\",\n                        0.013\n                    ]\n                ],\n                \"Style & Occasion\": [\n                    [\n                        \"Chic\",\n                        0.905\n                    ],\n                    [\n                        \"Party\",\n                        0.698\n                    ]\n                ],\n                \"Neckline\": [\n                    [\n                        \"V Neck\",\n                        0.551\n                    ]\n                ],\n                \"Sleeve Length\": [\n                    [\n                        \"Sleeveless\",\n                        0.648\n                    ]\n                ],\n                \"Type\": [\n                    [\n                        \"Fit Flare\",\n                        0.799\n                    ]\n                ],\n                \"Dress Length\": [\n                    [\n                        \"Thigh Length\",\n                        0.464\n                    ]\n                ]\n            },\n            \"object_id\": \"972_msd-internal20_57161B2B55B8001B7138C74D7B103397F4FE7E20_0\",\n            \"url\": \"https://images-cdn.vuetag.ai/972_msd-internal20/972_msd-internal20_57161B2B55B8001B7138C74D7B103397F4FE7E20.jpg\",\n            \"location\": [\n                76,\n                76,\n                901,\n                1561\n            ],\n            \"productType\": [\n                \"Dresses\",\n                0.823\n            ],\n            \"product_code\": \"57161B2B55B8001B7138C74D7B103397F4FE7E20\"\n        }\n    ]\n}"}],"_postman_id":"35a9c98e-0fa0-4aff-a5a8-4724b8277e45"}],"id":"f65704ba-6cb3-4041-a90d-2bb558e8c942","event":[{"listen":"prerequest","script":{"id":"5d59187b-b920-4f20-a332-56d7a7724101","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"23e2dbd8-a7a6-4506-826f-dae165bc3ed3","type":"text/javascript","exec":[""]}}],"_postman_id":"f65704ba-6cb3-4041-a90d-2bb558e8c942"}],"event":[{"listen":"prerequest","script":{"id":"c8a02aaf-d28d-4e62-ad05-14065753dad4","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"06724804-8b82-4e68-bde0-31d12a804de9","type":"text/javascript","exec":[""]}}]}