Alternate
A candidate replacement part
One candidate in an AlternatesResult. Every candidate
carries its identity, stage, ranker score, and (once screened) its screening verdict. The
comparison fields are filled only when comparison_ready is true — the candidate was
shortlisted and its full datasheet comparison against the original finished.
JSON
1{2 "part": {3 "mpn": "TPS62841DLCR",4 "mpn_slug": "TPS62841DLCR",5 "manufacturer": {6 "slug": "texas-instruments",7 "name": "Texas Instruments"8 },9 "status": "active",10 "url": "https://zenode.ai/parts/..."11 },12 "stage": "evaluated",13 "comparison_ready": true,14 "discovery_source": "family_member",15 "discovery_sources": [16 "family_member",17 "parametric_match"18 ],19 "score": {20 "overall": 82.5,21 "spec_similarity": 91,22 "price_advantage": 64,23 "stock_availability": 88,24 "lifecycle_score": 100,25 "prefilter_boost": 526 },27 "screening": {28 "verdict": "likely_fit",29 "reasoning": "Same nano-power buck topology.",30 "key_features_matched": [31 "60 nA IQ"32 ],33 "key_features_missed": []34 },35 "tier": "drop_in",36 "replacement_type": "pin_compatible",37 "confidence": 0.9,38 "overview": "Pin-for-pin replacement with a wider input range.",39 "criteria_signals": {40 "func": "green",41 "specs": "green",42 "pinout": "green",43 "pkg": "green",44 "price": "yellow",45 "avail": "green",46 "life": "green"47 },48 "criteria_details": {49 "func": "Same topology and control mode.",50 "price": "About 8% more at 1k.",51 "...": "..."52 },53 "spec_comparisons": [54 {55 "spec_name": "Input voltage (max)",56 "prime_value": "5.5 V",57 "candidate_value": "6.5 V",58 "signal": "green",59 "delta": "+1 V",60 "group": "Electrical"61 }62 ],63 "package_note": "Same SOT-583 package and land pattern.",64 "footprint": {65 "package": "SOT-583",66 "body_size": "1.6 × 1.6 mm",67 "pitch": "0.5 mm",68 "pin_count": 8,69 "thermal_pad": "",70 "compatible": true,71 "summary": "Identical footprint."72 },73 "price_delta": {74 "text": "+8% at 1k",75 "signal": "yellow"76 },77 "availability_summary": {78 "total_stock": 48210,79 "distributor_count": 5,80 "packaging_options": [81 "Tape & Reel",82 "Cut Tape"83 ]84 },85 "custom_criteria": [86 {87 "name": "AEC-Q100",88 "signal": "red",89 "headline": "No",90 "explanation": "Not listed as automotive qualified.",91 "source_reference": "Features",92 "page_number": 193 }94 ]95}Identity and progress
| Field | Type | Notes |
|---|---|---|
part | PartSummary | The candidate; use manufacturer.slug + mpn_slug with the other endpoints |
stage | string | found → screened → evaluating → evaluated (full comparison done) |
comparison_ready | bool | true when the comparison fields below are filled |
discovery_source | string | null | The primary way it was found — e.g. cross_reference, family_member, series_sibling, parametric_match, ai_search, user_supplied |
discovery_sources | string[] | Every way it was found |
score | object | null | Deterministic 0–100 ranker facets: overall, spec_similarity, price_advantage, stock_availability, lifecycle_score, prefilter_boost |
screening | object | null | The quick datasheet check: { verdict, reasoning, key_features_matched, key_features_missed }; verdict is likely_fit or unclear |
Comparison (when comparison_ready)
Signals are green (matches), yellow (differs but likely acceptable), red (incompatible), or
none (not assessed).
| Field | Type | Notes |
|---|---|---|
tier | string | drop_in (swaps in with no board changes) | near_match (works with small changes) | needs_review (check the flagged points first) | not_recommended (ruled out) |
replacement_type | string | drop_in | pin_compatible | upgrade | downgrade | functional_equivalent | not_recommended |
confidence | number | 0–1 |
overview | string | Plain-language verdict on the candidate as a replacement |
criteria_signals | object | One signal per criterion: func, specs, pinout, pkg, price, avail, life |
criteria_details | object | The reasoning behind each signal, same keys |
spec_comparisons | object[] | Spec-by-spec rows: { spec_name, prime_value, candidate_value, signal, delta, group, filter_label, is_filtered, filter_summary } — prime_value is the original part's |
package_note | string | Short package comparison |
footprint | object | null | { package, body_size, pitch, pin_count, thermal_pad, compatible, summary } |
price_delta | object | null | { text, signal } |
availability_summary | object | null | { total_stock, distributor_count, packaging_options } |
custom_criteria | object[] | Your requirements, each checked on this candidate: { name, signal, headline, explanation, source_reference, page_number } |
Used by: AlternatesResult.