Computation only: conditional product / setup / add-on candidates from typed constraints (category, brand, formats, OS, license, budget), optional free text and user-claimed ownership, bound to one published snapshot. Each candidate has fit reasons, a cost breakdown over the offers this channel may disclose, budget fit, acquisition steps, canonical_page and site_entry_page. For a product candidate, canonical_page is the product page on this site; it carries the complete price table (including listings withheld on this channel), the merchant purchase links and the affiliate disclosure. site_entry_page is the same page with the entry marker for this channel. For a setup candidate canonical_page is the /find/ page. No purchase, no persistence, no notification. For a subscription or rent-to-own edition, cost_breakdown.payable_now is the first charge, recurring_cost one later charge (estimated) and recurring_period its period (month or year); with budget_scope=total_including_recurring_12m the total counts 12 monthly or 1 yearly charge, otherwise budget_fit is judged on the first payment. Where a product has one-off and recurring editions, the default scope prices the one-off edition and the 12-month scope the edition with the smallest 12-month total (assumptions key edition_choice). A price is taken from the default confirmed-route class first (a maker store or a confirmed authorized dealer selling new; for hardware also domestic distribution); when a cheaper confirmed listing of the same edition lies outside that class, the candidate's mismatches state it with its amount. search_complete=false with optimality_scope=best_found marks an answer cut at a limit, a free-text term that looks like a product name (Latin letters, digits or katakana) but matches no registered alias (unresolved_constraints no_alias_match), or no candidates (no_candidates). Free-text aliases match whole words only. With a budget, candidates are ordered by budget_fit first (confirmed, estimated_within, estimated_over, over, unknown) before the answer is cut to max_candidates; when in-budget candidates are still cut, limits_hit contains budget_fit_candidates_truncated. An edition with no price in the requested currency keeps its price in the original currency in cost_breakdown and acquisition_steps[].cost, with budget_fit unknown and the reason in the candidate's mismatches; such an amount may carry converted (a yen estimate: amount_minor, display such as 約¥7,800, rate_source ecb_eurofxref, rate_reference_date, rate_basis direct or cross_via_eur, and basis_note, a fixed English sentence saying that this site computed the estimate from the European Central Bank's reference rates of that date and that it is not a price) that is not used for ordering, budget fit, cheapest cost or lowest_observed. A product's default price uses general rows of unrestricted editions only. When a restricted edition (upgrade, crossgrade, update, EDU or NFR) is named, by constraints.target_edition_id or a free-text alias, or when all of a product's editions are restricted, the answer prices that edition and marks it: customer_segment on cost_breakdown.payable_now and total and on the step cost, reason_codes restricted_edition_price:<segment>, eligibility_status conditional, a sentence in the candidate's mismatches, and the assumption restricted_edition_price (value the segment, basis user_provided, parsed_from_query or default). A product candidate carries product_name, and price_checked_at is the check time of the price used. Stale offers (past fresh_until) are not used for costs or budget fit. Bounded compute class (10 per minute, shared with POST /api/v1/resolve). Links are user_navigation handoffs (handoff_mode=user_navigation) and are not intended for prefetching or automatic clicking.
View input schema
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "1.1"
},
"locale": {
"default": "ja-JP",
"type": "string",
"minLength": 2,
"maxLength": 32
},
"region": {
"default": "JP",
"type": "string",
"enum": [
"JP",
"US",
"EU",
"GB",
"GLOBAL"
]
},
"mode": {
"type": "string",
"enum": [
"find_product",
"build_setup",
"improve_setup"
]
},
"query": {
"type": "string",
"maxLength": 2000
},
"constraints": {
"default": {
"budget_scope": "incremental_upfront_total",
"presentation_sort": "fit"
},
"type": "object",
"properties": {
"budget": {
"type": "object",
"properties": {
"amount_minor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"enum": [
"JPY",
"USD",
"EUR",
"GBP",
"KWD"
]
}
},
"required": [
"amount_minor",
"currency"
],
"additionalProperties": false
},
"budget_scope": {
"default": "incremental_upfront_total",
"type": "string",
"enum": [
"incremental_upfront_total",
"total_including_recurring_12m"
]
},
"daw": {
"type": "string",
"enum": [
"logic-pro",
"ableton-live",
"cubase",
"studio-one",
"fl-studio",
"pro-tools",
"reaper",
"garageband",
"other"
]
},
"experience": {
"type": "string",
"enum": [
"beginner",
"intermediate",
"advanced"
]
},
"explanation_depth": {
"type": "string",
"enum": [
"standard",
"detailed"
]
},
"license_preference": {
"type": "string",
"enum": [
"perpetual",
"subscription",
"rent_to_own",
"free",
"trial",
"unknown"
]
},
"bundle_kind": {
"type": "string",
"enum": [
"vendor_bundle",
"setup_bundle"
]
},
"category": {
"type": "string",
"enum": [
"daw",
"instrument_plugin",
"effect_plugin",
"mastering_limiter_plugin",
"mastering_suite",
"restoration",
"sample_library",
"ai_separation",
"ai_restoration",
"ai_composition",
"ai_voice",
"vocal_synth",
"audio_interface",
"mixer",
"preamp_outboard",
"microphone",
"headphones",
"studio_monitor",
"guitar",
"bass",
"keyboard",
"synthesizer",
"electronic_instrument",
"pedal",
"multi_effect",
"amp_simulator",
"dj_controller",
"dj_player",
"dj_mixer",
"midi_controller",
"accessory",
"computer",
"computer_peripheral"
]
},
"brand": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"target_edition_id": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"formats": {
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"vst2",
"vst3",
"au",
"aax",
"clap",
"standalone"
]
}
},
"os": {
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"macos",
"windows",
"linux",
"ios",
"android"
]
}
},
"presentation_sort": {
"default": "fit",
"type": "string",
"enum": [
"fit",
"cost",
"fewer_steps"
]
},
"max_stores": {
"type": "integer",
"minimum": 1,
"maximum": 10
},
"exclude_hardware": {
"type": "boolean"
},
"delivery_deadline": {
"type": "string"
},
"setup_goal": {
"type": "string",
"enum": [
"guitar_recording",
"vocal_recording",
"dj_start",
"desktop_mixing"
]
}
},
"additionalProperties": false
},
"ownership_claims": {
"default": [],
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"entitlement_id": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"edition_id": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"kind": {
"type": "string",
"enum": [
"perpetual",
"time_limited",
"trial",
"free_giveaway",
"hardware_bundled",
"nfr",
"education"
]
},
"acquired_at": {
"type": "string"
},
"acquisition_source": {
"type": "string",
"enum": [
"purchase",
"giveaway",
"bundle",
"unknown"
]
},
"registered": {
"type": "boolean"
},
"region": {
"type": "string",
"enum": [
"JP",
"US",
"EU",
"GB",
"GLOBAL"
]
},
"transferable": {
"type": "boolean"
},
"edition_certainty": {
"type": "string",
"enum": [
"confirmed",
"unknown"
]
},
"verification": {
"type": "string",
"const": "user_claimed"
}
},
"required": [
"entitlement_id",
"edition_id",
"kind",
"acquisition_source",
"registered",
"verification"
],
"additionalProperties": false
}
},
"owned_editions": {
"default": [],
"maxItems": 200,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 160
}
},
"user_supplied_prices": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"offer_id": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"edition_id": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"price": {
"type": "object",
"properties": {
"amount_minor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"enum": [
"JPY",
"USD",
"EUR",
"GBP",
"KWD"
]
}
},
"required": [
"amount_minor",
"currency"
],
"additionalProperties": false
}
},
"required": [
"price"
],
"additionalProperties": false
}
},
"detail": {
"default": "summary",
"type": "string",
"enum": [
"summary",
"full"
]
},
"max_candidates": {
"default": 3,
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"schema_version",
"mode"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}