Quick start
One endpoint. Authenticate with the x-api-key header.
REQUEST
curl "https://youtility.abacusai.app/api/v1/utility-score?address=1600+Smith+St,+Houston,+TX" \ -H "x-api-key: yt_live_your_key_here"
RESPONSE
{
"location": {
"address": "1600 SMITH ST, HOUSTON, TX, 77002",
"city": "Houston",
"state": "TX",
"zipCode": "77002",
"precision": "rooftop"
},
"monthlyEstimate": { "low": 212, "high": 384, "currency": "USD" },
"utilities": [
{
"utilityType": "electricity",
"providers": [
{
"name": "Example Energy",
"prometheusScore": 87,
"monthlyCostLow": 72,
"monthlyCostHigh": 118,
"rating": 4.4,
"renewablePct": 100,
"factorBreakdown": [ /* 5 weighted factors */ ]
}
]
}
],
"meta": { "engine": "Prometheus v1", "rateLimitRemaining": 99 }
}addressFull street address, URL-encoded. Rooftop-accurate.
zip5-digit zip code. Use instead of address.
utilityOptional filter: electricity, gas, internet, water, trash, lawn, pool.
limitProviders per utility, 1–10. Default 3.
Scores come from the same unbiased Prometheus engine that powers the consumer app. Commercial relationships never influence a score or a ranking — for you or for our users.
Plans
Free
$0/mo
100 requests / day
Prototype and evaluate.
- Full Prometheus scores
- All 5 utility categories
- Address & zip lookup
Starter
$99/mo
2,500 requests / day
Small apps, single market.
- Everything in Free
- Email support
- Commercial use licence
Growth
$499/mo
10,000 requests / day
National production platforms.
- Everything in Starter
- Bulk address endpoint
- Priority support
Enterprise
Custom
Unlimited
Volume, SLA and data terms.
- Everything in Growth
- Custom SLA
- Raw market data feed
Free keys are issued instantly below. Paid plans are activated by our team — pick a tier and we'll be in touch.
Get your API key
Not a developer? Earn 10% as a referral partner
Realtors, property managers, movers, storage companies, brokers and utility providers can sign up in 30 seconds, get a YOUtility QR badge with their own code baked in, and earn 10% of every referral commission we receive when a client they sent connects a utility.
Your own branded QR
A downloadable YOUtility badge with your referral code embedded — for listings, welcome packs, invoices or your window.
Automatic tracking
Every scan and link click is tagged to your code through to the utility the client actually connects.
Live earnings & payouts
A private portal shows referrals, commission earned, what has been paid and your pending balance.