# Extract the next new product for a keyword — Soicos

Botize method — `soicos.search` (trigger).

Returns the next product in a search.

- You can select only the products that are within a set minimum and maximum price.

This is a trigger: it starts the task. A task has exactly one.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `program_id` *(string)* — Program Id
- `brand_id` *(string)* — Brand Id
- `category_id` *(string)* — Category Id
- `price_from` *(string)* — Min. Price
- `price_to` *(string)* — Max. Price
- `cache_duration_hours` *(string, one of: "24" = 24 Hours; "48" = 2 Days; "72" = 3 Days; "96" = 4 Days; "120" = 5 Days; "144" = 6 Days; "168" = 7 Days)* — Do not repeat products during the following hours
- `max_page` *(string, one of: "" = Products from all pages; "1" = Only products from 1st page (100 products per page); "2" = 2 Product pages maximum; "3" = 3 Product pages maximum; "4" = 4 Product pages maximum; "5" = 5 Product pages maximum; "10" = 10 Product pages maximum; "15" = 15 Product pages maximum; "20" = 20 Product pages maximum; "25" = 25 Product pages maximum)* — Max pages

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{title}}` *(text)* — Title
- `{{product_id}}` *(text)* — Product Id
- `{{url}}` *(text)* — Product URL
- `{{image_url}}` *(text)* — Image URL
- `{{currency}}` *(text)* — Currency
- `{{category}}` *(text)* — Category
- `{{brand}}` *(text)* — Brand
- `{{current_price}}` *(decimal)* — Current price
- `{{previous_price}}` *(decimal)* — Previous price
- `{{description}}` *(text)* — Description

## Account

Needs a connected Soicos account in Botize: https://botize.com/en/app/soicos/authenticate

## This app

Every trigger and action for Soicos: https://botize.com/en/app/soicos.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/soicos/search