# Products and reviews: an agent skill

> What sells, and what do buyers say about it? A free skill for your AI on 2 platforms: e.g. 4 calls, at most $0.01, one table back.

Canonical page: https://okdata.online/skills/products/

**What sells, and what do buyers say about it?** Searches one page of products for a keyword, then reads one page of reviews for each of the first few, as one table: a row per review with the product's title, price and units sold beside it.

## Tell your AI

```text
Install the okdata skill okdata-products from https://okdata.online/.well-known/agent-skills/okdata-products/SKILL.md into your skills folder.
```

- SKILL.md: https://okdata.online/.well-known/agent-skills/okdata-products/SKILL.md
- Download (.zip): https://okdata.online/skills/okdata-products.zip

## Example run

| Platform | Endpoint | Calls | At most |
|---|---|---|---|
| TikTok | [tiktok.shop.products.search](https://okdata.online/apis/tiktok/shop/products/search/) | 1 | $0.004 |
| TikTok | [tiktok.shop.products.reviews.list](https://okdata.online/apis/tiktok/shop/products/reviews/list/) | 3 | $0.006 |

Total: 4 calls, ≤ $0.01

## Ask it like this

- What yoga mats sell best on TikTok Shop, and what do buyers complain about?
- Find the top three portable fans on Xiaohongshu's shop and read their reviews.
- What price range do the best-selling phone cases sit in?

## What it does

1. Call the product search with `query` and keep the first `products` results.
2. For each product kept, call its reviews endpoint with the product id, one page each.

## What you get back

Product, Price, Sold, Review, Rating, Review time, Link

## Inputs it needs

| Input | Needed | Meaning |
|---|---|---|
| `platform` | yes | The platform id, e.g. `douyin`, `tiktok`, `x`. |
| `query` | yes | The product keyword. |
| `products` | no | How many products to read reviews for, 1 to 5; 3 if not given. |

## Platforms and endpoints

- Xiaohongshu (RedNote): [Xiaohongshu shop product search](https://okdata.online/apis/xiaohongshu/shop/products/search/) `xiaohongshu.shop.products.search`, $0.02 per call · about 20 products per page
- Xiaohongshu (RedNote): [Xiaohongshu shop product reviews](https://okdata.online/apis/xiaohongshu/shop/products/reviews/list/) `xiaohongshu.shop.products.reviews.list`, $0.02 per call · about 12 reviews per page
- TikTok: [TikTok Shop product search](https://okdata.online/apis/tiktok/shop/products/search/) `tiktok.shop.products.search`, $0.004 per call · about 20 products per page
- TikTok: [TikTok Shop product reviews](https://okdata.online/apis/tiktok/shop/products/reviews/list/) `tiktok.shop.products.reviews.list`, $0.002 per call · about 20 reviews per page

The job it belongs to: [Product research API](https://okdata.online/solutions/product-research/)