tvcmall_openapi
  1. Product
tvcmall_openapi
  • Authorization
    • Get Authorization
      GET
  • Category
    • Get children of the category specified
      GET
    • Get parent of the category specified
      GET
  • Product
    • Search products
      GET
    • Get the details of the specified product
      GET
    • Get status of a list of products
      GET
    • Download the images of the specified product
      GET
    • Download the Scenseimage of the specified product
      GET
    • Search products with specific main category
      GET
    • Get the details of the specified product with images
      GET
  • Order
    • Create order
      POST
    • Get Order List
      GET
    • Get Order Information
      GET
  • Shipping
    • Shipping Calculation
      POST
    • Shipping Calculation Enhancement
      POST
  1. Product

Search products with specific main category

GET
https://openapi.tvc-mall.com/openapi/Product/SearchWithMailCatelog
Last modified:2023-12-15 04:10:45
Maintainer:Alfred.Tvc
Search products with specific main category
There is a subtle difference with regard to search and searchwithmailcatelog api. searchwithmailcatelog is used to search the main category.
One product may belong to multiple categories. One of these categories is the main category.

Request

Query Params
categoryCode
string 
optional
The Code of the category, which you want to search the products within,
Example:
C003700020003
status
integer 
optional

if status <=3 –> ProductStatus = 1; 4 –> ProductStatus > 1

Example:
1
manufacturer
string 
optional
The Manufacturer of the products you want to fetch
Example:
IPAD
ModifiedStart
string 
optional
To fetch the products ever changed since ’GmtModifiedStart’, in the format of MM/dd/yyyy
Example:
10/31/2014
lastProductId
integer 
optional
The biggest ProductId you get in previous request. We strongly suggest you add this to improve the speed of response time.
Example:
1353032
pageSize
integer 
optional
The array size of the products returned, default set to 40, max is 100
Example:
40
Header Params
Authorization
string 
required
Authorization
Example:
2+s8CDVEwkmRHSJ9lorE5Q==

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://openapi.tvc-mall.com/openapi/Product/SearchWithMailCatelog?categoryCode=C003700020003&status=1&manufacturer=IPAD&ModifiedStart=10/31/2014&lastProductId=1353032&pageSize=40' \
--header 'Authorization: 2+s8CDVEwkmRHSJ9lorE5Q=='

Responses

🟢200success
application/json
Body
ProductItemNoList
array [object {7}] 
required
ItemNo
string 
required
ProductId
integer 
required
CatalogCode
string 
required
ProductStatus
integer 
required
1 Normal2 Out of Stock3 Locked4 Pre-sold5 Group-buy
PublishDate
string 
required
StockStatus
integer 
required
1 In stock2 on sale3 In shortage4 out of stock5 5-7 Days7 7-10 Days
Modified
string 
required
Total
integer 
required
pageIndex
integer 
required
pageSize
integer 
required
lastProductId
integer 
required
Example
{
  "ProductItemNoList": [
    {
      "ItemNo": "660171489A",
      "ProductId": 2700722,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:54:25Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T05:59:34Z"
    },
    {
      "ItemNo": "660171488C",
      "ProductId": 2700721,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T14:06:30Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:25Z"
    },
    {
      "ItemNo": "660171488B",
      "ProductId": 2700720,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:50:30Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:25Z"
    },
    {
      "ItemNo": "660171488A",
      "ProductId": 2700719,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:50:30Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:25Z"
    },
    {
      "ItemNo": "660171487G",
      "ProductId": 2700718,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T14:06:30Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:23Z"
    },
    {
      "ItemNo": "660171487F",
      "ProductId": 2700717,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:45:30Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:23Z"
    },
    {
      "ItemNo": "660171487E",
      "ProductId": 2700716,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:45:31Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:23Z"
    },
    {
      "ItemNo": "660171487D",
      "ProductId": 2700715,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:45:31Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:23Z"
    },
    {
      "ItemNo": "660171487C",
      "ProductId": 2700714,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:45:31Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:23Z"
    },
    {
      "ItemNo": "660171487B",
      "ProductId": 2700713,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:45:32Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:23Z"
    },
    {
      "ItemNo": "660171487A",
      "ProductId": 2700712,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:45:32Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:23Z"
    },
    {
      "ItemNo": "680607304C",
      "ProductId": 2700688,
      "CatalogCode": "C006700010003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:18:23Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:36Z"
    },
    {
      "ItemNo": "680607304B",
      "ProductId": 2700687,
      "CatalogCode": "C006700010003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T14:45:32Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:35Z"
    },
    {
      "ItemNo": "680607304A",
      "ProductId": 2700686,
      "CatalogCode": "C006700010003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T14:45:32Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:35Z"
    },
    {
      "ItemNo": "680607303A",
      "ProductId": 2700685,
      "CatalogCode": "C006700010003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T14:45:32Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:54:05Z"
    },
    {
      "ItemNo": "660171486F",
      "ProductId": 2700684,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T14:06:29Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:25Z"
    },
    {
      "ItemNo": "660171486E",
      "ProductId": 2700683,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T14:06:30Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:25Z"
    },
    {
      "ItemNo": "660171486D",
      "ProductId": 2700682,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T14:06:29Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:25Z"
    },
    {
      "ItemNo": "660171486C",
      "ProductId": 2700681,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:28:01Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:25Z"
    },
    {
      "ItemNo": "660171486B",
      "ProductId": 2700680,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:28:01Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:25Z"
    },
    {
      "ItemNo": "660171486A",
      "ProductId": 2700679,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T12:28:02Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T06:45:25Z"
    },
    {
      "ItemNo": "660171485E",
      "ProductId": 2700678,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:16Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171485D",
      "ProductId": 2700677,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:14Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171485C",
      "ProductId": 2700676,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:15Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171485B",
      "ProductId": 2700675,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:15Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171485A",
      "ProductId": 2700674,
      "CatalogCode": "C00370003",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:16Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171484F",
      "ProductId": 2700673,
      "CatalogCode": "C003700060179",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:03Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:37Z"
    },
    {
      "ItemNo": "660171484E",
      "ProductId": 2700672,
      "CatalogCode": "C003700060179",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:03Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:37Z"
    },
    {
      "ItemNo": "660171484D",
      "ProductId": 2700671,
      "CatalogCode": "C003700060179",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:04Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:37Z"
    },
    {
      "ItemNo": "660171484C",
      "ProductId": 2700670,
      "CatalogCode": "C003700060179",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:05Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:37Z"
    },
    {
      "ItemNo": "660171484B",
      "ProductId": 2700669,
      "CatalogCode": "C003700060179",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:04Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:37Z"
    },
    {
      "ItemNo": "660171484A",
      "ProductId": 2700668,
      "CatalogCode": "C003700060179",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:05Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:37Z"
    },
    {
      "ItemNo": "660171483G",
      "ProductId": 2700667,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:17Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171483F",
      "ProductId": 2700666,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:17Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171483E",
      "ProductId": 2700665,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:18Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171483D",
      "ProductId": 2700664,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:18Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171483C",
      "ProductId": 2700663,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:19Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171483B",
      "ProductId": 2700662,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:19Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171483A",
      "ProductId": 2700661,
      "CatalogCode": "C00370044",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:12:20Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:40Z"
    },
    {
      "ItemNo": "660171482F",
      "ProductId": 2700660,
      "CatalogCode": "C003700100126",
      "ProductStatus": 1,
      "PublishDate": "2023-12-04T15:18:23Z",
      "StockStatus": 2,
      "Modified": "2023-12-04T07:33:37Z"
    }
  ],
  "Total": 0,
  "pageIndex": 1,
  "pageSize": 40,
  "lastProductId": 2700660
}
🟢200unauthorized
Modified at 2023-12-15 04:10:45
Previous
Download the Scenseimage of the specified product
Next
Get the details of the specified product with images
Built with