Skip to main content
POST
Analyze Amazon research evidence
This operation creates no Run and makes no Provider call. Source tokens are checked against the current Workspace and Key policy. Prices use one time-weighted series with explicit gaps, thresholds and definition boundaries. Costs remain supplied assumptions; unknown costs stay null. Review counts describe only the deduplicated sample. Opportunity ratings are analyst judgments subject to evidence gates, including comparable price series. source_charge_usd reports existing data costs separately from the free analysis.

Body

application/json
analysis
enum<string>
required
Available options:
price_history
token
string
required
Required string length: 1 - 16384
price_type
enum<string>
required
Available options:
AMAZON,
NEW,
LISTPRICE
from_at
string<date-time> | null

ISO-8601 UTC timestamp

to_at
string<date-time> | null

ISO-8601 UTC timestamp

minimum_change_percent
string | null

Exact non-negative percentage value (15.00 means 15%), with 2 to 6 decimal places.

Maximum string length: 24
Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
minimum_change_amount
string | null

Exact non-negative decimal amount in the specified currency, with 2 to 6 decimal places. No currency conversion.

Maximum string length: 24
Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
group_tolerance_amount
string | null

Exact non-negative decimal amount in the specified currency, with 2 to 6 decimal places. No currency conversion.

Maximum string length: 24
Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
minimum_available_hours
integer | null
Required range: x >= 1
unavailable_break_hours
integer | null
Required range: x >= 1

Response

AmazonAnalysisResult

analysis
enum<string>
required
Available options:
price_history,
economics,
reviews,
opportunity
result_status
enum<string>
required
Available options:
success,
no_result,
pending,
error
output
object
required
charge_usd
enum<string>
required
Available options:
0.00
source_charge_usd
string | null
required

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
runs
object[]
required
source_result_urls
string[]
required
error
object | null
required
request_charge
object

Request-scoped admission and Charge evidence. Record created_run_ids across the user's work, then count each settled Run once. Changing task_id does not turn an idempotent replay into a new Run. A result read has zero Charge and empty admission lists.