# Made-in-China API - Get Made-in-China shop products

## API Overview

- Get products of a supplier shop by shop URL or shop category URL
- Shop categories and featured lists, whose URLs can be used as shop_cat_url
- Product information (title/price/MOQ/main image)

## API URL

`GET http://api.tmapi.top/madeinchina/shop/items`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| shop_url | string | Shop home page link | false |
| shop_cat_url | string |  | false |
| page | integer | Page number<br/>Default value: 1 | false |

> Either shop_url or shop_cat_url is required (shop_url is used if both are passed)

## 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/shop/items?shop_url=https%3A%2F%2Fjiangsuworld.en.made-in-china.com&page=1' \
+  --header 'apikey: xxxxxx'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "shop_url": "https://jiangsuworld.en.made-in-china.com",
    "page": 1,
    "page_size": 24,
    "total": 1718,
    "cat_name": "All Products",
    "shop_cats": [
      {
        "name": "FMWORLD Seeding&Planting",
        "url": "https://jiangsuworld.en.made-in-china.com/product-group/TowtVEYdOLUG/FMWORLD-Seeding-Planting-catalog-1.html"
      },
      {
        "name": "FMWORLD Agricultural implements",
        "url": "https://jiangsuworld.en.made-in-china.com/product-group/mesGLvjPCgrK/FMWORLD-Agricultural-implements-catalog-1.html"
      },
      {
        "name": "FMWORLD Excavator Series",
        "url": "https://jiangsuworld.en.made-in-china.com/product-group/UeRfQMDAVIas/FMWORLD-Excavator-Series-catalog-1.html"
      }
    ],
    "featured_list": [
      {
        "name": "Sample Available",
        "url": "https://jiangsuworld.en.made-in-china.com/featured-list/sample-products.html"
      },
      {
        "name": "Hot Products",
        "url": "https://jiangsuworld.en.made-in-china.com/productList?selectedSpotlightId=NmnJFZoGJrWE"
      },
      {
        "name": "New Arrival",
        "url": "https://jiangsuworld.en.made-in-china.com/productList?selectedSpotlightId=FxmQOJqTRRhE"
      }
    ],
    "items": [
      {
        "item_id": "aNAnrMOGgLhB",
        "product_url": "https://jiangsuworld.en.made-in-china.com/product/aNAnrMOGgLhB/China-Fmworld-Ruilong-Plus-Combine-Harvester-Cabin-Version.html",
        "title": "Fmworld Ruilong Plus Combine Harvester Cabin Version",
        "currency": "USD",
        "main_img": "https://image.made-in-china.com/43f34j00OerlgbpPYQzj/Fmworld-Ruilong-Plus-Combine-Harvester-Cabin-Version.jpg",
        "price_info": {
          "price_text": "US $17,600-19,400 / Piece",
          "price_min": "17600.00",
          "price_max": "19400.00"
        },
        "offer_unit": "Piece",
        "moq": 1
      },
      {
        "item_id": "CsiJFrqPkuVZ",
        "product_url": "https://jiangsuworld.en.made-in-china.com/product/CsiJFrqPkuVZ/China-Head-Feeding-Harvester.html",
        "title": "Head Feeding Harvester",
        "currency": "USD",
        "main_img": "https://image.made-in-china.com/43f34j00vCiWpeMnkQcF/Head-Feeding-Harvester.jpg",
        "price_info": {
          "price_text": "US $17,000 / Piece",
          "price_min": "17000.00",
          "price_max": "17000.00"
        },
        "offer_unit": "Piece",
        "moq": 1
      },
      {
        "item_id": "KNrJlMjUnzWc",
        "product_url": "https://jiangsuworld.en.made-in-china.com/product/KNrJlMjUnzWc/China-Fmworld-98HP-Crawler-Tractor-Wd3100c.html",
        "title": "Fmworld 98HP Crawler Tractor Wd3100c",
        "currency": "USD",
        "main_img": "https://image.made-in-china.com/43f34j00HQERWaNJgcqK/Fmworld-98HP-Crawler-Tractor-Wd3100c.jpg",
        "price_info": {
          "price_text": "US $10,500-11,300 / Piece",
          "price_min": "10500.00",
          "price_max": "11300.00"
        },
        "offer_unit": "Piece",
        "moq": 1
      }
    ]
  }
}

```