# Temu product data and keyword search

> Product detail with exact product and variant IDs, storefront prices, stock, images, seller, attributes and description. Availability differs by market. Promotional prices can differ from checkout.
> ReefAPI engine `temu` · 2 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/temu/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed or blocked calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http, `Authorization: Bearer <key>`) and your assistant can call these actions directly.

## Endpoints

### POST /temu/v1/product/detail — 4 credits
Product detail with exact product and variant IDs, storefront prices, stock, images, seller, attributes and description. Availability differs by market. Promotional prices can differ from checkout.

**Parameters:**
- `goods_id` (string, optional) — Exact Temu product ID; supply this or a Temu product URL.
- `url` (url, optional) — Temu product URL; supply this or goods_id.
- `market` (enum, optional, default "us") — Product storefront: US/USD, UK/GBP, Germany/EUR or Turkey/TRY. Search currently supports US only. [one of: us, uk, de, tr]

**Returns:** product{goods_id,title,url,market,currency,price,max_price,price_display,price_range_display,price_note,skus[]{sku_id,goods_id,price,price_display,normal_price,normal_price_display,stock_quantity,on_sale,purchase_limit,image,specs[]},images[],videos[],seller{id,name},rating,review_count,sold_quantity,on_sale,properties[],description[]}

### POST /temu/v1/search — 4 credits
First page of US keyword results, up to 40 products with prices and images. Further pagination and non-US search are not supported.

**Parameters:**
- `query` (string, required)
- `market` (enum, optional, default "us") — Search currently supports the US storefront only. [one of: us]
- `page` (integer, optional, default 1) — Only the first page is supported.

**Returns:** query,market,currency,results[]{goods_id,sku_id,title,url,image,price,price_display,normal_price,currency,sales_text},count,page,next_page,pagination_supported

## More
- Try it live, no code: https://reefapi.com/playground?engine=temu
- Human docs page: https://reefapi.com/docs/temu
- Overview page: https://reefapi.com/temu-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt