The domaroo API
Read your domains and what they cost as JSON. It only reads. It uses the same tokens as the domaroo MCP server.
Authentication
Make a token in Settings, under AI agents (MCP). Send it with every request, in the Authorization header after the word Bearer. No token, no data.
Addresses
Each address answers a GET request with JSON. Amounts are in your account's currency, in units like 12.5. Dates follow your time zone.
/api/v1/domainslists your domains. Filters: query, extension,include_archived, limit, offset./api/v1/domains/example.comshows one domain./api/v1/renewalslists what renews in the next days. It takes days, from 1 to 730./api/v1/forecastadds up what the coming months cost./api/v1/savingsfinds domains that renew for at least $2 and 10% a year less elsewhere./api/v1/attentionlists what needs a decision now.
Limits
A token can make 120 requests a minute. After that, domaroo answers 429 until the minute ends. Nothing here can buy or move a domain.
Example
The command below asks for the renewals of the next 60 days. Put your own token in place of YOUR_TOKEN.
curl -H "Authorization: Bearer YOUR_TOKEN" "https://domaroo.com/api/v1/renewals?days=60"
Command line
There's also a small command-line tool. It's one file for Node 18 or newer, and it uses the same token.
curl -O https://domaroo.com/cli/domaroo.mjs
export DOMAROO_TOKEN=YOUR_TOKEN
node domaroo.mjs renewals --days 60
Its commands are domains, domain, renewals, forecast, savings and attention. Add --json for the answer as it comes. Read the file before you run it: it only reads.