# Made-in-China API - Search for Made-in-China products by keyword
## API Overview
- Search products by keyword
- Filter by price range, MOQ, business type and supplier qualifications
- Filter options (facets) of the results, which can be passed back through the facet parameter
- Product information (title/price/MOQ/properties/images)
- Supplier information (company name/location/rating/tags)
## API URL
`GET http://api.tmapi.top/madeinchina/search/items`
## Request Parameters
### Query
| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| keyword | string | Search keywords | true |
| page | integer | Page number
Default value: 1 | false |
| page_size | integer | 10 / 30 / 50
Default value: 30 | false |
| moq | integer | MOQ less than or equal to | false |
| price_start | number | Filter: Minimum value of price range | false |
| price_end | number | Filter: Maximum value of price range | false |
| business_type | array | Optional values: `manufacturer`, `trading_company`, `group_corporation`, `other` | false |
| is_audited_supplier | boolean | | false |
| is_secured_trading | boolean | | false |
| is_leading_factory | boolean | | false |
| facet | array | Filter options returned dynamically based on the search results. Repeatable, use `facets[].options[].facet` from previous response, e.g. prop_204:204_983684 | false |
## Security Auth
> Please go to [Console-API Keys](https://console.tmapi.io/account/api-keys) to create your apikey.
> Add your apikey to the request headers. Please refer to the examples below.
## Request Example
```bash
curl --request GET 'http://api.tmapi.top/madeinchina/search/items?keyword=cloths&page=1&page_size=30' \
+ --header 'apikey: xxxxxx'
```
## Response Example
```json
{
"code": 200,
"msg": "success",
"data": {
"keyword": "cloths",
"page": 1,
"page_size": 30,
"total": 120000,
"has_more": true,
"facets": [
{
"key": "rd_capacity",
"name": "R&D Capacity",
"type": "multi_select",
"options": [
{
"value": "5",
"label": "ODM",
"selected": false,
"facet": "rd_capacity:5"
},
{
"value": "4",
"label": "OEM",
"selected": false,
"facet": "rd_capacity:4"
},
{
"value": "6",
"label": "Own Brand",
"selected": false,
"facet": "rd_capacity:6"
},
{
"value": "99",
"label": "Others",
"selected": false,
"facet": "rd_capacity:99"
}
]
},
{
"key": "category",
"name": "Categories",
"type": "single_select",
"options": [
{
"value": "ECxAunQMzhmJ",
"label": "Cleaning Ball, Sponge & Cloth",
"selected": false,
"facet": "category:ECxAunQMzhmJ"
},
{
"value": "QPAGamnodBxJ",
"label": "Fiberglass Cloth",
"selected": false,
"facet": "category:QPAGamnodBxJ"
},
{
"value": "JCUGhEnvjcmQ",
"label": "Plastic Rope & Net",
"selected": false,
"facet": "category:JCUGhEnvjcmQ"
},
{
"value": "mCJaRQGltWEn",
"label": "Dish Towel",
"selected": false,
"facet": "category:mCJaRQGltWEn"
},
{
"value": "xjWfRmTyoanJ",
"label": "Glasses Cloth",
"selected": false,
"facet": "category:xjWfRmTyoanJ"
}
]
},
{
"key": "features",
"name": "Product Features",
"type": "multi_select",
"options": [
{
"value": "1",
"label": "Buy Sample",
"selected": false,
"facet": "features:1"
}
]
}
],
"items": [
{
"item_id": "ERJrxalVtYcm",
"product_url": "https://shaoxingyuki.en.made-in-china.com/product/ERJrxalVtYcm/China-Premium-100-Cotton-Cloth-Checked-Shirt-Fabric-for-Stylish-Wardrobe-Essentials.html",
"title": "Premium 100% Cotton Cloth Checked Shirt Fabric for Stylish Wardrobe Essentials",
"currency": "USD",
"main_imgs": [
"https://image.made-in-china.com/202f0j00BbVeFWfRElqv/Premium-100-Cotton-Cloth-Checked-Shirt-Fabric-for-Stylish-Wardrobe-Essentials.webp",
"https://image.made-in-china.com/202f0j00vbVeFBYlkicM/Premium-100-Cotton-Cloth-Checked-Shirt-Fabric-for-Stylish-Wardrobe-Essentials.webp",
"https://image.made-in-china.com/202f0j00BbVeONRKQikC/Premium-100-Cotton-Cloth-Checked-Shirt-Fabric-for-Stylish-Wardrobe-Essentials.webp",
"https://image.made-in-china.com/202f0j00ZohenQYqfWbB/Premium-100-Cotton-Cloth-Checked-Shirt-Fabric-for-Stylish-Wardrobe-Essentials.webp",
"https://image.made-in-china.com/202f0j00jklMOuUyMWqB/Premium-100-Cotton-Cloth-Checked-Shirt-Fabric-for-Stylish-Wardrobe-Essentials.webp",
"https://image.made-in-china.com/202f0j00KqleNWYGfhbM/Premium-100-Cotton-Cloth-Checked-Shirt-Fabric-for-Stylish-Wardrobe-Essentials.webp"
],
"product_props": [
{
"Pattern": "Plaid"
},
{
"Style": "Russian Japanese & Korean Style"
},
{
"Technics": "Yarn Dyed"
},
{
"Thickness": "Medium Weight"
},
{
"Usage": "Garment, Home Textile"
},
{
"Packing": "Bag or Carton"
}
],
"price_info": {
"price_min": "1.00",
"price_max": "1.00"
},
"offer_unit": "Meters",
"moq": 50,
"shop_info": {
"shop_id": "VwDGPBFxbglt",
"company_name": "Shaoxing Yuki International Trade Co., Ltd",
"shop_url": "https://shaoxingyuki.en.made-in-china.com",
"shop_logo": "https://image.made-in-china.com/206f0j00pEWRfGOzuUoK/Shaoxing-Yuki-International-Trade-Co-Ltd.jpg",
"location": "Zhejiang, China",
"business_type": "",
"rating": "5.0",
"tags": [
"Gold Member",
"Audited Supplier",
"High Repeat Buyers Choice",
"Self-branded",
"Minor Customization"
]
},
"tags": [
"Buy Sample"
],
"is_ad": true
},
{
"item_id": "SYVrOuAoAbhW",
"product_url": "https://zhtowel.en.made-in-china.com/product/SYVrOuAoAbhW/China-400-GSM-Microfiber-Long-and-Short-Pile-Cloth-Super-Absorbent-Car-Wash-Towel-Warp-Knitted-Quick-Dry-Microfiber-Car-Cleaning-Cloth.html",
"title": "400 GSM Microfiber Long and Short Pile Cloth Super Absorbent Car Wash Towel Warp Knitted Quick-Dry Microfiber Car Cleaning Cloth",
"currency": "USD",
"main_imgs": [
"https://image.made-in-china.com/202f0j00ankBIqNFycbo/400-GSM-Microfiber-Long-and-Short-Pile-Cloth-Super-Absorbent-Car-Wash-Towel-Warp-Knitted-Quick-Dry-Microfiber-Car-Cleaning-Cloth.webp",
"https://image.made-in-china.com/202f0j00PnqCWLKJwoci/400-GSM-Microfiber-Long-and-Short-Pile-Cloth-Super-Absorbent-Car-Wash-Towel-Warp-Knitted-Quick-Dry-Microfiber-Car-Cleaning-Cloth.webp",
"https://image.made-in-china.com/202f0j00LNbBWkjKwoci/400-GSM-Microfiber-Long-and-Short-Pile-Cloth-Super-Absorbent-Car-Wash-Towel-Warp-Knitted-Quick-Dry-Microfiber-Car-Cleaning-Cloth.webp",
"https://image.made-in-china.com/202f0j00LNcMisSGkobW/400-GSM-Microfiber-Long-and-Short-Pile-Cloth-Super-Absorbent-Car-Wash-Towel-Warp-Knitted-Quick-Dry-Microfiber-Car-Cleaning-Cloth.webp",
"https://image.made-in-china.com/202f0j00HncMhmsqGobi/400-GSM-Microfiber-Long-and-Short-Pile-Cloth-Super-Absorbent-Car-Wash-Towel-Warp-Knitted-Quick-Dry-Microfiber-Car-Cleaning-Cloth.webp",
"https://image.made-in-china.com/202f0j00lyovhRZnSqbi/400-GSM-Microfiber-Long-and-Short-Pile-Cloth-Super-Absorbent-Car-Wash-Towel-Warp-Knitted-Quick-Dry-Microfiber-Car-Cleaning-Cloth.webp"
],
"product_props": [
{
"Material": "80%Polyeater 20%Polyamide"
},
{
"Quantity": "1 Piece"
},
{
"Usage": "Kitchen, Car"
},
{
"Customized": "Customized"
},
{
"Color": "Gray/Green/Orange/Yellow, Customized Colors"
},
{
"Color Fastnees": "3-4grade"
}
],
"price_info": {
"price_min": "0.15",
"price_max": "0.28"
},
"offer_unit": "Pieces",
"moq": 1000,
"shop_info": {
"shop_id": "fdgAtBPYYUIw",
"company_name": "Yuanshi County Zhengheng Textile Co., Ltd.",
"shop_url": "https://zhtowel.en.made-in-china.com",
"shop_logo": "https://image.made-in-china.com/206f0j00aToRwctdJGbl/Yuanshi-County-Zhengheng-Textile-Co-Ltd-.jpg",
"location": "Hebei, China",
"business_type": "Manufacturer/Factory & Trading Company",
"rating": "5.0",
"tags": [
"Diamond Member",
"Audited Supplier",
"Importers and Exporters",
"High Repeat Buyers Choice",
"Exhibition Experience",
"Management Certification"
]
},
"tags": [
"Secured Trading",
"Buy Sample"
],
"is_ad": true
},
{
"item_id": "PmQpReguBGYh",
"product_url": "https://starmachinechina.en.made-in-china.com/product/PmQpReguBGYh/China-PTFE-Polypropylene-PP-Dust-Collector-Filter-Cloth-Filter-Bag-for-Dust-Collector.html",
"title": "PTFE Polypropylene/PP Dust Collector Filter Cloth Filter Bag for Dust Collector",
"currency": "USD",
"main_imgs": [
"https://image.made-in-china.com/202f0j00tzEoiQscjrpT/PTFE-Polypropylene-PP-Dust-Collector-Filter-Cloth-Filter-Bag-for-Dust-Collector.webp",
"https://image.made-in-china.com/202f0j00NROoCFeklWuf/PTFE-Polypropylene-PP-Dust-Collector-Filter-Cloth-Filter-Bag-for-Dust-Collector.webp",
"https://image.made-in-china.com/202f0j00YpgkGMtIoRzu/PTFE-Polypropylene-PP-Dust-Collector-Filter-Cloth-Filter-Bag-for-Dust-Collector.webp",
"https://image.made-in-china.com/202f0j00nGFkeiMdlWgR/PTFE-Polypropylene-PP-Dust-Collector-Filter-Cloth-Filter-Bag-for-Dust-Collector.webp",
"https://image.made-in-china.com/202f0j00KROkCFMcLirU/PTFE-Polypropylene-PP-Dust-Collector-Filter-Cloth-Filter-Bag-for-Dust-Collector.webp",
"https://image.made-in-china.com/202f0j00OGykBaMnAhzY/PTFE-Polypropylene-PP-Dust-Collector-Filter-Cloth-Filter-Bag-for-Dust-Collector.webp"
],
"product_props": [
{
"Material": "Polyester"
},
{
"Usage": "Air Filter, Liquid Filter, Powder Filter, Solid Filter"
},
{
"Type": "Woven Filter"
},
{
"Hole Shape": "Square"
},
{
"Manufacturing Method": "Manufacturing Cloth"
},
{
"Paper Type": "Qualitative"
}
],
"price_info": {
"price_min": "31.00",
"price_max": "31.00"
},
"offer_unit": "Pieces",
"moq": 10,
"shop_info": {
"shop_id": "yesEguQVZXcl",
"company_name": "Qingdao Star Machine Technology Co., Ltd.",
"shop_url": "https://starmachinechina.en.made-in-china.com",
"shop_logo": "https://image.made-in-china.com/206f0j00ztITAGOsvEuV/Qingdao-Star-Machine-Technology-Co-Ltd-.jpg",
"location": "Shandong, China",
"business_type": "",
"rating": "5.0",
"tags": [
"Diamond Member",
"Audited Supplier"
]
},
"tags": [
"Secured Trading",
"Buy Sample"
],
"is_ad": false
}
]
}
}
```