Which fields does a Cartroute response contain?

Updated September 23, 2026 · API version 2026-09-01 · This page as JSON

Every result is a product with a price_summary, a price_insight and an array of offers; each offer carries its own coupons. Money fields end in _usd and are plain numbers. The field to rank on is offer.effective_price_usd.

What is in a product?

Field	Type	Description
`id`	string	Stable id, `prd_…`.
`slug`, `url`	string	Readable identifier and the product's page on cart-route.com.
`title`, `brand`, `category`, `subcategory`	string	Descriptive fields.
`identifiers`	object	`gtin`, `mpn`, `model`. Offers are matched across retailers on these, never on title.
`rating`, `review_count`	number	Aggregate rating out of 5.
`summary`	string	An editorial note on buying this product, often about how its price behaves.
`specs`	object	Display-ready specifications. Only on get product.
`price_summary`	object	See below.
`price_insight`	object	See below.
`offers`	array	Sorted by effective price, cheapest first.

What does price_summary tell me?

Field	Description
`best_offer_id`, `best_retailer`	The in-stock offer with the lowest effective price (falls back to any offer if none is in stock).
`best_effective_price_usd`	That offer's effective price.
`lowest_price_usd`, `highest_price_usd`, `spread_usd`	The range of listed prices across offers.
`offers_count`, `in_stock_count`, `coupons_count`	Counts after your filters are applied.

What does price_insight tell me?

Field	Description
`verdict`	`good_time_to_buy` (within 1% of the 90-day low), `above_recent_average` (more than 5% above the 30-day average), `typical_price`, or `insufficient_history`.
`reason`	One sentence with the numbers behind the verdict, suitable to quote.
`low_90d_usd`, `high_90d_usd`, `avg_30d_usd`	Computed from the daily lowest price across retailers.
`trend_30d_pct`, `is_at_90d_low`, `observations`	Direction, low flag, and number of daily data points.

What is in an offer?

Field	Description
`offer_id`, `sku`	Offer id and the retailer's SKU.
`retailer`	`id`, `name`, `domain`, `membership_required`, `returns_window_days`.
`condition`	`new` or `open_box`. Open-box offers are separate offers, never mixed with new.
`price_usd`	Listed price.
`list_price_usd`, `discount_from_list_pct`	Manufacturer list price and the discount from it.
`shipping_usd`	Standard shipping; 0 above the retailer's free-shipping threshold.
`landed_price_usd`	Price plus shipping, before tax.
`best_coupon`	The applicable coupon with the largest saving that needs no special eligibility, or `null`.
`effective_price_usd`	Landed price minus `best_coupon.estimated_savings_usd`. Rank on this.
`coupons`	Every applicable coupon, including ones needing eligibility. See coupons.
`availability`	`in_stock`, `stock_level` (`in_stock`, `low_stock`, `out_of_stock`, `preorder`), `delivery_days_min`, `delivery_days_max` (null when pickup-only), `store_pickup`.
`retailer_url`	Direct link to the retailer.
`buy_url`	Tracked redirect to the same place, via cart-route.com.
`last_checked_at`, `freshness_seconds`	When the price was last observed and how long ago.

How exactly is effective price calculated?

Start from price_usd.
Add shipping_usd to get landed_price_usd. Tax is excluded because it depends on the delivery address.
From the coupons that apply to this product and retailer, meet their minimum spend and need no eligibility, take the single largest saving. Coupons are never stacked. A percent coupon saves that share of the price; amount saves a fixed sum; shipping saves the shipping charge; gift_card saves nothing up front.
Subtract it to get effective_price_usd.

The full method, with its limits, is in how Cartroute compares prices.

What is in every response envelope?

object (the response type), api_version, data_source, request_id (quote it to support), generated_at, and on metered calls credits. A replayed idempotent call adds idempotent_replay: true.