Percentile-rank a single product price against tracked Amazon competitors in a CPG category.
Use when a multi-channel CPG brand asks where their Amazon listing price
sits against 100+ tracked products — e.g. checking whether a $4.99 granola
is competitively positioned on Amazon, auditing whether a retail MSRP is
reasonable against Amazon reality before a buyer meeting, or sanity-checking
a wholesale-to-retail markup.
Returns:
percentile_rank (string, e.g. "72nd percentile"),
price_index_label (ratio vs. category median),
position (Value / Parity / Premium),
category (resolved name),
last_refreshed (ISO timestamp),
cta (provenance note).
Args:
price: Product price in dollars (e.g. 4.99). Must be > 0 and <= 10000.
category: Exact category name — Grocery & Gourmet Food, Health & Beauty,
Household, or Pet Supplies. Case-insensitive. Call list_categories
first to confirm available names.
Connector