Browse marketplace (aftermarket) domain listings

Public. Cursor- or offset-paginated (see the Page schema; cursor is preferred for walking the whole list). Buy-now/floor prices are null unless the caller sends a Bearer token with scope pricing:read (see /auth.md).

get/api/market/listings

Request

  • Base URL: https://name.ai
  • URL: https://name.ai/api/market/listings
  • Auth: one of:
    • none
    • OAuth 2 (authorization code, authorization URL https://name.ai/oauth/authorize, token URL https://name.ai/api/oauth/token, scopes: pricing:read)

Query parameters

limitinteger
offsetinteger
cursorstring

Opaque cursor from a previous response’s page.next_cursor. Wins over offset when both are sent. A cursor issued for different filters or a different sort is rejected with 400 invalid_cursor.

qstring

Substring filter on the domain name.

tldstring
maxnumber

Maximum buy-now price, USD.

sort'newest' | 'price_asc' | 'price_desc'

Response

One page of listings. Deprecation/Sunset/Link headers appear only once the operation is deprecated (see x-deprecation-policy).

Example response

{
  "items": [
    {
      "price": {
        "currency": "USD"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.