Temu API & Scraper
The Temu API returns product data as JSON from the selected US, UK, German or Turkish storefront.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Retrieve an exact product by goods_id or URL to read variant prices, published stock, images, seller details, attributes and description sections. US keyword search supplies product cards you can use to discover IDs. Search is limited to the first page; product availability and prices can differ between storefronts.
Temu market values and endpoint coverage
Send market explicitly when you need a particular storefront. US is the default.
| market | Storefront | Currency | Product detail | Keyword search |
|---|---|---|---|---|
| us | United States | USD | Supported | First page only |
| uk | United Kingdom | GBP | Supported | Not supported |
| de | Germany | EUR | Supported | Not supported |
| tr | Turkey | TRY | Supported | Not supported |
Support for a storefront does not guarantee that every product is listed there. Prices reflect that storefront, not a currency conversion of a US offer.
Real request and response JSON
Captured from the indexed primary action, product/detail, on .
{
"method": "POST",
"url": "https://api.reefapi.com/temu/v1/product/detail",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"goods_id": "601101448059028",
"market": "us"
}
}{
"ok": true,
"meta": {
"api": "temu",
"endpoint": "product/detail",
"mode": "live",
"latency_ms": 13081.7,
"record_count": 1,
"bytes": 2431632,
"cache_hit": false
},
"data": {
"product": {
"goods_id": "601101448059028",
"title": "Usb-Powered Touch Control LED Night Light with 3 Adjustable Colors And Dimmable Brightness - Embedded Wall-Mounted Bedroom Decor, Valentine'S Day Gift, Modern Home Ambiance Lighting, Minimalist Lamp, Sleek Cylindrical Design, Smooth End Lamp",
"market": "us",
"url": "https://www.temu.com/goods.html?goods_id=601101448059028",
"currency": "USD",
"price": 4.27,
"max_price": 4.27,
"price_display": "$4.27",
"price_range_display": "$4.27",
"price_note": "Observed storefront prices; variant or promotional prices may differ from the headline and checkout.",
"skus": [
{
"sku_id": "17599897197250",
"goods_id": "601101448059028",
"price": 4.27,
"normal_price": 4.27,
"normal_price_display": "$4.27",
"price_display": "$4.27",
"stock_quantity": 461,
"on_sale": true,
"purchase_limit": 99,
"image": "https://img.kwcdn.com/product/fancy/db95f11a-dfa8-42d0-bbc0-9dcf32f82e8b.jpg",
"specs": [
"[trimmed-depth]",
"[trimmed-depth]"
]
}
],
"images": [
"https://img.kwcdn.com/product/fancy/67073ceb-7fb9-4e96-a620-43db3d89ac61.jpg",
"https://img.kwcdn.com/product/fancy/3820f9d4-434f-4d84-995d-006d50e4a5e1.jpg",
"https://img.kwcdn.com/product/fancy/db95f11a-dfa8-42d0-bbc0-9dcf32f82e8b.jpg"
],
"videos": [
"https://goods-vod.kwcdn.com/goods-video/549ed897c9f812c2333826ad72868e37a7117b5c.f30.mp4"
],
"seller": {
"id": "1040714056890",
"name": "Chengwei blue"
},
"rating": 4.8,
"review_count": 303,
"sold_quantity": 11000,
"on_sale": true,
"properties": [
{
"key": "Material",
"values": [
"[trimmed-depth]"
]
},
{
"key": "Lamp Shade Material",
"values": [
"[trimmed-depth]"
]
},
{
"key": "Style",
"values": [
"[trimmed-depth]"
]
}
],
"description": [
{
"type": 2,
"items": [
"[trimmed-depth]"
]
},
{
"type": 1,
"items": [
"[trimmed-depth]"
]
},
{
"type": 1,
"items": [
"[trimmed-depth]"
]
}
]
}
}
}What the Temu API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| product/detail | Product detail with exact product and variant IDs, storefront prices, stock, images, seller, brand, category path, attributes and description. Product IDs are one global numbering, but each storefront carries its own catalogue: an ID that is not sold in the requested storefront returns NOT_FOUND (not charged, not retryable) with error.detail.reason not_sold_in_market when it is a product in another storefront, and goods_not_exist when it is not a product in any storefront. Use search with the same market to get IDs for that storefront. A sold-out listing is returned as a normal success with sold_out true and the source's own notice in sold_out_notice: the title, SKUs and per-SKU prices are still there, while the headline price, the seller and the images are not published on that page and come back null or empty. Shipping cost, delivery estimate and parcel weight are not published on the anonymous product page; weight is returned only when the listing carries a weight attribute. Promotional prices can differ from checkout. | Pricing teams call product/detail to get product detail with exact product and variant IDs, storefront prices, stock, images, seller,…. | goods_id, url, market |
| search | First page of keyword results in the US, UK, German or Turkish storefront: up to 40 products with prices, rating, review count, brand and images. Cards do not carry stock; use product/detail. Pagination is not supported. The price is flat per call regardless of max_results. | Marketplace operators call search to get first page of keyword results in the US, UK, German or Turkish storefront. | query, market, page, max_results |
Call product/detail from your stack
curl -X POST https://api.reefapi.com/temu/v1/product/detail \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"goods_id":"601101448059028","market":"us"}'import requests
r = requests.post(
"https://api.reefapi.com/temu/v1/product/detail",
headers={"x-api-key": REEF_KEY},
json={
"goods_id": "601101448059028",
"market": "us"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/temu/v1/product/detail", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"goods_id": "601101448059028",
"market": "us"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.temu.product/detail with {"goods_id":"601101448059028","market":"us"}.Who uses this API and why
- Enrich a product catalog with exact Temu product IDs, SKU options, images and localized attributes.
- Compare observed product and variant prices while preserving each storefront's currency.
- Monitor published SKU availability and keep separate records for each market.
- Find US product IDs with keyword search, then retrieve the corresponding product detail.
Questions developers ask before integrating
Is this an official Temu API?
No. ReefAPI is an independent data service, not Temu's official seller or partner API. These endpoints retrieve product data; they do not place orders or manage a Temu seller account.
Can I look up a Temu product URL?
Yes. Send a Temu product url or its exact goods_id to product/detail. If both are supplied, they must identify the same product. Select the required market explicitly.
Does the Temu API return sizes and SKU stock?
Product detail includes the published SKU list. Each SKU has its own ID, option specifications, observed price, on-sale status and stock quantity. Options may represent size, color, quantity or another product-specific choice.
Why can a SKU price differ from the product price?
The headline offer and individual variants can have different prices. Promotions and checkout eligibility can also affect the amount shown. Preserve both levels of pricing and the returned currency.
Can I paginate Temu search or search other countries?
Search currently supports only the US first page, with up to 40 results. Further pages and non-US search are rejected. Product detail separately supports us, uk, de and tr.
How should I handle slow or unsuccessful requests?
Allow a client timeout above 60 seconds. Begin with one request at a time, inspect ok and error.retryable, and apply bounded backoff. Respect the Retry-After header when the service returns RATE_LIMITED.
What is the Temu API?
Temu API is a ReefAPI endpoint group for product details, variant prices, stock and us keyword search. It returns live JSON through POST requests under /temu/v1.
Is the Temu API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Temu calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Temu login or account?
No login to Temu is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Temu data?
The page example is captured from a live product/detail call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Temu API use?
Temu actions currently cost 4 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Temu from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call temu actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Temu API a Temu scraper?
It is the managed alternative to a DIY Temu scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same product details, variant prices, stock and us keyword search back as clean JSON.
Why does my Temu scraper keep getting blocked?
Most Temu scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.