店铺查询接口

Shopify 店铺数据查询

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

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

接口地址 text

POST /api/vi/shopify-stores

鉴权说明 请求需在 Header 中携带 API Key： text

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

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

{
  "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 接口共用每日积分

​Shopify 店铺数据查询

​API 返回码说明

​积分说明

Shopify 店铺数据查询

API 返回码说明

积分说明