---
title: A JavaScript and TypeScript client for the catalog
url: https://namegarage.com/blog/javascript-typescript-sdk
author: Namegarage
date: '2026-10-26'
description: Install the official Namegarage SDK to read the public domain catalog
  and search by project description without an API key.
---

# A JavaScript and TypeScript client for the catalog

The official [@namegarage/sdk](https://www.npmjs.com/package/@namegarage/sdk)
package brings the public catalog and search API to JavaScript and TypeScript.
Version 0.1.0 has no runtime dependencies and needs no account or API key.

```bash
npm install @namegarage/sdk@0.1.0
```

```typescript
import { Namegarage } from '@namegarage/sdk';

const client = new Namegarage();
const matches = await client.searchDomains('meal-planning app', {
  maxPrice: 5000,
  limit: 3,
});

for (const domain of matches.results) {
  console.log(domain.name, domain.price_usd, domain.url);
}
```

Use `getCatalog()` to read the published catalog snapshot, or `searchDomains()`
to filter results and get prices resolved against current availability. A null
price means offer-only. Follow a result's URL to review the name; a search does
not reserve it.

The package supports ESM and CommonJS in Node.js 22 or later and can be bundled
for modern browsers. TypeScript declarations ship with it. You can cancel
requests, set a timeout, and inspect typed HTTP errors. The client does not
retry automatically, so honor the server's `Retry-After` response before retrying.

Read the [quickstart](/docs/quickstart) for examples.
The [source repository](https://github.com/namegarage/sdk) is public under the
MIT license. The SDK reads public listings; it cannot buy or reserve names,
send messages, sign in, or access private portfolio records.