Everything on our lists is available as data. No key is needed; responses are cached for a few minutes, so please keep to a request every few seconds.
List names: GET /api/listings
Takes the same parameters as the list pages (set filters on any list and copy its URL). Add format=csv for a spreadsheet (up to 1,000 rows) or format=rss for a feed.
| Parameter | Meaning |
|---|---|
tld, suffix | Extension, e.g. tld=uk&suffix=co.uk |
q, qmode | Keyword; contains, starts or ends |
start, contain, end, nstart, ncontain, nend, and | Comma-separated allow and block lists |
minlen/maxlen, minscore/maxscore, minbrand, minvalue, minwc/maxwc, mintlds, minaby/maxaby | Ranges: length, quality score, brandability, value (£), words, other TLDs taken, first archive year |
nohyphen, nodigit, words, radio, archived, noadult | Set to 1 to switch on |
pattern | C consonant, V vowel, N number, e.g. CVCV |
maxspam, minyears, before | Spam ceiling, years of history, history before a year |
days, mindays, maxdays, new | Drop window in days; added in the last N hours |
dropped=1, avail | Dropped names; available, taken or pending |
domains | Up to 500 exact names, comma-separated |
sort | best, brand, value, drop, recent, added, authority, spam, len, name |
page, pp | Page number; 25, 50, 100 or 200 per page |
Example: /api/listings?tld=uk&maxlen=6&nohyphen=1&sort=best
Each result has the domain, drop time (and whether it is an estimate), status, length, words, topic, archive history, spam score and reasons, authority, other TLDs taken, registrar, availability after the drop and our score, brand, radio and value. Unmeasured values are null, never zero.
Check one name: GET /api/check?domain=example.com
Live registry status (RDAP), registrar, dates, statuses and the estimated release window, plus Wayback Machine history. Not cached; please check names one at a time.
Terms
Free for personal and commercial use with a link back to FreedDomains where you show the data. Do not resell the raw data as your own list. Registry data remains subject to each registry's terms.
