Temu API

Every Temu SKU with its price and stock, in 38 countries, as JSON

success rate
96%
median response
2.3s
fields per product
33
endpoints
5
Measured on live customer calls,

The Temu API returns Temu product data as JSON.

POST/temu/v1/product/detail
Real result, captured Sep 15, 2026
title

Usb-Powered Touch Control LED Night Light with 3 Adjustable Col…

price4.27 USD
max_price
4.27
price_range_display
$4.27
rating
4.8
market
us
review_count
303
5 active endpoints, on 3 and 4 credit tiers.product/detail · search · reviews · seller · seller_productsDetails ↓OpenAPI 3.0 spec ↗

4 credits per call≈ $4/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Temu API

5 of 5 endpoints, ready to run

View docs ↗

Look up an exact Temu product ID or URL. Get every SKU (each size, colour or pack) with its own price, list price and stock quantity, plus the price range, sold count, rating, review count, all images and videos, seller name, brand, category path, attributes and description.

4 credits0 required · 3 optional
POST/temu/v1/product/detail
ok13082 ms · 1 records · sample
{
  "ok": true,
  "meta": {
    "api": "temu",
    "endpoint": "product/detail",
    "mode": "live",
    "latency_ms": 13081.7,
    "record_count": 1,
    "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"
      ],
      "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]"
          ]
        }
      ]
    }
  }
}
Real response, fetched from the live endpoint with the parameters on the left — trimmed to the first few rows, with seller names left out. Press Try it for the untrimmed response.

Try every endpoint in the playground

Endpoints

What Temu endpoints does ReefAPI ship?

5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • product/detail

    4 cr

    Product detail with exact product and variant IDs, storefront prices, stock, images, seller,…

    required
    —
    optional
    goods_id, url, market
  • search

    4 cr

    First page of keyword results in the US, UK, German, Turkish, Canadian, French, Spanish, Ital…

    required
    query
    optional
    market, page, max_results
  • reviews

    4 cr

    Reviews of one product as Temu's product page publishes them.

    required
    —
    optional
    goods_id, url, market
  • seller

    4 cr

    A Temu store (seller) as the site publishes it.

    required
    —
    optional
    goods_id, url, mall_id, market
  • seller_products

    3 cr

    PARTIAL product list of a Temu store.

    required
    —
    optional
    mall_id, url, market

Every parameter, every allowed value →

Missing a Temu endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Temu API works

Temu is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 674 engines.

Call02
POST /temu/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
3 or 4 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a keyword to every variant's price, its reviews and its seller

Search a storefront to get product IDs, read product/detail for every SKU's price and stock, then pull the reviews and the store behind it.

01search
POST/temu/v1/search
{"query":"phone case","market":"us","page":1}

Take goods_id from a result. A search card has one price; the SKU list, stock and description come from product/detail.

02detail
POST/temu/v1/product/detail
{"goods_id":"601101362040331","market":"us"}

Read product.skus: each SKU has its own sku_id, specs (size, colour…), price and stock_quantity. Measured 2026-11-14: this product returned all 120 SKUs, each priced and stocked.

03reviews
POST/temu/v1/reviews
{"goods_id":"607146892696891","market":"us"}

Rating, review count, tags and the first reviews with the variant each reviewer bought. Measured: 4.9 from 56 reviews, store rating 4.7 from 1,006.

04seller
POST/temu/v1/seller
{"goods_id":"607146892696891","market":"us"}

The store behind the product: name, rating, review count, product count, followers, badges. Measured: PIXIUA, 4.7, 1,006 reviews, 72 products.

A product record tied to an exact goods_id, every SKU priced in the storefront's own currency with its stock, plus the review summary and the store profile. Keep goods_id, sku_id and market together in your database: a product ID is global, but each storefront has its own catalogue and prices.

request
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":"607146892696891","market":"us"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "temu",
    "endpoint": "product/detail",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What Temu data you get in each country

One row per Temu storefront, measured 2026-11-14. Send market explicitly; US is the default. "Every SKU" means each size, colour or pack option with its own sku_id, price and stock quantity.

marketCountryCurrencyEvery SKU (size, colour) with its price and stockSeller name, brand, category, attributes, description, all imagesKeyword searchReviews and seller store data
usUnited StatesUSDYesYesYes, first page (up to 20)Yes
ukUnited KingdomGBPYesYesYes, first page (up to 20)Yes
deGermanyEURYesYesYes, first page (up to 20)Yes
trTurkeyTRYYesYesYes, first page (up to 20)Yes
frFranceEURYesYesYes, first page (up to 20)Yes
esSpainEURYesYesYes, first page (up to 20)Yes
itItalyEURYesYesYes, first page (up to 20)Yes
nlNetherlandsEURYesYesYes, first page (up to 20)No
plPolandPLNYesYesYes, first page (up to 20)No
beBelgiumEURYesYesYes, first page (up to 20)No
atAustriaEURYesYesYes, first page (up to 20)No
ptPortugalEURYesYesYes, first page (up to 20)No
seSwedenSEKYesYesYes, first page (up to 20)No
chSwitzerlandCHFYesYesYes, first page (up to 20)No
dkDenmarkDKKYesYesYes, first page (up to 20)No
noNorwayNOKYesYesYes, first page (up to 20)No
fiFinlandEURYesYesYes, first page (up to 20)No
ieIrelandEURYesYesYes, first page (up to 20)No
czCzech RepublicCZKYesYesYes, first page (up to 20)No
grGreeceEURYesYesYes, first page (up to 20)No
roRomaniaRONYesYesYes, first page (up to 20)No
huHungaryHUFYesYesYes, first page (up to 20)No
ilIsraelILSYesYesYes, first page (up to 20)No
zaSouth AfricaZARYesYesYes, first page (up to 20)No
saSaudi ArabiaSARYesYesYes, first page (up to 20)No
aeUnited Arab EmiratesAEDYesYesYes, first page (up to 20)No
caCanadaCADNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
auAustraliaAUDNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
mxMexicoMXNNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
nzNew ZealandNZDNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
brBrazilBRLNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
phPhilippinesPHPNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
myMalaysiaMYRNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
thThailandTHBNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
sgSingaporeSGDNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
jpJapanJPYNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
krSouth KoreaKRWNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No
clChileCLPNo: title, product page price, rating, review count, image and one SKUNo: seller ID, brand and one imageYes, first page (up to 20)No

A product ID is one global number, but each storefront has its own catalogue: an ID not sold in the requested storefront returns NOT_FOUND (not charged) with reason not_sold_in_market or goods_not_exist. Prices are each storefront's own, not a currency conversion of a US offer.

Coverage

Which Temu countries and fields are covered?

Measured on 2026-11-14 through the live API. Product detail, search, reviews and seller have different country coverage; the table below lists every storefront.

Every SKU with its price and stock — 26 countries

United States, United Kingdom, Germany, Turkey, France, Spain, Italy, Netherlands, Poland, Belgium, Austria, Portugal, Sweden, Switzerland, Denmark, Norway, Finland, Ireland, Czech Republic, Greece, Romania, Hungary, Israel, South Africa, Saudi Arabia and the United Arab Emirates. Each SKU (every size, colour or pack) comes with its own sku_id, price, list price, stock quantity and options, alongside the sold count, rating, review count, all images, seller name, brand, category path, attributes and description. US measured 2026-11-14: 10 of 10 products full, from 1 to 120 SKUs, price and stock on every SKU. The 19 storefronts added that day: 54 of 56 measured products full within three attempts (the other two full on a later attempt), 4 to 268 SKUs each.

Title, price, rating and one SKU only — 12 countries

Canada, Australia, Mexico, New Zealand, Brazil, the Philippines, Malaysia, Thailand, Singapore, Japan, South Korea and Chile. Their product page asks every anonymous visitor for verification, so product/detail returns title, product page price and currency, rating, review count, image, brand, seller ID, fulfillment and the search card's SKU, marked detail_level "partial" with partial_reason. The SKU list, stock and description are not available there.

Keyword search — all 38 countries

All 38 countries above, with prices in each country's own currency. First page only: Temu currently returns up to 20 cards per search, so max_results above 20 does not bring more and page>1 is rejected. Prices are that storefront's own prices in its own currency, not a conversion of a US price. Yen, won and Chilean peso prices are whole units (507 means 507円).

Reviews and seller store data, 7 countries

US, UK, Germany, Turkey, France, Spain and Italy. reviews: 17 of 17 measured products; rating, text, date, reviewer name as shown, SKU and specs filled on all 52 reviews read, photos where the reviewer added them. Up to 4 reviews per product (the first block the product page shows); further pages and the star distribution are not available. seller: 11 of 11 by product ID, 17 of 18 stores by store ID; for the store's products, see seller_products below.

Store products from reviews (partial list), 7 countries

seller_products takes a store ID or store URL in the US, UK, Germany, Turkey, France, Spain or Italy and lists the products that appear in the store's latest published reviews (up to the latest 1,000): goods_id, url, price in the storefront's currency, sold_out, image, times_seen_in_reviews and last_review_at. It is not the full catalogue, so the answer says source store_reviews, partial true, and coverage (products on sale found divided by the store's own product count). There are no product titles, because the site masks words in this source; call product/detail with a goods_id for the full card. Measured 2026-11-16 on 19 US stores: median coverage 67% of the items on sale, complete on small stores (JHFTECH 5 of 5), about 15 to 80% on stores with 50 to 340 items, none on the two stores with more than 1,000 items. Outside the US fewer stores list products (UK 1 of 2 stores, Germany 2 of 4, Turkey 1 of 3). A store with no listed products returns NOT_FOUND, not charged; a successful call costs 3 credits.

Prices

Headline price, price range and every SKU price are separate decimal amounts in the returned currency, with the site's own display string beside each. In the 12 countries without the SKU list, the price is the product page price; when a search card lists it lower after an automatic search-only promotion, price_note says so. Checkout prices for a logged-in account can differ.

Fulfillment

Every search card and product carries local_warehouse (the site's "Local warehouse" label), fulfillment (fully_managed, semi_managed or local_seller) and fulfillment_raw with the source's own codes. Checked against the site's own label on 438 search cards and 40 product pages in six storefronts, 2026-11-11.

Request handling

Allow a client timeout above 60 seconds. Calls that fail, time out or find nothing are not charged. A product ID that is not sold in the requested storefront returns NOT_FOUND with reason not_sold_in_market (sold in another storefront) or goods_not_exist. For RATE_LIMITED, honour Retry-After.

Use cases

What people build with Temu

The jobs this data is most often used for.

01

Monitor the price of every SKU (each size and colour) of hundreds of Temu listings, per country.

02

Compare the same product's price and availability across up to 38 Temu storefronts, each in its own currency.

03

Track stock quantities per variant to see what sells out and when.

04

Vet a Temu seller before sourcing: store rating, review count, product count, followers and time on Temu.

5

endpoints

3/4

credits per call

Pricing

What Temu data costs

The cheapest call here is 3 credits, so $15/mo (Pro) buys 3,333 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 674 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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":"607146892696891","market":"us"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/temu/v1/product/detail",
    headers={"x-api-key": REEF_KEY},
    json={
        "goods_id": "607146892696891",
        "market": "us"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Temu.

Is there an API for Temu product data?▾

Yes. ReefAPI's Temu API returns Temu product data as JSON: every SKU (size, colour, pack) with its own price and stock quantity in 26 countries including the US, keyword search in 38 countries, plus product reviews and seller store data. Temu's own developer APIs serve sellers and partners managing their own shop; ReefAPI is an independent service, not affiliated with Temu, and it does not place orders or log into accounts.

Can I get Temu stock / inventory quantity per variant?▾

Yes, in 26 countries. product/detail returns stock_quantity on every SKU, so each size and colour has its own published stock count next to its price and on-sale flag. Measured 2026-11-14: a US bed skirt returned stock on all 120 SKUs (for example Natural Beige / Twin: 189 in stock at $6.26). Stock is the storefront's published figure, not a reservation.

Can I get the price of every size and colour of a Temu product?▾

Yes. product/detail returns product.skus, one record per variant with its sku_id, its specs (for example Color: Natural Beige, Size: King), its own price, list price, stock quantity and on-sale flag. Measured on 2026-11-14 on the US storefront: a bed skirt returned all 120 SKUs, priced from $5.77 to $8.84 with stock on every one, and a Netherlands product returned 232 SKUs in EUR.

Does the Temu API work for the US storefront?▾

Yes: every SKU with its price and stock. On 2026-11-14 10 of 10 measured US products came back with every SKU, between 1 and 120 SKUs each, price and stock on every SKU. If a US product page cannot be read on any attempt, the API returns the title, price, rating and one SKU (marked detail_level "partial") rather than failing.

Which countries does the Temu API cover?▾

38 countries for keyword search. Every SKU with price and stock in 26: US, UK, Germany, Turkey, France, Spain, Italy, Netherlands, Poland, Belgium, Austria, Portugal, Sweden, Switzerland, Denmark, Norway, Finland, Ireland, Czech Republic, Greece, Romania, Hungary, Israel, South Africa, Saudi Arabia and the UAE. Title, price, rating and one SKU only in 12: Canada, Australia, Mexico, New Zealand, Brazil, the Philippines, Malaysia, Thailand, Singapore, Japan, South Korea and Chile, where Temu's product page asks every anonymous visitor for verification.

In which countries do I get every Temu SKU with its price and stock?▾

In 26 storefronts: United States, United Kingdom, Germany, Turkey, France, Spain, Italy, Netherlands, Poland, Belgium, Austria, Portugal, Sweden, Switzerland, Denmark, Norway, Finland, Ireland, Czech Republic, Greece, Romania, Hungary, Israel, South Africa, Saudi Arabia and the United Arab Emirates. There product/detail returns each SKU (every size, colour or pack) with its own sku_id, price in the local currency, stock quantity and options, plus images, seller name, brand, category, attributes and description.

What do I get for Temu Canada, Australia, Mexico, Japan and Brazil?▾

In Canada, Australia, Mexico, New Zealand, Brazil, the Philippines, Malaysia, Thailand, Singapore, Japan, South Korea and Chile, Temu's product page asks every anonymous visitor for verification. product/detail there returns: title, the product page price in the local currency, rating, review count, image, brand, seller ID, fulfillment and the one SKU shown on the search card, marked detail_level "partial". The full SKU list, per-SKU stock, seller name and description are not available. Keyword search works fully in all 12.

Can I get Temu reviews?▾

Yes, in the US, UK, Germany, Turkey, France, Spain and Italy. reviews returns the average rating, total review count, Temu's review tags with counts, the apparel fit split, the store's rating, and the first reviews the product page shows (up to 4), each with rating, text, date, reviewer name as shown, the variant bought, photos and helpful count. Measured: 4.9 from 56 reviews on product 607146892696891. Further review pages and the star distribution are not available.

Can I look up a Temu seller or store?▾

Yes. seller takes any product ID of the store, its store ID (seller.id from product/detail) or a store URL, and returns the store name, logo, rating, review count, number of products, items sold as Temu rounds it, followers, badges and time on Temu. Measured: store PIXIUA, rating 4.7 from 1,006 reviews, 72 products. For the store's products, call seller_products (next question).

Can I list all products of a Temu store?▾

Partly. Temu does not serve a store's own product list to anonymous visitors, so seller_products lists the products that appear in the store's latest published reviews: goods_id, url, price, sold_out, image, times_seen_in_reviews and last_review_at, with coverage against the store's own product count. Product titles are not included (the site masks them in this source); call product/detail with a goods_id for the full product. Measured 2026-11-16 on 19 US stores: median coverage 67%, complete on small stores (JHFTECH 5 of 5), none on the two stores with more than 1,000 items. US, UK, Germany, Turkey, France, Spain and Italy; 3 credits per successful call, and a store with no listed products returns NOT_FOUND without charge.

Why can a SKU price differ from the product price?▾

The headline price is the cheapest offer; each variant has its own price, and some search cards show a lower price after an automatic search-only promotion that the product page does not show (price_note says so in the 12 countries without the SKU list). Keep both levels and the returned currency.

Can I paginate Temu search?▾

No. Search returns the first page, which Temu currently serves as up to 20 cards; page>1 is rejected and max_results above 20 returns 20. To go wider, vary the query.

How should I handle slow or unsuccessful requests?▾

Allow a client timeout above 60 seconds and inspect ok and error.retryable. Failed, timed-out and empty calls are not charged. Respect the Retry-After header when the service returns RATE_LIMITED.

What is the Temu API?▾

Temu API is a ReefAPI endpoint group for every sku (size, colour) with its own price and stock in 26 countries including the us, keyword search in 38, plus reviews and seller store data. It returns live JSON through POST requests under /temu/v1.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 673 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-14.

Also on this pageFrançaisDeutschTürkçe