# Temu Search API (temu.search)

- Canonical page: [https://everyinfra.com/en/temu-api/search](https://everyinfra.com/en/temu-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "temu", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 40, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

Temu Search finds products on Temu by `keyword` and returns each product's ID, title, price and original price, discount percentage, rating and review count, units sold and the sales text shown on the page, shop ID and image. Use it to see what sells in a category on Temu, at what price and how well: cross-border product research, watching low-price competitors and mapping price bands.

Order results with `sort` by relevance, best sellers, newest or price in either direction. `sold_text` is the sales label on the page, such as 10K+ sold, a range rather than an exact figure, and `discount_pct` with `original_price` shows how deep a promotion goes. Temu limits access by region, so some regions or times may return nothing; a call that returns no rows is not charged.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=temu&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies the product search query for the search action. Some regions may return no results. |
| sort | enum: newest / popular / price_asc / price_desc / relevance | no | not declared | Sets the result ordering for the search action: relevance (default), popular by sales, newest listings, price ascending, or price descending. It reorders the returned products; it does not widen the result count — use limit for that. |
| limit | integer (1–100) | no | 40 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| product_id | platform-native meaning |
| title | Title. null when the platform has no titles (for example text-only posts). |
| url | Link to the record on the platform. |
| price | Price as a number without a currency symbol; see currency. |
| original_price | platform-native meaning |
| discount_pct | platform-native meaning |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| review_count | Number of reviews, for product and business capabilities. null means not disclosed, not 0. |
| sold_count | platform-native meaning |
| sold_text | platform-native meaning |
| shop_id | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "temu",
  "action": "search",
  "params": {
    "keyword": "desk organizer"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "temu",
        "action": "search",
        "params": {
            "keyword": "desk organizer",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 40. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "temu",
  "action": "search",
  "results": [
    {
      "product_id": 601103459446466,
      "title": "Multi-Tier Desk Organizer & Drawer Storage - Double Layer Desktop Shelf For Office Supplies, Stationery, Cosmetics | Space-Saving Cabinet For Bedroom, Office, Dorm Room Decor",
      "url": "https://www.temu.com/goods.html?goods_id=601103459446466",
      "price": 7.29,
      "original_price": 13.68,
      "discount_pct": 47,
      "currency": "USD",
      "rating": 0,
      "review_count": 0,
      "sold_count": 10000,
      "sold_text": "10K+ sold",
      "shop_id": 634418216917875,
      "image_url": "https://img.kwcdn.com/product/fancy/5157d76e-20ef-4da8-9586-03977bf19dbe.jpg",
      "platform": "temu",
      "rating_scale": 5
    },
    {
      "product_id": 601099651743804,
      "title": "360° Rotating Makeup Organizer - 1pc Plastic Cosmetic Storage with 5 Compartments - Multi-Functional Holder for Brushes, Lipsticks, Skin Care Products, and Stationery - Durable Unscented Desk Caddy with Stripe Design",
      "url": "https://www.temu.com/goods.html?goods_id=601099651743804",
      "price": 3.8,
      "currency": "USD",
      "rating": 0,
      "review_count": 0,
      "sold_count": 100000,
      "sold_text": "1M+ sold",
      "shop_id": 634418217537057,
      "image_url": "https://img.kwcdn.com/product/fancy/27e0e961-68f3-4c47-8dfe-fed8d3db6ecd.jpg",
      "platform": "temu",
      "rating_scale": 5
    }
  ],
  "count": 40,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Are the sales figures exact?

No. `sold_text` is the sales label shown on the page, such as 10K+ sold, which is a range, and `sold_count` is the matching number. Treat both as an order of magnitude when you compare products, not as exact sales.

### Why do some searches return nothing?

Temu restricts access by region, so a listed capability does not guarantee data from every region at every moment, and a restriction can mean no results. Calls that return no rows are not charged, so you can simply try again later.

### How do I find the deepest discounts?

Read `discount_pct`, the discount percentage, against `original_price` and `price`, and sort by `price_asc` to see the cheapest products first. Prices carry no currency symbol; read the currency from `currency`.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=temu
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
