Search documentation

Search across all documentation pages

Get API Key
Reference

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": 5
26 },
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": 1
93 }
94 ]
95}

Identity and progress

FieldTypeNotes
partPartSummaryThe candidate; use manufacturer.slug + mpn_slug with the other endpoints
stagestringfound → screened → evaluating → evaluated (full comparison done)
comparison_readybooltrue when the comparison fields below are filled
discovery_sourcestring | nullThe primary way it was found — e.g. cross_reference, family_member, series_sibling, parametric_match, ai_search, user_supplied
discovery_sourcesstring[]Every way it was found
scoreobject | nullDeterministic 0–100 ranker facets: overall, spec_similarity, price_advantage, stock_availability, lifecycle_score, prefilter_boost
screeningobject | nullThe 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).

FieldTypeNotes
tierstringdrop_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_typestringdrop_in | pin_compatible | upgrade | downgrade | functional_equivalent | not_recommended
confidencenumber0–1
overviewstringPlain-language verdict on the candidate as a replacement
criteria_signalsobjectOne signal per criterion: func, specs, pinout, pkg, price, avail, life
criteria_detailsobjectThe reasoning behind each signal, same keys
spec_comparisonsobject[]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_notestringShort package comparison
footprintobject | null{ package, body_size, pitch, pin_count, thermal_pad, compatible, summary }
price_deltaobject | null{ text, signal }
availability_summaryobject | null{ total_stock, distributor_count, packaging_options }
custom_criteriaobject[]Your requirements, each checked on this candidate: { name, signal, headline, explanation, source_reference, page_number }

Used by: AlternatesResult.