check_availability
Check domain availability
Check whether domain names are registered, asking each TLD's registry directly (RDAP). Returns registered, available, likely_available (no registry lookup service, but no DNS records either) or unknown, plus the registrar and dates for taken names and the cheapest prices for open ones. Up to 20 names per call. A lookup is not a reservation: names can be taken at any moment, and premium or reserved names may still be priced higher or blocked at checkout.
输入参数domains必填
compare_prices
Compare registrar prices for a TLD
Every tracked registrar's price for one TLD, in US dollars per year, refreshed daily from 40+ registrars. Sorted by 3-year cost (first year plus two renewals) by default, because a cheap first year often hides an expensive renewal. Each offer links to where to buy.
输入参数tld必填sortlimit
suggest_names
Suggest available domain names
Turn a few keywords into domain name candidates (the words joined, with common prefixes and suffixes, across several TLDs), check each with its registry, and return the available ones with prices. For your own name ideas, use check_availability.
输入参数tldslimitkeywords必填
Who runs a TLD, its type (generic, country-code, ...), when it was delegated, its registry's website and lookup servers (from IANA), and its cheapest first-year, renewal and 3-year prices.
输入参数tld必填
price_history
Price history for a TLD
Every recorded price change for one TLD, oldest first, from GoMain's daily archive. A registrar's first entry is its price when the archive began (or when it started selling the TLD); later entries are changes. Prices are per year, in US dollars unless `currency` says otherwise.
输入参数tld必填registrar
check_name
Check a name everywhere
Is a project name usable everywhere it'll be needed? Checks the domain across TLDs (with prices), GitHub, npm, PyPI and crates.io, and gives links for trademark and social-handle checks that can't be automated.
输入参数name必填tlds
dns_setup
DNS records for a website and email
The exact DNS records to add so a domain serves a website (Vercel, Netlify, GitHub Pages, Cloudflare Pages) and receives email (Google Workspace, Microsoft 365, Fastmail, Zoho, Proton), plus a starting DMARC policy. Checks live DNS to show which records are already in place and warns about clashes such as two SPF records. Values a provider generates per account are marked as such.
输入参数emaildomain必填accountwebsite
appraise_domain
Estimate a domain's value
A rough value range for a domain, from its length, how easy it is to say, its TLD, its age and how many popular TLDs have the same name registered. Use it to set a realistic budget before trying to buy a taken name. Not a comparable-sales appraisal.
输入参数domain必填
acquisition_report
How to get a taken domain
For a domain someone already owns: whether it's listed for sale and where (with the asking price when the sale page shows one), when it could drop, its estimated value, the realistic chance of buying it, the options in order (buy now, make an offer, backorder, have GoMain broker it, watch it) and available alternatives with prices.
输入参数domain必填
request_acquisition
Have GoMain buy a taken domain
Ask GoMain's brokerage to acquire a domain someone else owns. GoMain researches it, approaches the owner without naming the buyer, negotiates within the budget (which the owner never sees), and closes through Escrow.com. Confirm the buyer's email and budget with the user before calling. Returns a deal id and status key for broker_status.
输入参数email必填notesdomain必填max_budget必填
search_domains_for_sale
Search names for sale on GoMain
Search domains their owners have listed for sale with GoMain (each owner proved control of the name). Returns asking prices where set; make_offer buys or negotiates.
输入参数keywordsmax_price
make_offer
Make an offer on a GoMain listing
Offer to buy a domain listed with GoMain. Offers at or above the asking price buy it outright; lower offers are negotiated automatically with a counter-offer, for up to three rounds, then the seller decides. An accepted offer opens an Escrow.com transaction, so the money is only released once the domain arrives. Confirm the amount and email with the user before calling; to answer a counter-offer, pass the deal_id and status_key from the last answer.
输入参数email必填amount必填domain必填deal_idstatus_key
list_domain_for_sale
Sell a domain through GoMain
List a domain the user owns for sale. The first call returns a DNS TXT record that proves ownership; once it's added, calling again with the same domain and email activates the listing. asking_price is shown to buyers; floor_price, the lowest offer accepted automatically, never is. Sales close through Escrow.com.
输入参数email必填domain必填withdrawfloor_pricelisting_keyasking_price
watch_domain
Watch a domain
GoMain checks a domain daily and emails when it drops (or is about to), changes hands, or is listed for sale. Returns a watch id and status key for broker_status.
输入参数email必填domain必填
broker_status
Deal or watch status
The status and history of a brokerage deal (id d_…) or a watch (id w_…), given the id and status key returned when it was created.
输入参数id必填status_key必填