domains

Find a domain to buy, with prices

Changed on

q is a name ("orgo") or a full domain ("orgo.agency"; a pasted URL works too). Page 0 is the extension typed, then the popular ones; each later page is the next 60 extensions (next_page is null on the last, total is how many there are). status: available, taken, premium (the registry’s own high price; not sold here) or unknown (the registry did not answer; search again). Only available names carry a price: price_cents is what buying takes from your Orgo credits for min_years, renewal_cents_per_year what a year costs after that. Pass price_cents as expected_price_cents when you buy.

free (page 0 only; null where free names are off) is the name under Orgo’s own domain as it would be made (<label>-xxxx.orgo.dev, the xxxx picked when it is), claimed as a public URL on a computer: POST /api/computers/{id}/public-urls { port, name }, whose answer is the address it got. registrar_error: true when the registry did not answer (results empty, free still shown).

A session or an account-wide key: a workspace-scoped key gets 403. 30 searches a minute per account and 60 per address. 404 DOMAINS_NOT_ENABLED where domains are not enabled for the account.

get/api/domains/search

Request

  • Base URL
    https://www.orgo.ai
  • Auth
    HTTP bearer

Query parameters

qstring required
pageinteger

Response

The page of results.

querystring required

q as sent.

labelstring required

The name searched, without the extension.

pageinteger required
next_pageinteger nullable required
totalinteger required

How many extensions there are to search.

registrar_errorboolean

Present, true, when the registry did not answer.

Example response

{
  "free": {
    "domain": "cool-thing-xxxx.orgo.dev"
  },
  "results": [
    {
      "domain": "orgo.agency",
      "tld": "agency"
    }
  ]
}

Changes

    • info

      removed the taken enum value from the / response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status