{ "openapi": "3.1.0", "info": { "title": "Taobao and Tmall Shop Detail API (V1)", "version": "v0", "description": "Retrieves a Taobao shop's homepage information, shop categories, and default product listing by seller ID and shop ID. Use it to inspect a shop and discover its categories before querying products." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "Global production API (default)" } ], "tags": [ { "name": "Taobao and Tmall", "description": "Taobao and Tmall marketplace product, review, search, and shop catalog data for commerce intelligence workflows.", "x-platform-id": "taobao-and-tmall", "x-platform-aliases": [ "Taobao", "Tmall", "淘宝", "天猫" ], "x-platform-detection-aliases": [ "Taobao", "Tmall", "淘宝", "天猫" ] } ], "paths": { "/api/taobao/get-shop-detail/v1": { "get": { "tags": [ "Taobao and Tmall" ], "summary": "Shop Detail", "description": "Retrieves a Taobao shop's homepage information, shop categories, and default product listing by seller ID and shop ID. Use it to inspect a shop and discover its categories before querying products.", "operationId": "getApiTaobaoGetShopDetailV1", "parameters": [ { "name": "token", "in": "query", "description": "Access token for this API service.", "required": true, "schema": { "type": "string" } }, { "name": "sellerId", "in": "query", "description": "Taobao seller user ID associated with the shop.", "required": true, "schema": { "type": "string" } }, { "name": "shopId", "in": "query", "description": "Taobao shop ID associated with the seller.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "Invalid request parameters or body", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "Invalid or inactive access token", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "Request rate or daily quota limit exceeded", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "Service temporarily unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "11001840", "x-api-version": "v1", "x-docs-slug": "shop-detail-v1", "x-search-aliases": [ "Taobao shop homepage", "Taobao shop categories", "淘宝店铺详情", "淘宝店铺分类" ], "x-highlights": [ { "type": "tip", "kind": "GUIDANCE", "title": "Shop categories and product queries", "content": "Use the returned shop category IDs as catId in Shop Product List V5. Use V5 for product sorting, filtering, or pagination.", "concept": "shop_category_usage" } ], "x-endpoint-family": "taobao_get_shop_detail" } } } }