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
| Field | Type | Example | Notes |
|---|---|---|---|
sku | string | YCS-ACC-001 | Unique Yeatru SKU (YCS- prefix) |
id | string | acc-001 | Slug id |
name | string | Hair Tie Scrunchie Set 8-Piece | English product name |
name_cn | string | | (Simplified) |
mainCategory | string | Beauty & Personal Care | One of 17 categories |
priceMin | number/null | 0.85 | USD unit price (CNY / 6.7 × 1.15 formula) |
priceMax | number/null | 1.65 | Upper USD price range |
moq | number/null | 100 | Minimum Order Quantity (units) |
image | string | https://cdn.jsdelivr.net/gh/Yeatru/Image@main/Images/...?v=20260909k | Primary product image CDN URL |
variations | array | [{color:"black",size:"S",stock:...}] | SKU-level variation matrix |
productUrl | string | https://www.yeatru.com/product-YCS-ACC-001.html?v=20260909k | Product 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
| CORS | Pre-flight + simple requests from any origin (*) allowed. No API key required. |
|---|---|
| Cloudflare cache | s-maxage=86400 (24h). Individual Cache-Control: public max-age=3600 sent to browsers. |
| Rate limit | None documented. Reasonable use is fine. If you need bulk > 10K requests email us for a partner endpoint. |
| Auth | None โ public read-only. No writes no PII exposure. |
| Licence | CC 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.
Related Endpoints
https://www.yeatru.com/logistics-shipping.html?v=20260909kโ Sea freight LCL vs FCL comparison (Polish/DE/ES/FR) with real Ningbo → Gdynia/Hamburg/Valencia/Le Havre costshttps://www.yeatru.com/faq-knowledge-base.json?v=20260909kโ 27 procurement Q&As (YCS- internal KB)https://www.yeatru.com/brand-knowledge-base.json?v=20260909kโ Brand identity + YCS- SKU naming conventionhttps://www.yeatru.com/sitemap.xml?v=20260909kโ All 656 product pages + 44 category pageshttps://www.yeatru.com/robots.txt?v=20260909kโ Explicit allow-listing for GPTBot / CodexBot / ClaudeBot / PerplexityBot / GithubBot / Amazonbot