> ## Documentation Index
> Fetch the complete documentation index at: https://developers.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Temu plugin
> Temu product data as clean JSON - name, price, availability, rating, review count and images - plus keyword search that returns product URLs straight from Temu. No browser render.
The **Temu** plugin reads Temu product data as structured JSON. Temu never puts
product data in the HTML a browser gets - the page hydrates through a client-side
call that refuses automation - so the plugin reads the `ld+json` SEO document
Temu serves to search-engine crawlers instead. That document carries the real
fields: name, description, price and currency, availability, rating, review count
and the image list.
There are two endpoints: **product** (one product URL to full JSON) and
**search** (a keyword to Temu product URLs, taken straight from Temu's own search
page - no third-party search in the loop).
Try it in the dashboard first: [app.scrapeunblocker.com/dashboard/plugins](https://app.scrapeunblocker.com/dashboard/plugins). You get a live results view plus a copy-paste snippet.
Temu meters the crawler view, so this plugin is built for **targeted** use (price
checks, monitoring, comparison), not bulk crawling. It enforces its own
fleet-wide rate limit and answers `429` immediately when the budget is spent -
retry shortly rather than hammering. Price `currency` follows the exit IP's
region, so the same product can come back in `USD`, `EUR` or `AED`.
## Product
Fetch a single Temu product by URL.
```
POST /goods/temu-product
```
| Field | Required | Notes |
| ----- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `url` | yes | Full Temu product URL. Must be a product page - its path ends in `-g-.html`. Search / category URLs are rejected with `400`. |
```bash cURL theme={null}
curl -X POST "https://api.scrapeunblocker.com/goods/temu-product?url=https%3A%2F%2Fwww.temu.com%2Fexample-g-601099512345678.html" \
-H "x-scrapeunblocker-key: YOUR_API_KEY"
```
### Response
```json theme={null}
{
"url": "https://www.temu.com/example-g-601099512345678.html",
"name": "822pcs Spaceship Building Blocks Set",
"description": "Shop the 822pcs Spaceship Building Blocks Set on Temu ...",
"sku": null,
"brand": "Temu",
"price": "49.04",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock",
"rating": 4.6,
"reviewCount": 871,
"images": [
"https://img.kwcdn.com/product/fancy/xxxx.jpg"
]
}
```
| Field | Notes |
| --------------- | ---------------------------------------------------- |
| `name` | Product title. |
| `description` | Product description text. |
| `brand` | Brand name, if present. |
| `sku` | Source SKU when Temu includes one, else `null`. |
| `price` | Price as a string, as Temu serves it. |
| `priceCurrency` | ISO currency of `price`. Follows the exit IP region. |
| `availability` | schema.org availability URL, e.g. `.../InStock`. |
| `rating` | Average rating (out of 5). |
| `reviewCount` | Number of reviews. |
| `images` | Product image URLs. |
## Search
Search Temu for a keyword and get back the matching product URLs - about 40 per
call, straight from Temu's own search page. Search is discovery only: take the
URLs it returns and fetch each product's data (name, price, rating, reviews,
images) through **[Product](#product)** above.
```
POST /goods/temu-search
```
| Field | Required | Notes |
| --------- | -------- | ---------------------------------------------------------------------------------- |
| `keyword` | yes | Search phrase, e.g. `kids toys` or `phone case`. |
| `limit` | no | Max product URLs to return, default `40`, max `100`. One search page carries \~40. |
```bash cURL theme={null}
curl -X POST "https://api.scrapeunblocker.com/goods/temu-search?keyword=kids%20toys&limit=40" \
-H "x-scrapeunblocker-key: YOUR_API_KEY"
```
### Response
```json theme={null}
{
"keyword": "kids toys",
"resultsCollected": 40,
"urls": [
"https://www.temu.com/lt-en/kids-educational-building-blocks-set-g-601099613072998.html",
"https://www.temu.com/lt-en/water-elf-set-g-601104298893637.html"
]
}
```
Each entry is a clean product URL ending in `-g-.html` - pass it to
`POST /goods/temu-product` to get that product's fields.
## Errors
| Status | Meaning |
| ------ | ---------------------------------------------------------------------------------------------- |
| `400` | The `url` is not a Temu product page (path must end in `-g-.html`). Product endpoint only. |
| `429` | The plugin's fleet-wide Temu rate budget is spent. Retry shortly. |
| `502` | The product/search document could not be fetched (block or empty result). |
| `504` | The fetch timed out. |
## What you can build
* **Price monitoring** - track a product's `price` and `availability` over time.
* **Competitive research** - search a keyword for \~40 product URLs, then resolve each to compare prices, RRPs and ratings.
* **Catalog enrichment** - resolve Temu product URLs to clean fields (name, price, rating, images) for your own catalog.
## Next steps
Run a Temu lookup and grab the JSON.
Free trial available on the pricing page.