⚡ ylishi.tools Public API

🚀 Get Your API Key

⚡ Try It First — No Key Required

You do not have to register to evaluate the API. A small set of read-only endpoints is open to anyone at /api/v1/demo/, rate-limited to 20 requests per hour per IP (minimum 1 request every 2 seconds). No email, no key, no signup.

# See every endpoint available without a key
curl https://ylishi.tools/api/v1/demo

# Real Amazon autocomplete data for a keyword — live, no key
curl "https://ylishi.tools/api/v1/demo/kw/suggest?keyword=yoga+mat&market=US"

Responses carry X-Demo: 1 plus X-Demo-Hourly-Remaining so you can see your budget. Demo endpoints:

Writes — fee calculations, PPC analysis, listing grading, product estimation — need a free key (200 calls/day). Get one above, then swap /api/v1/demo/<service>/<action> for /api/v1/tools/<service>/<action> and add the X-API-Key header. Same paths, same response shape.

📋 Base URL & Authentication

All requests go to: https://ylishi.tools/api/v1

Authenticate by passing your key in the header:

curl -H "X-API-Key: yl_live_yourkey" https://ylishi.tools/api/v1/tools/temu/categories

All responses are JSON. Rate limits are per-key: free tier 200 req/day, burst 10 req/s. Response headers include X-RateLimit-Daily-Limit and X-RateLimit-Daily-Remaining.

📡 Available Endpoints

🔧 Tool Calculators (POST)

📊 Keyword Research (GET)

📂 Metadata (GET)

💻 Code Examples

Python

import requests

API_KEY = "yl_live_yourkey"
BASE = "https://ylishi.tools/api/v1/tools"

headers = {"X-API-Key": API_KEY}

# Temu profit calculation
resp = requests.post(
    f"{BASE}/temu/calculate",
    headers=headers,
    json={"model": "supply", "supply_price": 10, "cogs": 5, "weight_oz": 12}
)
print(resp.json())  # → {"margin": 36.0, "net_profit": 3.6, ...}

JavaScript (fetch)

const res = await fetch("https://ylishi.tools/api/v1/tools/tiktok/calculate", {
  method: "POST",
  headers: {
    "X-API-Key": "yl_live_yourkey",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ price: 25, cost: 8, category: "home" })
});
const data = await res.json();
console.log(data.margin);

Shell (curl)

# Temu calculator
curl -X POST https://ylishi.tools/api/v1/tools/temu/calculate \
  -H "X-API-Key: yl_live_yourkey" \
  -H "Content-Type: application/json" \
  -d '{"model":"supply","supply_price":10,"cogs":5}'

# Keyword suggestions
curl "https://ylishi.tools/api/v1/tools/kw/suggest?keyword=wireless+earbuds" \
  -H "X-API-Key: yl_live_yourkey"

📊 Rate Limits

Response headers: X-RateLimit-Plan, X-RateLimit-Daily-Limit, X-RateLimit-Daily-Remaining. When the quota is exceeded the API returns 429 Too Many Requests.

Demo endpoints (/api/v1/demo/…) have their own budget: 20 requests/hour per IP, minimum 2 seconds apart, no key required. They return X-Demo-Hourly-Limit / X-Demo-Hourly-Remaining, and reject with 429 plus Retry-After on the 2-second floor.

Licence terms for the fee data, the API and the embeddable widget — attribution requirements, what the free tier does and does not include, and commercial options — are at /api-terms/.

⚠️ Error Handling

🔗 Related

• 🐍 Python SDK — Official single-file client (stdlib only, no pip install)
• 🔌 MCP Server — Plug ylishi.tools into Claude Desktop & any MCP client
• Free Seller Tools — Full interactive calculators (no API key needed)
• Currency Converter Guide — ACCS fees explained
• API Documentation — This page