1. Product
SUNSKY Open API
  • SUNSKY Open API
    • Common Calling Convention
    • Callback Hooks
    • Appendixes
    • Category
      • Get the children of the category
    • Product
      • Search products
        POST
      • Get the product details
        POST
      • Download the product images
        POST
      • Get the image changelist
        POST
    • Order
      • Get the country list for shipping
      • Get the prices and the shipping costs for the items
      • Create an order
      • Get the order details
      • Search orders
      • Add labels to the order
      • Get the labels for the order
    • Account
      • Check your balance on SUNSKY
      • Get your balance history
    • Stats
      • Get the hot items
    • Coupon
      • Get the coupon list
  1. Product

Search products

POST
https://open.sunsky-online.com/openapi/product!search.do
This API return the products which match the conditions you specified.

HINT: How to get the changed products?#

1.
Before calling the search API, load the previously saved time T0 from db/file;
2.
Call the search API with gmtModifiedStart=T0, it'll return the products that ever changed since T0;
3.
Get the max gmtModified among the products as T, then save T to db/file;
4.
If T equals T0, then increase the page number, else update T0 to T and reset the page number to 1;
5.
Repeat step 2~5 until the search API returns no data or the current page number is smaller than the page count;

Request

Body Params application/x-www-form-urlencodedRequired

Request Code 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 POST 'https://open.sunsky-online.com/openapi/product!search.do' \
--data-urlencode 'key=' \
--data-urlencode 'signature=' \
--data-urlencode 'lang=en' \
--data-urlencode 'categoryId=123' \
--data-urlencode 'pageSize=100' \
--data-urlencode 'page=1' \
--data-urlencode 'gmtModifiedStart=0/31/2013 01:23:20' \
--data-urlencode 'status=-1' \
--data-urlencode 'brandName=Apple' \
--data-urlencode 'leadTimeLevel=5'

Responses

🟢200
application/json
Successful response
Body

Example
{
    "result": "success",
    "data": {
        "result": [
            {
                "unitWeight": "0.071",
                "unitWidth": 120,
                "gmtListed": "12/25/2021 14:55:57",
                "gmtModified": "03/12/2025 06:18:54",
                "modelList": [
                    {
                        "key": "TBD0601904301A",
                        "value": "White"
                    },
                    {
                        "key": "TBD0601904301B",
                        "value": "Yellow"
                    },
                    {
                        "key": "TBD0601904301C",
                        "value": "Blue"
                    },
                    {
                        "key": "TBD0601904301D",
                        "value": "Green"
                    },
                    {
                        "key": "TBD0601904301E",
                        "value": "Black"
                    },
                    {
                        "key": "TBD0601904301F",
                        "value": "Pink"
                    }
                ],
                "description": "<br>1. One light and three colors, breathing gradually<br>2. Voltage: about 3V<br>3. Current: about 0.07A<br>4. Power: 0.2W<br>5. Scope of application: parties, concerts, parties, etc.<br>6. Material: PVC<br>7. Luminous flux: 1000lm<br>8. Power supply mode: built-in button battery<br>9. Life: 48 hours<br>10. Protection level: IP42<br>11. How to use: Turn on the power switch to light up<br>12. Size: 30 x 25mm<br>13. Weight: about 11g",
                "itemNo": "TBD0601904301A",
                "moq": 1,
                "packLength": 500,
                "containsBattery": true,
                "priceList": [
                    {
                        "key": 1,
                        "value": "2.64"
                    },
                    {
                        "key": 2,
                        "value": "2.61"
                    },
                    {
                        "key": 10,
                        "value": "2.59"
                    },
                    {
                        "key": 20,
                        "value": "2.56"
                    },
                    {
                        "key": 50,
                        "value": "2.53"
                    },
                    {
                        "key": 100,
                        "value": "2.51"
                    },
                    {
                        "key": 200,
                        "value": "2.48"
                    }
                ],
                "unitHeight": 60,
                "unitLength": 120,
                "videoUrl": "https://www.youtube.com/embed/7Eg1YqOwBu0",
                "price": "2.6400",
                "oem": false,
                "paramsTable": "<div class=\"params_begin\">Specification:<\/div>\r\n<div style=\"border-top: 1px solid #e0e0e0;\">\r\n<table border=\"0\" style=\"margin-bottom: 0;\">\r\n  <tr>\r\n\t<td style=\"border: none; padding: 5px; width: 15%;\">\r\n\t\t\tPackage Weight\r\n\t\t<\/td>\r\n\t<td style=\"border: none; padding: 0;\">\r\n\t\t\t<div style=\"border-bottom: 1px dashed #e0e0e0;\">\r\n\t\t  <table border=\"0\" style=\"margin-bottom: 0;\">\r\n\t\t\t<tr>\r\n\t\t\t\t\t<td style=\"border: none; padding: 5px; width: 25%;\">One Package Weight<\/td>\r\n\t\t\t<td style=\"border: none; padding: 5px;\">\r\n\t\t\t\t0.07kgs / 0.16lb\r\n\t\t\t<\/td>\r\n\t\t\t\t\t<\/tr>\r\n\t\t  <\/table>\r\n\t\t<\/div>\r\n\t\t\t<div style=\"border-bottom: 1px dashed #e0e0e0;\">\r\n\t\t  <table border=\"0\" style=\"margin-bottom: 0;\">\r\n\t\t\t<tr>\r\n\t\t\t\t\t<td style=\"border: none; padding: 5px; width: 25%;\">One Package Size<\/td>\r\n\t\t\t<td style=\"border: none; padding: 5px;\">\r\n\t\t\t\t12cm * 12cm * 6cm / 4.72inch * 4.72inch * 2.36inch\r\n\t\t\t<\/td>\r\n\t\t\t\t\t<\/tr>\r\n\t\t  <\/table>\r\n\t\t<\/div>\r\n\t\t\t<div style=\"border-bottom: 1px dashed #e0e0e0;\">\r\n\t\t  <table border=\"0\" style=\"margin-bottom: 0;\">\r\n\t\t\t<tr>\r\n\t\t\t\t\t<td style=\"border: none; padding: 5px; width: 25%;\">Qty per Carton<\/td>\r\n\t\t\t<td style=\"border: none; padding: 5px;\">\r\n\t\t\t\t288\r\n\t\t\t<\/td>\r\n\t\t\t\t\t<\/tr>\r\n\t\t  <\/table>\r\n\t\t<\/div>\r\n\t\t\t<div style=\"border-bottom: 1px dashed #e0e0e0;\">\r\n\t\t  <table border=\"0\" style=\"margin-bottom: 0;\">\r\n\t\t\t<tr>\r\n\t\t\t\t\t<td style=\"border: none; padding: 5px; width: 25%;\">Carton Weight<\/td>\r\n\t\t\t<td style=\"border: none; padding: 5px;\">\r\n\t\t\t\t19.30kgs / 42.54lb\r\n\t\t\t<\/td>\r\n\t\t\t\t\t<\/tr>\r\n\t\t  <\/table>\r\n\t\t<\/div>\r\n\t\t\t<div style=\"border-bottom: 1px dashed #e0e0e0;\">\r\n\t\t  <table border=\"0\" style=\"margin-bottom: 0;\">\r\n\t\t\t<tr>\r\n\t\t\t\t\t<td style=\"border: none; padding: 5px; width: 25%;\">Carton Size<\/td>\r\n\t\t\t<td style=\"border: none; padding: 5px;\">\r\n\t\t\t\t50cm * 50cm * 60cm / 19.69inch * 19.69inch * 23.62inch\r\n\t\t\t<\/td>\r\n\t\t\t\t\t<\/tr>\r\n\t\t  <\/table>\r\n\t\t<\/div>\r\n\t\t\t<div class=\"params_prop last_prop\">\r\n\t\t  <table border=\"0\" style=\"margin-bottom: 0;\">\r\n\t\t\t<tr>\r\n\t\t\t\t\t<td style=\"border: none; padding: 5px; width: 25%;\">Loading Container<\/td>\r\n\t\t\t<td style=\"border: none; padding: 5px;\">\r\n\t\t\t\t\t\t\t\t20GP: 177 cartons * 288 pcs = 50976 pcs<br>\r\n\t\t\t\t\t\t\t\t40HQ: 412 cartons * 288 pcs = 118656 pcs<br>\r\n\t\t\t<\/td>\r\n\t\t\t\t\t<\/tr>\r\n\t\t  <\/table>\r\n\t\t<\/div>\r\n\t\t<\/td>\r\n  <\/tr>\r\n<\/table>\r\n<\/div>\r\n\r\n<div style=\"border-top: 1px solid #e0e0e0;\"><\/div>",
                "clearance": false,
                "id": 2239039,
                "packHeight": 600,
                "stock": 0,
                "barcode": "6922331578984",
                "brandName": "",
                "picCount": 0,
                "packWeight": "19.296",
                "warehouse": "CN",
                "modelLabel": "Light color",
                "goodsType": 64,
                "packWidth": 500,
                "baseImgCount": 6,
                "groupItemNo": "TBD0601904301",
                "name": "5 PCS D2 LED Flashing Finger Light Stage Small Magic Ball Flash(White)",
                "packQty": 288,
                "withLogo": false,
                "categoryId": 110945,
                "leadTimeLevel": 1,
                "status": 1
            }
        ],
        "total": 1674655,
        "pageCount": 1674655
    }
}
Modified at 2026-03-11 08:10:43
Previous
Get the children of the category
Next
Get the product details
Built with