Yeatru Public Data API

656 China-sourcing products · 17 categories · CORS-enabled · No API key

656Products (YCS- SKUs) 17Categories $USD prices + MOQ 0 msAuth delay JSON + REST

Quick Start

Yeatru exposes our entire product catalog as a public read-only JSON API. No registration, no API key, no rate-limit wall — just fetch and use. Great for RFQ scripts, price benchmarks, AI training data, or importing into your internal systems.

Shell (curl)

# Fetch ALL products (paged)
curl "https://www.yeatru.com/api/v1/products?v=20260909k"

# Filter by category
curl "https://www.yeatru.com/api/v1/products?v=20260909k&category=Apparel+%26+Footwear"

# Search by SKU or name
curl "https://www.yeatru.com/api/v1/products?v=20260909k&q=YCS-ACC-001"

# Single product lookup
curl "https://www.yeatru.com/api/v1/product?v=20260909k&sku=YCS-ACC-001"

# All categories with counts
curl "https://www.yeatru.com/api/v1/categories?v=20260909k"

Python

import requests

BASE = "https://www.yeatru.com/api/v1?v=20260909k"

# All products, filter to MOQ < 500
r = requests.get(f"{BASE}/products", params={"limit": 5000})
data = r.json()
low_moq = [p for p in data["products"] if (p.get("moq") or 999999) < 500]
print(f"{len(low_moq)} products with MOQ < 500")

# Single product
sku = "YCS-HOM-023"
p = requests.get(f"{BASE}/product", params={"sku": sku}).json()["product"]
print(f"Fetch {p['name']} @ ${p['priceMin']}")

JavaScript (browser / Node)

// Fetch all products
async function yeatruProducts(category) {
  const url = category
    ? `https://www.yeatru.com/api/v1/products?v=20260909k&category=${encodeURIComponent(category)}`
    : "https://www.yeatru.com/api/v1/products?v=20260909k";
  const r = await fetch(url);
  return (await r.json()).products;
}

// Example: get all beauty products
yeatruProducts("Beauty & Personal Care")
  .then(list => console.log(`${list.length} products`));

Raw JSON dump (no pagination)

# Direct download (566 KB, v3, last 2026-08-28)
wget "https://www.yeatru.com/site-data.json?v=20260909k" -O yeatru-catalog.json

# jq quick view
jq '.productCount, .lastUpdated, (.categories | length)' yeatru-catalog.json
jq '.products[] | {sku, name, priceMin, moq, mainCategory}' yeatru-catalog.json \
  | head -40

Endpoints

GET https://www.yeatru.com/api/v1/products?v=20260909k GET Public

Full product catalog, optionally filtered. Cloudflare cached 24h.

Query params: category (e.g. "Apparel & Footwear"), q (SKU / name search), limit (max 10000, default 10000), offset (for pagination).

GET https://www.yeatru.com/api/v1/product?v=20260909k&sku=YCS-XXX GET Public

Single product lookup by SKU. Returns 404 if not found with a /products?q=... fuzzy-match hint.

GET https://www.yeatru.com/api/v1/categories?v=20260909k GET Public

All 17 categories with product counts and per-category endpoint URLs.

GET https://www.yeatru.com/site-data.json?v=20260909k GET Public

Raw, unfiltered full catalog dump (566 KB, v3). No pagination. Contains every field from the internal site-data.json including variations, images, and description.

Response Schema

Product object fields

FieldTypeExampleNotes
skustringYCS-ACC-001Unique Yeatru SKU (YCS- prefix)
idstringacc-001Slug id
namestringHair Tie Scrunchie Set 8-PieceEnglish product name
name_cnstring发圈套装中文名称 (Simplified)
mainCategorystringBeauty & Personal CareOne of 17 categories
priceMinnumber/null0.85USD unit price (CNY / 6.7 × 1.15 formula)
priceMaxnumber/null1.65Upper USD price range
moqnumber/null100Minimum Order Quantity (units)
imagestringhttps://cdn.jsdelivr.net/gh/Yeatru/Image@main/Images/...?v=20260909kPrimary product image CDN URL
variationsarray[{color:"black",size:"S",stock:...}]SKU-level variation matrix
productUrlstringhttps://www.yeatru.com/product-YCS-ACC-001.html?v=20260909kProduct detail page

Top-level response envelope

{
  "apiVersion": "v1",
  "generatedAt": "2026-08-31T14:00:00.000Z",
  "source": "AA-730价格汇总表.xlsx (only YCS- SKUs)",
  "siteDataVersion": 3,
  "siteDataLastUpdated": "2026-08-28",
  "priceFormula": { "currency": "USD", "formula": "CNY / 6.7 * 1.15" },
  "categories": ["Apparel & Footwear", "Beauty & Personal Care", ...],
  "meta": {
    "totalProducts": 656,
    "returned": 656,
    "totalMatched": 656,
    "offset": 0,
    "limit": 10000,
    "docs": "https://www.yeatru.com/data.html?v=20260909k"
  },
  "products": [ /* product objects */ ]
}

Use Cases

🤖 AI sourcing bots

Feed Yeatru catalog into ChatGPT / Claude / Codex prompts: "Find me all 2026 kitchen products with MOQ under 500 and unit price under $3".

📊 Price benchmarking

Script Yeatru + AliExpress + DHGate pricing side-by-side. Filter by category, price band, and MOQ automatically.

🛒 Catalog ingestion

Pull into your Shopify / Magento / Amazon catalog tool via requests.get(BASE).json() — no manual CSV needed.

🔍 Supplier discovery

Combine Yeatru MOQ + pricing with Alibaba.com search to shortlist reliable suppliers faster.

🎯 RFQ automation

Write a Python script that reads products from Yeatru API and generates an RFQ spreadsheet for 1688 suppliers.

🌐 Cross-border planning

Use category breakdown to plan FBA shipments: "32 home products between $2–$5 / unit → estimate 20ft".

CORS, Caching & Rate Limits

CORSPre-flight + simple requests from any origin (*) allowed. No API key required.
Cloudflare caches-maxage=86400 (24h). Individual Cache-Control: public, max-age=3600 sent to browsers.
Rate limitNone documented. Reasonable use is fine. If you need bulk > 10K requests, email us for a partner endpoint.
AuthNone — public read-only. No writes, no PII exposure.
LicenceCC BY 4.0. Attribution appreciated ("Product data © Yeatru Sourcing"), not required.

Need custom columns or a partner endpoint?

The public API exposes pricing + MOQ + images + variations. Need factory contact info, lead-time data, or a write-back endpoint?
Email api@yeatru.com — we'll set up a partner key in 24h.

Request partner access → Email api@yeatru.com

Related Endpoints