# Yiwugo API - Search for Yiwugo shops by keywords

## API Overview

- Get a list of shops based on keyword
- Total number of shops
- Shop information (shop name/shop URL/main products)
- Contact information (contact person/mobile/telephone) and shop/factory location

## API URL

`GET http://api.tmapi.top/yiwugo/search/shops`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| keyword | string | Search keywords | true |
| page | integer | Page number<br/>Default value: 1 | false |
| page_size | integer | Number of items per page<br/>Default value: 10 | false |
| language | string | Optional values: `zh`, `en`<br/>Default value: en | 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/yiwugo/search/shops?keyword=%E8%A1%A3%E6%9C%8D&language=zh' \
+  --header 'apikey: xxxxxx'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "keywords": "衣服",
    "total": 73,
    "page": 1,
    "page_size": 10,
    "shops": [
      {
        "shop_id": 722733,
        "shop_name": "AKCN棉服羽绒服工厂店",
        "shop_url": "https://www.yiwugo.com/hu/0432313B02.html",
        "user_id": "shop_233734",
        "description": "Factory store, self produced and self sold, specializing in the production of down jackets, cotton jackets, women's and men's vests, outerwear, and children's pants. We accept orders and provide customized samples with novel styles and affordable prices. We welcome customers from all over the world to come for consultation and procurement本店诚信经营，品类繁多，价格实惠，质量保证，欢迎全国各地的采购商前来咨询订购，联系方式18395991567，地址 义乌国际商贸城四区83门1楼10街31670",
        "main_product": "女装，羽绒服，棉服，童装，马甲，背心，男装，夹克，外套，裤子",
        "contacter": "力菱",
        "mobile": "15356975688",
        "telephone": "",
        "shop_location": "义乌国际商贸城四区83门1楼10街31670",
        "factory_location": "浙江省金华市义乌市"
      },
      {
        "shop_id": 797840,
        "shop_name": "容新内衣服饰",
        "shop_url": "https://www.yiwugo.com/hu/17666096008.html",
        "user_id": "shop_308082",
        "description": "容新商行专业经营各类女士内衣、哺乳内衣、无钢圈文胸，款式丰富，现货充足。支持批量拿货、混批订货，可承接订单定制。坚守品质，性价比优势突出，欢迎全国各地采购商咨询洽谈合作！",
        "main_product": "内衣服饰",
        "contacter": "马伟东",
        "mobile": "17666096008",
        "telephone": "",
        "shop_location": "广东省汕头市潮阳区潮阳区和平镇下寨和惠路568号（3楼）",
        "factory_location": "广东省汕头市潮阳区潮阳区和平镇下寨和惠路568号（3楼）"
      },
      {
        "shop_id": 713502,
        "shop_name": "金丰狐保暖内衣服饰",
        "shop_url": "https://www.yiwugo.com/hu/Y40335A1.html",
        "user_id": "shop_226290",
        "description": "金丰狐服饰是一家致力于保暖内衣、背心、短裤的生产销售为一体的服装公司，位于内衣名镇，中国四大内衣生产基地之一的宜山镇，一支技术过硬经验丰富的制衣团队，采用的是德国进口的自动化缝纫设备，旨在为中国的中青年制造生产一件优质、舒适、健康的好内衣，欢迎广大采购商来我公司采购",
        "main_product": "保暖内衣，情趣内衣，背心，袜子，打底裤，童装，保暖内衣，短裤",
        "contacter": "周加晓",
        "mobile": "18815187803",
        "telephone": "057985558362",
        "shop_location": "义乌国际商贸城四区76门4楼19街47485A,47485B",
        "factory_location": ""
      }
    ]
  }
}

```