Temu API — Product Details, Variants and Prices
Documentation menu
FetchLayer FetchLayer API

Get one product in full

Read one Temu product, priced for one country storefront: title and URL, the default variant's current price, the price before the running promotion, the strikethrough list price, the discount, the lowest and highest variant price, the promotion and when it ends, the image gallery with dimensions, the video, the specification table and category ids — plus every listed variant with its skuId, price, discount, availability and attributes (color, size, material, pattern where Temu publishes them). Store the skuIds: they are what makes /price-check fast and light. Temu publishes each variant's own price only while a promotion runs; for other products the default variant is listed, the rest fall within priceRange, and notes says which case applies. Availability is checked for up to 20 variants; set includeVariantAvailability to false for a faster answer without it. A product that does not exist, or is no longer sold in that storefront, is a 404. Reviews, star ratings, sold counts, shipping and stock quantities are not available.

POST /product Products
https://api.fetchlayer.dev/temu/product
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

product string required

Temu product id (the goods_id, for example 607033881415363), or any Temu product URL. A URL that selects a variant with sku_id keeps that variant.

market string optional

Two-letter country of the storefront to price in. Prices, currency and availability all differ by storefront, and every result is priced for exactly one. One of AE, AT, AU, BG, BR, CA, CH, CL, CO, CZ, DE, DK, DO, DZ, ES, FI, GB, GR, GT, HU, IE, IL, IT, JP, KW, MA, MX, MY, NG, NZ, PE, PY, RO, SA, SE, TH, UA, US, UY, ZA. (default: US)

language string optional

Language for titles and attributes, for example en. Does not change prices. Defaults to the storefront's own language.

includeVariantAvailability boolean optional

Check each listed variant's own price and stock (up to 20). false answers faster and reports availability as unknown. (default: true)

format string optional

json or markdown. Markdown returns the same result rendered for a model to read. (default: json)

timeoutMs number optional

Time limit in milliseconds for each call to Temu (max 120000).

Response Fields

product

Get one product in full

requestedUrl string

The Temu page this result corresponds to.

scrapedAt string

When Temu was read, as an ISO timestamp.

transport string

Always temu — the upstream source this data came from.

notes string[]

Caveats about this specific result, such as a variant list that may be incomplete. Read it before treating a result as complete.

market object

The storefront the result was priced for: code, regionId, currency and language. Every price in the result is in market.currency.

resultType string

Always product.

product.goodsId string

Temu product id.

product.title string

Product title in the requested language.

product.url string

Product page URL on the storefront.

product.defaultSkuId string

The variant Temu shows by default; product.price describes it.

product.price object

Current price of the default variant: { amount, currency, display } — amount is a decimal (18.39), display is how Temu shows it ($18.39) or null.

product.originalPrice object

Price before the running promotion, or null.

product.listPrice object

The strikethrough reference price, where the storefront shows one (not every storefront does).

product.discountPercent number

Discount off the list price, in percent.

product.priceRange object

Lowest (min) and highest (max) regular price across the variants.

product.promotion object

The running promotion: name and endsAt, or null.

product.onSale boolean

Whether a promotion currently discounts the product.

product.images object[]

The gallery, each with url, width and height.

product.videoUrl string

Product video, when there is one.

product.properties object[]

The specification table as name / value pairs (material, brand, shape…).

product.categoryIds string[]

Temu's category ids for the product, broadest first.

variants object[]

The listed variants. Complete only while a promotion runs; otherwise the default variant, and notes says so.

variants[].skuId string

Variant id. Send it to /price-check for the fastest, lightest check.

variants[].price object

The variant's own price: { amount, currency, display } — amount is a decimal (18.39), display is how Temu shows it ($18.39) or null.

variants[].availability string

in_stock, out_of_stock, limited_availability, preorder, discontinued, or unknown when it was not checked. A status, not a unit count.

variants[].attributes object

color, size, material and pattern, where Temu publishes them.

variantCount number

Number of variants listed.

Request

curl -X POST "https://api.fetchlayer.dev/temu/product" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"product":"607033881415363","market":"US"}'

Response

{
  "blocked": false,
  "requestedUrl": "https://www.temu.com/soft-plush-and-pointed-bottom-home-decor-orange-blue-retro-floral-pattern-all-match-decorative-style-suitable-for-various-home-decorations-can-be-used-as-living-room-carpet-sofa-carpet-door-mat-bedroom-carpet-kitchen-carpet-g-607033881415363.html",
  "scrapedAt": "2026-09-12T22:19:15.558Z",
  "transport": "temu",
  "notes": [
    "Only variants Temu prices individually are listed; the product may have more."
  ],
  "resultType": "product",
  "market": {
    "code": "US",
    "regionId": 211,
    "currency": "USD",
    "language": "en"
  },
  "product": {
    "goodsId": "607033881415363",
    "title": "[Soft Plush And Pointed Bottom] Home Decor Orange Blue Retro Floral Pattern All-Match Decorative Style, Suitable for Various Home Decorations, Can Be Used As Living Room Carpet, Sofa Carpet, Door Mat, Bedroom Carpet, Kitchen Carpet",
    "url": "https://www.temu.com/soft-plush-and-pointed-bottom-home-decor-orange-blue-retro-floral-pattern-all-match-decorative-style-suitable-for-various-home-decorations-can-be-used-as-living-room-carpet-sofa-carpet-door-mat-bedroom-carpet-kitchen-carpet-g-607033881415363.html",
    "defaultSkuId": "117585735607558",
    "price": {
      "amount": 18.39,
      "currency": "USD",
      "display": "$18.39"
    },
    "originalPrice": {
      "amount": 19.44,
      "currency": "USD",
      "display": null
    },
    "listPrice": {
      "amount": 26.5,
      "currency": "USD",
      "display": "$26.50"
    },
    "discountPercent": 30,
    "priceRange": {
      "min": {
        "amount": 19.44,
        "currency": "USD",
        "display": "$19.44"
      },
      "max": {
        "amount": 76.58,
        "currency": "USD",
        "display": "$76.58"
      }
    },
    "promotion": {
      "name": "Big sale",
      "endsAt": "2026-09-21T06:59:59.000Z"
    },
    "onSale": true,
    "images": [
      {
        "url": "https://img.kwcdn.com/product/fancy/98112372-ebff-409f-8831-94e91c59b568.jpg",
        "width": 1200,
        "height": 1200
      }
    ],
    "videoUrl": "https://goods-vod.kwcdn.com/goods-video/f0d40987805976a5d4f787b9516eaf0e3e746f2c.f30.mp4",
    "properties": [
      {
        "name": "Material",
        "value": "100% Polyester"
      },
      {
        "name": "Backing Material",
        "value": "Rubber"
      },
      {
        "name": "Brand",
        "value": "ADSUVAN"
      }
    ],
    "categoryIds": [
      "9711",
      "12015",
      "12351",
      "12356"
    ]
  },
  "variants": [
    {
      "skuId": "117585735607558",
      "price": {
        "amount": 18.39,
        "currency": "USD",
        "display": null
      },
      "discountPercent": 30,
      "availability": "in_stock",
      "attributes": {
        "pattern": "Solid color"
      },
      "url": "https://www.temu.com/soft-plush-and-pointed-bottom-home-decor-orange-blue-retro-floral-pattern-all-match-decorative-style-suitable-for-various-home-decorations-can-be-used-as-living-room-carpet-sofa-carpet-door-mat-bedroom-carpet-kitchen-carpet-g-607033881415363.html?sku_id=117585735607558"
    },
    {
      "skuId": "117585735640326",
      "price": {
        "amount": 28.99,
        "currency": "USD",
        "display": null
      },
      "discountPercent": 24,
      "availability": "in_stock",
      "attributes": {
        "pattern": "Solid color"
      },
      "url": "https://www.temu.com/soft-plush-and-pointed-bottom-home-decor-orange-blue-retro-floral-pattern-all-match-decorative-style-suitable-for-various-home-decorations-can-be-used-as-living-room-carpet-sofa-carpet-door-mat-bedroom-carpet-kitchen-carpet-g-607033881415363.html?sku_id=117585735640326"
    },
    {
      "skuId": "117585735587078",
      "price": {
        "amount": 36.53,
        "currency": "USD",
        "display": null
      },
      "discountPercent": 40,
      "availability": "in_stock",
      "attributes": {
        "pattern": "Solid color"
      },
      "url": "https://www.temu.com/soft-plush-and-pointed-bottom-home-decor-orange-blue-retro-floral-pattern-all-match-decorative-style-suitable-for-various-home-decorations-can-be-used-as-living-room-carpet-sofa-carpet-door-mat-bedroom-carpet-kitchen-carpet-g-607033881415363.html?sku_id=117585735587078"
    }
  ],
  "variantCount": 6
}