Search printable products
search_productsRead-onlyIdempotent
Use this when the user wants their own picture, words or logo printed on a T-shirt, hoodie, sweatshirt or tote bag and delivered, as a gift or for themselves. Finds products by free text, category, colour and size. Returns product_id, image_url (a product photo, or null), colours, sizes and print placements. No account needed. Not for mugs, posters, caps, stickers or embroidery.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Only products available in this size, e.g. "XL". | |
| color | No | Only products available in this colour, e.g. "black". | |
| query | No | Free-text description, e.g. "heavyweight black t-shirt" or "hoodie". | |
| category | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| count | Yes | ||
| products | Yes |