# 1688 API - Search for 1688 factories by keywords

## API Overview

- Search for 1688 factories by keywords
- Support sorting and filtering
- See More

## API URL

`GET https://api.tmapi.io/1688/search/factories`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| page | integer | Page number<br/>Default value: 1 | false |
| page_size | integer | Number of items per page<br/>Default value: 20 | false |
| keywords | string | Search keywords | true |
| sort | string | Optional values: `default`, `repurchase_rate`<br/>Default value: default | false |

## Security Auth

> Please go to [Console-Account Center](https://console.tmapi.io/account/center) to get your apiToken.

> Add your apiToken to the request parameters. Please refer to the examples below.

## Request Example

```bash

curl --request GET 'https://api.tmapi.io/1688/search/factories?apiToken=xxxxxx&page=1&page_size=20&keywords=%E7%8E%A9%E5%85%B7%E5%8E%82&sort=default'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 2,
    "page_size": 3,
    "total_count": 2000,
    "keywords": "玩具厂",
    "sort": "default",
    "items": [
      {
        "login_id": "嘉玩玩具厂",
        "member_id": "b2b-2208087470531de12c",
        "userid": "b2b-2208087470531de12c",
        "company_name": "汕头市澄海区嘉玩玩具厂",
        "factory_url": "https://sale.1688.com/factory/card.html?__existtitle__=1&__removesafearea__=1&memberId=b2b-2208087470531de12c&aHdkaW5n_isCentral=true&aHdkaW5n_isGrayed=false&aHdkaW5n_isUseGray=true&tracelog=p4p&_p_isad=1&cbu_ad_adgroup_id=1012175526&cbu_ad_sessionid=8abf6de67a4f84a1ae99f562f3f5162e",
        "factory_level": null,
        "factory_area_size": "1000",
        "location": {
          "city": "汕头"
        },
        "service_tags": [
          "AA诚信等级",
          "塑料/塑胶",
          "注塑",
          "清加工",
          "汕头玩具"
        ],
        "product_tags": "泡泡玩具;玩具枪",
        "invoice_available": false,
        "tp_member": true,
        "tp_year": 4,
        "is_factory": true,
        "super_factory": false,
        "shop_repurchase_rate": "0.3",
        "response_rate": "0.44"
      },
      {
        "login_id": "精精玩具168",
        "member_id": "b2b-22092767183650cbd8",
        "userid": "b2b-22092767183650cbd8",
        "company_name": "汕头市澄海区精精玩具厂",
        "factory_url": "https://sale.1688.com/factory/card.html?__existtitle__=1&__removesafearea__=1&memberId=b2b-22092767183650cbd8&aHdkaW5n_isCentral=true&aHdkaW5n_isGrayed=false&aHdkaW5n_isUseGray=true",
        "factory_level": "无牌工厂",
        "factory_area_size": "3000",
        "location": {
          "city": "汕头"
        },
        "service_tags": [
          "AAA诚信等级",
          "CCC认证",
          "abs",
          "清加工",
          "世界玩具之都"
        ],
        "product_tags": "积木类;玩具枪;惯性回力玩具",
        "invoice_available": true,
        "tp_member": true,
        "tp_year": 3,
        "is_factory": true,
        "super_factory": false,
        "shop_repurchase_rate": "0.42",
        "response_rate": "0.66"
      },
      {
        "login_id": "梦高玩具",
        "member_id": "b2b-22118516378099ae41",
        "userid": "b2b-22118516378099ae41",
        "company_name": "汕头市梦高玩具实业有限公司",
        "factory_url": "https://sale.1688.com/factory/card.html?__existtitle__=1&__removesafearea__=1&memberId=b2b-22118516378099ae41&aHdkaW5n_isCentral=true&aHdkaW5n_isGrayed=false&aHdkaW5n_isUseGray=true",
        "factory_level": "金牌制造",
        "factory_area_size": "12000",
        "location": {
          "city": "汕头"
        },
        "service_tags": [
          "厂长在线",
          "深度验厂",
          "响应及时",
          "支持外贸订单",
          "abs",
          "包工包料",
          "世界玩具之都"
        ],
        "product_tags": "积木类;大颗粒积木;玩具枪",
        "invoice_available": true,
        "tp_member": true,
        "tp_year": 3,
        "is_factory": true,
        "super_factory": true,
        "shop_repurchase_rate": "0.51",
        "response_rate": "0.87"
      }
    ]
  }
}

```