> ## Documentation Index
> Fetch the complete documentation index at: https://docs.api.ehunt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 店铺查询接口

### **Shopify 店铺数据查询**

该接口用于**VIP 用户查询 Shopify 店铺数据**，支持按产品数、访问量、订单量、广告数等多条件筛选，并支持排序与分页。

|  **项目**  | **说明**     |
| :------: | :--------- |
| **接口类型** | REST API   |
| **请求方式** | POST       |
| **数据格式** | JSON       |
| **鉴权方式** | API Key    |
| **适用用户** | VIP / 订阅用户 |

**接口地址**

text

```text theme={null}
POST /api/vi/shopify-stores
```

**鉴权说明**

请求需在 Header 中携带 API Key：

text

```text theme={null}
X-VIP-TOKEN: your_api_key_here
```

**请求参数**

|        **参数名**        | **类型** | **必填** | **说明**                                                          |
| :-------------------: | :----- | :----- | :-------------------------------------------------------------- |
|      search\_key      | string | 否      | 店铺名称或域名关键词                                                      |
|        country        | string | 否      | 国家代码，如 US、CN                                                    |
|          year         | int    | 否      | 店铺创建年份筛选：1=最近1年，2=1-2年，3=2-3年，4=3年以上                            |
|        sort\_by       | int    | 否      | 排序字段：0=产品数，1=类目数，2=月访问量，3=FB粉丝数，4=Ins粉丝数，5=广告数，6=相关度，7=月订单数(默认) |
|       order\_by       | string | 否      | 排序方向：asc/desc，默认 desc                                           |
|       page\_num       | int    | 否      | 页码，从1开始                                                         |
|       page\_size      | int    | 否      | 每页数量，最大100                                                      |
|   product\_num\_min   | int    | 否      | 产品数最小值                                                          |
|   product\_num\_max   | int    | 否      | 产品数最大值                                                          |
| advertise\_count\_min | int    | 否      | 广告数最小值                                                          |
| advertise\_count\_max | int    | 否      | 广告数最大值                                                          |
|  monthly\_visit\_min  | int    | 否      | 月访问量最小值                                                         |
|  monthly\_visit\_max  | int    | 否      | 月访问量最大值                                                         |
|   month\_order\_min   | int    | 否      | 月订单量最小值                                                         |
|   month\_order\_max   | int    | 否      | 月订单量最大值                                                         |
|          lang         | string | 否      | 语言：en/cn，默认en                                                   |

**请求示例**

python

```json theme={null}
import requests
import json

url = "https://api.ehunt.ai/api/vi/shopify-stores"
headers = {
    "Content-Type": "application/json",
    "X-VIP-TOKEN": "your_api_key_here"
}
payload = {
    "search_key": "fashion",
    "country": "US",
    "product_num_min": 100,
    "month_order_min": 1000,
    "sort_by": 7,
    "page_num": 1,
    "page_size": 20
}
response = requests.post(url, headers=headers, json=payload)
print(json.dumps(response.json(), indent=2))
```

**返回示例**

json

```json theme={null}
{
  "code": 200,
  "message": "OK",
  "data": {
    "store_num": 100,
    "page_size": 20,
    "final_count": 20,
    "list": [
      {
        "store_id": "store_123",
        "shop_id": "shop_123",
        "store_name": "Fashion Hub",
        "store_domain": "fashionhub.myshopify.com",
        "store_link": "https://fashionhub.myshopify.com",
        "country": "United States",
        "created_time": "2020-01-15",
        "product_num": 2500,
        "category_num": 15,
        "categories": [
          {"id": "123", "name": "Women's Clothing"},
          {"id": "456", "name": "Accessories"}
        ],
        "monthly_visit": "2.5M",
        "month_order_num": "15.2k",
        "fb_followers": "125k",
        "ins_followers": "89k",
        "advertise_count": 45,
        "ad_link": "https://www.facebook.com/ads/library/?view_all_page_id=...",
        "email": "contact@fashionhub.com",
        "facebook_url": "https://www.facebook.com/fashionhub",
        "instagram_url": "https://www.instagram.com/fashionhub",
        "social_links": {},
        "global_rank": "125000",
        "logo": "https://cdn.shopify.com/.../logo.png",
        "available_status": 1
      }
    ]
  },
  "used_today": 150,
  "remaining_today": 350
}
```

**响应字段说明**

|      **字段名**      | **类型** | **说明**        |
| :---------------: | :----- | :------------ |
|     store\_id     | string | 店铺ID          |
|      shop\_id     | string | 商店ID          |
|    store\_name    | string | 店铺名称          |
|   store\_domain   | string | 店铺域名          |
|    store\_link    | string | 店铺链接          |
|      country      | string | 国家名称          |
|   created\_time   | string | 创建时间          |
|    product\_num   | int    | 产品数量          |
|   category\_num   | int    | 类目数量          |
|     categories    | array  | 类目列表          |
|   monthly\_visit  | string | 月访问量（格式化）     |
| month\_order\_num | string | 月订单量（格式化）     |
|   fb\_followers   | string | Facebook粉丝数   |
|   ins\_followers  | string | Instagram粉丝数  |
|  advertise\_count | int    | 广告数量          |
|      ad\_link     | string | 广告库链接         |
|       email       | string | 联系邮箱          |
|   facebook\_url   | string | Facebook主页链接  |
|   instagram\_url  | string | Instagram主页链接 |
|   social\_links   | object | 其他社交链接        |
|    global\_rank   | string | 全球排名          |
|        logo       | string | 店铺Logo URL    |
| available\_status | int    | 店铺状态（1=活跃）    |

## **API 返回码说明**

| **Code** | **说明**              |
| :------: | :------------------ |
|    200   | 成功                  |
|    401   | 认证失败（API Key 无效或过期） |
|    402   | 积分不足或订阅过期           |
|    403   | 无访问权限               |
|    429   | 请求频率过高，触发限流         |
|    500   | 服务器内部错误             |

***

## **积分说明**

按实际返回数据量计费，**每条数据消耗 1 个积分**，清晰透明的消费机制。

* 商品查询：每条返回的商品消耗 1 积分
* 店铺查询：每条返回的店铺消耗 1 积分
* 每日积分上限与订阅套餐有关， Etsy、Shopify、Temu 全部 VIP 接口共用每日积分