{"uid":"cap_q6Hlb8yxJMSji3W6wiNN1","slug":"scholarpulse-degree-roi-analysis-c6e70634","name":"ScholarPulse Degree ROI Analysis","description":"ScholarPulse: real-time scholarship and student finance intelligence for 190+ countries. Scholarship search, Erasmus+, FAFSA strategy, loan forgiveness, degree ROI, and merit aid. Pay-per-query via x402 on Base.","url":"https://scholarpulse-bice.vercel.app/api/roi","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"debt":{"type":"string","description":"45000 (total expected debt)"},"major":{"type":"string","description":"computer-science | nursing | education | liberal-arts | engineering"},"college":{"type":"string","description":"optional"},"country":{"type":"string","description":"US | UK | Australia | Canada (optional)"},"degree_level":{"type":"string","description":"bachelor | master | phd | associate | professional"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"roi_verdict":{"score":"7.8/10","summary":"CS degree at UT Austin with $45K debt has excellent ROI. Median starting salary of $85K gives a 0.53x debt-to-income ratio.","overall_rating":"strong"},"debt_analysis":{"dti_assessment":"excellent (<0.75x)","payoff_timeline":"4-5 years at standard repayment"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zZg2QGM21kI-k7pWYNDJe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns earnings vs. debt analysis by college major and institution, including debt-to-income ratio, loan payoff timeline, and alternative degree options using College Scorecard data.","exampleAgentPrompt":"Can you run a degree ROI analysis for a psychology major at NYU — I'm expecting around $65,000 in debt and want to see the debt-to-income ratio, how long it'll take to pay off, and any alternative majors with better financial returns?","exampleUseCases":[{"title":"Compare engineering programs for affordability","prompt":"I'm deciding between state schools and a private engineering program — can you show me the earnings potential, typical debt levels, and payoff timelines for each so I know which one actually makes financial sense?"},{"title":"Validate career change to nursing","prompt":"I'm thinking about switching from business to nursing because I want a career change, but I'm worried about starting over financially. Can you compare my earning potential and debt payoff timeline in nursing versus staying in business?"},{"title":"Find best ROI alternatives to expensive degree","prompt":"My kid wants to study art history at a private college, but I'm nervous about the debt. Can you show me what they'd earn versus owe, and then suggest some alternative majors or schools that would give them better financial returns?"}],"resultDescription":"Returns projected median earnings for the specified major and college, total estimated debt, debt-to-income ratio, estimated loan payoff timeline in years, and a list of alternative majors or institutions with stronger financial outcomes — all sourced from College Scorecard data.","failureModes":["Unknown or misspelled college name returns no data or an error","Highly niche majors not tracked in College Scorecard return empty results","Missing required parameters (major or college) result in a 400 error","Earnings data may be unavailable for very small programs with insufficient sample sizes","Network or upstream College Scorecard API downtime returns 503"],"whenToPreferThis":"Use this endpoint when a student or parent agent needs a data-driven financial analysis of a specific degree-college combination, including ROI benchmarks, payoff projections, and alternative recommendations. Prefer this over generic scholarship or aid endpoints when the core question is 'is this degree worth the debt?'","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:08.871Z","isFirstParty":false}