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/domains lists your domains. Filters: query, extension, include_archived, limit, offset.
  • /api/v1/domains/example.com shows one domain.
  • /api/v1/renewals lists what renews in the next days. It takes days, from 1 to 730.
  • /api/v1/forecast adds up what the coming months cost.
  • /api/v1/savings finds domains that renew for at least $2 and 10% a year less elsewhere.
  • /api/v1/attention lists 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.

Free access