Skip to main content

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.

Endpoint text 
POST /api/vi/temu-stores
Authentication
Include your API Key in the request header: text 
X-VIP-TOKEN: your_api_key_here
Request Parameters
ParameterTypeRequiredDescription
search_keystringNoStore name or ID keyword
site_idstringNoSite country ID, comma separated (e.g., “211,76”)
categorystringNoBackend category ID, comma separated
is_localstringNoSemi-managed: “0”=fully managed, “1”=semi-managed
order_total_minintNoMinimum total sales
order_total_maxintNoMaximum total sales
order_week_minintNoMinimum weekly sales
order_week_maxintNoMaximum weekly sales
order_month_minintNoMinimum monthly sales
order_month_maxintNoMaximum monthly sales
rating_minfloatNoMinimum rating (0-5)
rating_maxfloatNoMaximum rating
review_num_minintNoMinimum review count
review_num_maxintNoMaximum review count
follower_num_minintNoMinimum follower count
follower_num_maxintNoMaximum follower count
product_num_minintNoMinimum product count
product_num_maxintNoMaximum product count
listed_time_beginstringNoStore creation start date (YYYY-MM-DD)
listed_time_endstringNoStore creation end date (YYYY-MM-DD)
sort_bystringNoSort field and direction, e.g., “order_week_count-0” (weekly sales desc), “order_count-0” (total sales desc), “rating-0” (rating desc). Default “order_week_count-0”
page_numintNoPage number, starting from 1
page_sizeintNoItems per page, max 100
Request Example python 
import requests
import json

url = "https://api.ehunt.ai/api/vi/temu-stores"
headers = {
    "Content-Type": "application/json",
    "X-VIP-TOKEN": "your_api_key_here"
}
payload = {
    "search_key": "women fashion",
    "site_id": "211",
    "order_week_min": 1000,
    "rating_min": 4.5,
    "sort_by": "order_week_count-0",
    "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": "100500123456789",
        "site_id": "211",
        "store_name": "Fashion Boutique",
        "logo_url": "https://img.kwcdn.com/.../logo.png",
        "order_total": 50000,
        "order_week": 2500,
        "order_month": 12000,
        "total_revenue": 2500000.00,
        "week_revenue": 125000.00,
        "month_revenue": 600000.00,
        "rating": 4.8,
        "listed_time": "2022-01-15",
        "review_num": 15000,
        "follower_num": 50000,
        "product_num": 800,
        "categories_cn": ["女装", "配饰"],
        "categories": ["Women's Clothing", "Accessories"],
        "is_local": 0
      }
    ]
  },
  "used_today": 150,
  "remaining_today": 350
}
Response Fields
FieldTypeDescription
store_idstringStore ID
site_idstringSite ID
store_namestringStore name
logo_urlstringStore logo URL
order_totalintTotal sales
order_weekintWeekly sales
order_monthintMonthly sales
total_revenuefloatTotal revenue (USD)
week_revenuefloatWeekly revenue (USD)
month_revenuefloatMonthly revenue (USD)
ratingfloatRating (0-5)
listed_timestringStore creation date
review_numintReview count
follower_numintFollower count
product_numintProduct count
categories_cnarrayCategory list (Chinese)
categoriesarrayCategory list (English)
is_localintSemi-managed (0=fully managed, 1=semi-managed)

​
Common Response Codes

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

​
Credit Usage

  • Each returned product or store consumes 1 credit.
  • Daily credit limit (shared across all VIP endpoints: Etsy, Shopify, Temu).
  • Response includes used_today and remaining_today to monitor usage.