Temu: search products

Discover public products by search, select relevant results and use their identifiers or URLs for product detail requests.

5 credits per request. Public data only; GeckoAPI is independent of the marketplace.

Try this endpoint

Region, pagination and limitations

PDP supports br (BRL), us (USD), uk (GBP) and co (COP). Search supports br, us and uk. Region and URL country must agree. Search starts at page 1; use nextPageUrl to preserve its cursor. Product prices are in prices.min.amount; search prices are in items[].price.

HTTP request

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "temu.com",
  "type": "plp",
  "keyword": "Mouse",
  "page": 1
}'

Replace YOUR_API_KEY with your own server-side credential. Read the quickstart for authentication and error handling.

Supported inputs

Field	Requirement	Meaning
url	optional	Complete public search or product URL. Keep its country and query parameters.
keyword	conditional	Public search term. Use a query appropriate for the selected market.
page	optional	Search page number, where supported. See source-specific limits.
region	optional	Source-specific country code. See the regional notes below.
cursor	optional	Opaque continuation cursor from the previous response. Do not edit it.

Conditional means an alternative input can satisfy the request, such as keyword or search URL. Fields absent from this table are unsupported for this endpoint.

Example response

One possible response, not a guarantee of current price or availability. Product text stays in the source language. Fields may be missing or null; preserve that distinction in your database.

JSON

{
  "source": "temu.com",
  "type": "plp",
  "url": "https://www.temu.com/br/search_result.html?search_key=Mouse&page=1",
  "requestUrl": "https://www.temu.com/br/search_result.html?search_key=Mouse&page=1",
  "extractedAt": "2026-09-09T23:05:17.585429+00:00",
  "query": "Mouse",
  "region": "br",
  "totalResults": null,
  "primaryResults": 2,
  "page": 1,
  "resultsPerPage": 20,
  "offset": 0,
  "hasMore": true,
  "nextPage": 2,
  "nextPageUrl": "https://www.temu.com/br/search_result.html?search_key=Mouse&page=2&cursor=<cursor opaco retornado pela API>",
  "items": [
    {
      "position": 1,
      "productId": "604898057923527",
      "sku": "604898057923527",
      "url": "https://www.temu.com/br/product-g-604898057923527.html",
      "name": "Mouse Gamer Sem Fio para Escritório com Iluminação LED Vermelha, Mouse com Rastreamento, Sem Fio 2.4GHz, Alcance de 10m",
      "mallId": "635517740007167",
      "currency": "BRL",
      "currencyRaw": "R$",
      "price": 15.39,
      "priceDisplay": "R$15,39",
      "regularPrice": 28.63,
      "regularPriceDisplay": "28,63",
      "prices": {
        "price": 1539,
        "price_str": "R$15,39",
        "price_schema": "15.39",
        "market_price": 2863,
        "market_price_str": "28,63",
        "currency": "BRL"
      },
      "soldQuantity": null,
      "soldQuantityText": "2.8K+ vendidos",
      "aggregateRating": {
        "rating": 4.8,
        "reviewCount": 751
      },
      "thumbnail": "https://img.kwcdn.com/local-image/s132/211a2a4a582/d71ce1a4-2c03-4c87-8ad4-3a1f29811a37_800x800.jpeg.format.jpg",
      "images": [
        {
          "url": "https://img.kwcdn.com/local-image/s132/211a2a4a582/d71ce1a4-2c03-4c87-8ad4-3a1f29811a37_800x800.jpeg.format.jpg"
        }
      ],
      "sponsored": null
    },
    {
      "position": 2,
      "productId": "604579425058232",
      "sku": "604579425058232",
      "url": "https://www.temu.com/br/product-g-604579425058232.html",
      "name": "Mouse com Fio H'maston MS01, Mouse com Fio Superleve para PC, 1000-1600 DPI para PC",
      "mallId": "635517737924371",
      "currency": "BRL",
      "currencyRaw": "R$",
      "price": 11.71,
      "priceDisplay": "R$11,71",
      "regularPrice": 11.79,
      "regularPriceDisplay": "11,79",
      "prices": {
        "price": 1171,
        "price_str": "R$11,71",
        "price_schema": "11.71",
        "market_price": 1179,
        "market_price_str": "11,79",
        "currency": "BRL"
      },
      "soldQuantity": null,
      "soldQuantityText": "29 vendidos",
      "aggregateRating": {
        "rating": 5,
        "reviewCount": 3
      },
      "thumbnail": "https://img.kwcdn.com/local-image/s132/21137b22512/55d408bd-3e7e-4d33-b8db-eb078598d042_1200x1200.png.format.jpg",
      "images": [
        {
          "url": "https://img.kwcdn.com/local-image/s132/21137b22512/55d408bd-3e7e-4d33-b8db-eb078598d042_1200x1200.png.format.jpg"
        }
      ],
      "sponsored": null
    }
  ],
  "nextCursor": "<cursor opaco retornado pela API>"
}

Response fields

Field paths and types

{
  "source": "string",
  "type": "string",
  "url": "string",
  "requestUrl": "string",
  "extractedAt": "string",
  "query": "string",
  "region": "string",
  "totalResults": "number | null",
  "primaryResults": "number",
  "page": "number",
  "resultsPerPage": "number",
  "offset": "number",
  "hasMore": "boolean | null",
  "nextPage": "number | null",
  "nextPageUrl": "string | null",
  "items": "TemuPlpItem[]",
  "items[].position": "number",
  "items[].productId": "string",
  "items[].sku": "string",
  "items[].url": "string",
  "items[].name": "string",
  "items[].mallId": "string | null",
  "items[].currency": "string | null",
  "items[].currencyRaw": "string | null",
  "items[].price": "number | null",
  "items[].priceDisplay": "string | null",
  "items[].regularPrice": "number | null",
  "items[].regularPriceDisplay": "string | null",
  "items[].prices": "object",
  "items[].soldQuantity": "number | null",
  "items[].soldQuantityText": "string | null",
  "items[].aggregateRating.rating": "number | null",
  "items[].aggregateRating.reviewCount": "number | null",
  "items[].thumbnail": "string | null",
  "items[].images": "{ url: string }[]",
  "items[].sponsored": "boolean | null",
  "nextCursor": "string | null"
}