Product Finder
find_productsFilter every product Trueprice tracks across its Shopify stores, like the Product Finder at /product-finder (same filters, same results as GET /api/v1/finder). Drops are % below the product's highest in-stock price in the last 7 or 30 days (daily history starts 2026-11-13). new_days = listed by the store within N days (first seen after Trueprice's first read of that store). One currency at a time (default USD). Sorts: drop (dropped products first, biggest drop first), new (new listings first), price (lowest first), rating (best rated first), reviews (most reviewed first), rank (each product type's cheapest in-stock products first). Each row has rating + reviews from the store's review app and type_rank (#rank cheapest of of in-stock products of its product_type and currency). 20 results a page; each has a url to its Trueprice price-history page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| sort | No | drop | |
| brand | No | Brand (Shopify vendor), exact, any case | |
| query | No | Words that must all be in the title | |
| store | No | Store domain, e.g. example.com | |
| drop_7d | No | Minimum % drop over 7 days (1-100) | |
| currency | No | ISO currency, default USD | |
| drop_30d | No | Minimum % drop over 30 days (1-100) | |
| has_code | No | Only stores with a checked promo code | |
| in_stock | No | ||
| new_days | No | Only products newly listed in the last N days | |
| max_price | No | ||
| min_price | No | ||
| min_rating | No | Minimum star rating from the store's review app | |
| min_reviews | No | Minimum number of reviews | |
| product_type | No | Shopify product type, exact, any case |