Shopify Stores API

Endpoint text

POST /api/vi/shopify-stores

Authentication
Include your API Key in the request header: text

X-VIP-TOKEN: your_api_key_here

Request Parameters

Parameter	Type	Required	Description
search_key	string	No	Store name or domain keyword
country	string	No	Country code (e.g., US, CN)
year	int	No	Store creation year filter: 1=last 1 year, 2=1-2 years, 3=2-3 years, 4=3+ years
sort_by	int	No	Sort field: 0=product count, 1=category count, 2=monthly visits, 3=FB followers, 4=Ins followers, 5=ad count, 6=relevance, 7=monthly orders (default)
order_by	string	No	Sort direction: asc/desc, default desc
page_num	int	No	Page number, starting from 1
page_size	int	No	Items per page, max 100
product_num_min	int	No	Minimum product count
product_num_max	int	No	Maximum product count
advertise_count_min	int	No	Minimum ad count
advertise_count_max	int	No	Maximum ad count
monthly_visit_min	int	No	Minimum monthly visits
monthly_visit_max	int	No	Maximum monthly visits
month_order_min	int	No	Minimum monthly orders
month_order_max	int	No	Maximum monthly orders
lang	string	No	Language: en/cn, default en

Request Example 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))

Response Example 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
}

Response Fields

Field	Type	Description
store_id	string	Store ID
shop_id	string	Shop ID
store_name	string	Store name
store_domain	string	Store domain
store_link	string	Store URL
country	string	Country name
created_time	string	Creation date
product_num	int	Product count
category_num	int	Category count
categories	array	Category list
monthly_visit	string	Monthly visits (formatted)
month_order_num	string	Monthly orders (formatted)
fb_followers	string	Facebook followers
ins_followers	string	Instagram followers
advertise_count	int	Ad count
ad_link	string	Facebook Ad Library link
email	string	Contact email
facebook_url	string	Facebook page URL
instagram_url	string	Instagram profile URL
social_links	object	Other social links
global_rank	string	Global rank
logo	string	Store logo URL
available_status	int	Store status (1=active)

Common Response Codes

Code	Description
200	Success
401	Authentication failed (invalid/expired API Key)
402	Insufficient credits or subscription expired
403	Access denied
429	Rate limit exceeded
500	Internal server error

Credit Usage

Each returned product/store consumes 1 credit.
Daily credit limit (shared across all VIP endpoints).
Response includes used_today and remaining_today to monitor usage.

​Common Response Codes

​Credit Usage

Common Response Codes

Credit Usage