{"uid":"cap_bE9yVcXMfo-H-75LN1LFt","slug":"novapath-community-indicator-comparator-3605137d","name":"NovaPath Community Indicator Comparator","description":"Compare two community indicators for consistent definitions, populations, boundaries, reference periods, units and uncertainty. Withholds misleading differences and preserves source-specific margins of error.","url":"https://instructional-decision-engine-x402.vercel.app/research/indicator-compare?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"left":{"type":"object","required":["indicator","population","geographyLevel","geoid","boundaryYear","source","start","end","unit","estimate","moe","confidence"],"properties":{"end":{"type":"string","pattern":"^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"},"moe":{"anyOf":[{"type":"number","maximum":1000000000,"minimum":0},{"type":"null"}]},"unit":{"enum":["percent","count","usd"],"type":"string"},"geoid":{"type":"string","pattern":"^[0-9]{2}(?:[0-9]{3}(?:[0-9]{6})?)?$"},"start":{"type":"string","pattern":"^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"},"source":{"enum":["acs_1_year","acs_5_year","decennial","administrative","local_survey"],"type":"string"},"estimate":{"type":"number","maximum":1000000000,"minimum":0},"indicator":{"enum":["poverty","unemployment","child_population","housing_cost_burden","other"],"type":"string"},"confidence":{"enum":["90","95","99","unknown"],"type":"string"},"population":{"enum":["all_people","children_under_5","households","labor_force","other"],"type":"string"},"boundaryYear":{"type":"integer","maximum":2100,"minimum":1900},"geographyLevel":{"enum":["state","county","tract"],"type":"string"}},"additionalProperties":false},"mode":{"enum":["cross_section","change"],"type":"string"},"right":{"type":"object","required":["indicator","population","geographyLevel","geoid","boundaryYear","source","start","end","unit","estimate","moe","confidence"],"properties":{"end":{"type":"string","pattern":"^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"},"moe":{"anyOf":[{"type":"number","maximum":1000000000,"minimum":0},{"type":"null"}]},"unit":{"enum":["percent","count","usd"],"type":"string"},"geoid":{"type":"string","pattern":"^[0-9]{2}(?:[0-9]{3}(?:[0-9]{6})?)?$"},"start":{"type":"string","pattern":"^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"},"source":{"enum":["acs_1_year","acs_5_year","decennial","administrative","local_survey"],"type":"string"},"estimate":{"type":"number","maximum":1000000000,"minimum":0},"indicator":{"enum":["poverty","unemployment","child_population","housing_cost_burden","other"],"type":"string"},"confidence":{"enum":["90","95","99","unknown"],"type":"string"},"population":{"enum":["all_people","children_under_5","households","labor_force","other"],"type":"string"},"boundaryYear":{"type":"integer","maximum":2100,"minimum":1900},"geographyLevel":{"enum":["state","county","tract"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3GHNQJiZPACBiSNBgqaOv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares two community indicators for definitional consistency, population alignment, geographic boundary compatibility, reference period overlap, unit equivalence, and statistical uncertainty before yielding or withholding a comparison result.","exampleAgentPrompt":"Can you check whether these two poverty estimates are actually comparable — the left is an ACS 5-year estimate for county 06037 with boundary year 2020, covering all people, from 2019-01-01 to 2023-12-31, expressed as a percent, with an estimate of 14.2, margin of error 1.1, and 90% confidence; the right is an ACS 1-year estimate for the same county, boundary year 2020, all people, from 2023-01-01 to 2023-12-31, percent, estimate 13.8, margin of error 2.3, 90% confidence — run a cross_section comparison and tell me if any differences would be misleading.","exampleUseCases":[{"title":"Cross-source poverty rate sanity check","prompt":"Before I publish this chart, check whether the two county poverty rates I have are actually comparable: the left is an ACS 5-year percent estimate of 16.4 (MOE 1.2, 90% confidence) for all people in county 17031, boundary year 2020, covering 2017-01-01 to 2021-12-31; the right is a local survey percent estimate of 18.1 (MOE null, unknown confidence) for the same county, boundary year 2020, 2021-01-01 to 2021-12-31 — cross_section mode. Will comparing them be misleading?"},{"title":"Unemployment change over time validation","prompt":"I want to show change in unemployment between two periods for labor force in tract 110010100 — left: ACS 1-year, boundary year 2019, 2019-01-01 to 2019-12-31, percent, estimate 5.2, MOE 0.8, 95% confidence; right: ACS 1-year, boundary year 2020, 2021-01-01 to 2021-12-31, percent, estimate 8.7, MOE 1.1, 95% confidence — run a change mode comparison and flag if the boundary year shift makes this unreliable."},{"title":"Housing cost burden cross-section check","prompt":"Are these two housing cost burden estimates for households comparable? Left: ACS 5-year, county 36061, boundary year 2020, 2016-01-01 to 2020-12-31, percent, estimate 52.3, MOE 2.0, 90% confidence; right: decennial, county 36061, boundary year 2020, 2020-01-01 to 2020-12-31, percent, estimate 49.7, MOE null, unknown confidence — cross_section mode. Should I withhold this comparison from my report?"}],"resultDescription":"Returns a structured assessment indicating whether the two submitted indicators are methodologically comparable, itemizing which dimensions (definition, population, geography/boundary, reference period, unit, statistical uncertainty) are consistent or problematic. Misleading comparisons are withheld with an explanation; valid comparisons include source-specific margins of error preserved for downstream use.","failureModes":["Mismatched indicator enums (e.g. 'poverty' vs 'unemployment') cause an immediate incompatibility result rather than an error","Invalid GEOID format (must match state/county/tract digit pattern) returns a 400-level validation error","Unsupported source enum value causes schema rejection","MOE provided as negative number fails schema minimum validation","Reference period end before start may cause logic rejection","Boundary year outside 1900–2100 range fails validation","Unknown confidence level ('unknown') may reduce the informativeness of the uncertainty assessment but is accepted"],"whenToPreferThis":"Choose this endpoint when you need to programmatically guard against apples-to-oranges comparisons of community statistics before publishing, reporting, or feeding data into downstream models. It is especially valuable when combining data from different Census Bureau products (ACS 1-year vs 5-year vs decennial), different geographic vintages, or mixing administrative records with survey estimates — situations where naive subtraction or ratio calculations would mislead. Prefer it over manual review when margin-of-error preservation and boundary-year compatibility checking are required for statistical rigor.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:01.996Z","isFirstParty":false,"canonicalSlug":"novapath-community-indicator-comparator-3605137d"}