OpenAICloudflareApr 15, 2026, 1:00 PM

Register domains wherever you build: Cloudflare Registrar API now in beta

A condensed section focused on the key takeaways first.

Original Post

Quick Digest

Summary

A condensed section focused on the key takeaways first.

openaienmodel: gpt-5-mini-2025-08-07

Register domains wherever you build: Cloudflare Registrar API now in beta

Key Points

  • Search, Check, Register endpoints
  • Agent-friendly via Cloudflare MCP
  • At-cost pricing; WHOIS privacy by default

Summary

Cloudflare launched the Registrar API in beta on 2026-04-15. The API provides programmatic domain search, authoritative availability/pricing checks, and registration for a curated set of TLDs. It is built for editors, CI/CD, backend services, and AI agents and is available through the existing Cloudflare API/MCP surface with no separate integration required.

Key Points

  • Core endpoints: Search (candidate names), Check (real-time registry availability and price), Register (create registration; may complete synchronously or return a workflow URL with 202).
  • Agent & automation friendly: discoverable via MCP; works with agent patterns (search()/execute()); default account registrant and payment methods are used automatically.
  • Safety and confirmations: Check is the authoritative source of truth and must be called immediately before Register; domain registrations are non-refundable, so agent flows must explicitly confirm name and price with the user.
  • Pricing and premiums: Cloudflare charges at-cost registry pricing (no markup). Premium domains require explicit fee acknowledgement returned in Check/Register flows.
  • Defaults and behavior: WHOIS privacy protection is enabled by default; responses use a consistent shape whether registration is synchronous or asynchronous.
  • Roadmap: programmatic transfers, renewals, contact updates, and broader registrar-as-a-service capabilities are planned later in the year.

Quick start (engineer checklist)

  • Call Search to get candidate names (cached, fast).
  • Call Check immediately before Register — use Check pricing as the source of truth.
  • Call Register with domain_name; if you receive 202 Accepted, poll the provided workflow URL until completion.
  • Ensure your agent or workflow prompts the user to confirm domain and price before calling Register to avoid unwanted, non-refundable purchases.

Next steps

Review the Registrar API guide and API reference in Cloudflare docs and provide feedback via Cloudflare Community, X, or Discord.

Full Translation

Translations

A translation section that keeps the flow of the original article.

openaijamodel: gpt-5-mini-2025-08-07

どこで構築してもドメインを登録:Cloudflare Registrar API(ベータ)

どこで構築してもドメインを登録:Cloudflare Registrar API(ベータ)

公開日: 2026-04-15

著者: Ankit Shah、Carlos Armada

所要時間: 4分

本日、Cloudflare Registrarの次章として、Registrar APIのベータをローンチします。Registrar APIを使うと、ドメインの検索、利用可否チェック、プログラムによる登録が可能になります。アイデアが実際になり始めた瞬間にドメインを買う操作が、エージェント的なワークフローからユーザーを引き離す必要はもうありません。

多くのビルダーからはRegistrar APIの要望が明確に寄せられていました。エディタ、ターミナル、エージェント駆動ツールなどにエージェント的ワークフローが移行するにつれ、ドメイン登録は埋めるべき明白なギャップになっていました。

背景

7年前にCloudflare Registrarを立ち上げたとき、考えはシンプルでした。ドメインはコストで提供されるべきであり、マークアップや不透明な手法は排除する、ということです。以来、Cloudflare Registrarは世界で最も急成長しているレジストラの一つになり、より多くの人々がCloudflareを次のプロジェクトの構築場所として選んでいます。

エージェントと自動化のために設計

Registrar APIは、エディタ、デプロイパイプライン、バックエンドサービス、エージェント駆動ワークフローなど、ソフトウェアが既に構築されているあらゆる場所でうまく動作するように設計されています。ワークフローは意図的にシンプルで機械に優しいものです。

  • Search は候補名を返します。
  • Check はリアルタイムの可否と価格を返します。
  • Register は最小限のリクエストを受け取り、即時完了するか、完了までポーリング可能なワークフロー形状のレスポンスを返します。

これにより、従来のAPIクライアントだけでなくユーザーの代わりに動作するAIエージェントからも使いやすくなっています。実際には、エージェントが名前を提案し、実際に登録可能なものを確認し、承認のために価格を提示し、ツールから出ることなく購入を完了できます。

Registrar API の概要

この最初のリリースでRegistrar APIは主に次の3つを提供します。

  • ドメインの検索(Search)
  • 利用可否と価格のチェック(Check)
  • ドメインの登録(Register)

まずは選定された人気TLD向けにサポートしています。詳細はRegistrar API docsを参照してください。サポートされている場合、プレミアムドメインも登録可能ですが、明示的な料金承認が必要です。

Registrar APIはCloudflareのフルAPIの一部であり、エージェントは既にCloudflare MCPを通じてアクセスできます。別の統合やカスタムツール定義は不要です。Cursor、Claude Code、または任意のMCP互換環境で動作するエージェントは、Cloudflare API全体をカバーする同じ search() と execute() パターンを使ってRegistrarエンドポイントを発見・呼び出せます。

APIが仕様の一部になった瞬間から、エージェントのために準備が整っていました。

実際の利用イメージ

  • AIコードエディタで新しいプロジェクトを作っているとします。スキャフォールディングの途中で、エージェントに「このプロジェクト用の良い .dev ドメインを見つけて登録して」と依頼します。
  • エージェントはプロジェクトに基づいて候補名を検索します。あなたが選んだもののリアルタイム可否と価格を確認します。
  • 承認すると、アカウントのデフォルト連絡先情報と支払い方法を自動的に使ってドメインを登録します。

レスポンスを読む頃には、ドメインは登録され、プライバシー保護も有効になっています。3つのAPIコール、数秒です。

コード例

ステップ1: ドメイン名を検索

search エンドポイントを使ってクエリを送信します。拡張子の有無は問いません。

async () => {
    return cloudflare.request({
        method: "GET",
        path: `/accounts/${accountId}/registrar/domain-search`,
        query: { q: "acme corp", limit: 3 },
    });
}

検索結果例(非権威的なキャッシュベースの結果):

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "acmecorp.com",
        "registrable": true,
        "tier": "standard",
        "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }
      },
      {
        "name": "acmecorp.dev",
        "registrable": true,
        "tier": "standard",
        "pricing": { "currency": "USD", "registration_cost": "10.11", "renewal_cost": "10.11" }
      },
      {
        "name": "acmecorp.app",
        "registrable": true,
        "tier": "standard",
        "pricing": { "currency": "USD", "registration_cost": "11.00", "renewal_cost": "11.00" }
      }
    ]
  }
}

ステップ2: 利用可否と価格をチェック

Searchの結果は高速ですが非権威的(キャッシュベース)です。利用可否は人気のある名前では秒単位で変わる可能性があります。Checkはレジストリに直接問い合わせます。登録の直前に呼び出し、価格レスポンスを事実のソースとして使ってください。

async () => {
    return cloudflare.request({
        method: "POST",
        path: `/accounts/${accountId}/registrar/domain-check`,
        body: { domains: ["acmecorp.dev"] },
    });
}

Checkのレスポンス例(権威的な価格):

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "acmecorp.dev",
        "registrable": true,
        "tier": "standard",
        "pricing": { "currency": "USD", "registration_cost": "10.11", "renewal_cost": "10.11" }
      }
    ]
  }
}

ステップ3: ドメインを登録

必須フィールドはドメイン名のみです。WHOISプライバシー保護はデフォルトで無償有効です。アカウントにデフォルトの登録者連絡先が設定されていればAPIが自動的にそれを使います。なければリクエスト内で連絡先を指定できます。デフォルトの支払い方法が自動で使われます。

async () => {
    return cloudflare.request({
        method: "POST",
        path: `/accounts/${accountId}/registrar/registrations`,
        body: { domain_name: "acmecorp.dev" },
    });
}

登録成功レスポンス例(通常は数秒で同期的に完了):

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "domain_name": "acmecorp.dev",
    "state": "succeeded",
    "completed": true,
    "created_at": "2025-10-27T10:00:00Z",
    "updated_at": "2025-10-27T10:00:03Z",
    "context": {
      "registration": {
        "domain_name": "acmecorp.dev",
        "status": "active",
        "created_at": "2025-10-27T10:00:00Z",
        "expires_at": "2026-10-27T10:00:00Z",
        "auto_renew": true,
        "privacy_enabled": true,
        "locked": true
      }
    },
    "links": {
      "self": "/accounts/abc/registrar/registrations/acmecorp.dev/registration-status",
      "resource": "/accounts/abc/registrar/registrations/acmecorp.dev"
    }
  }
}

登録が完了するまでに時間がかかる場合、APIは202 AcceptedとワークフローのURLを返し、そのURLをポーリングする形になります。どちらの場合でもレスポンスの形状は同一です。

プレミアムドメインについては、Checkのレスポンスでレジストリ指定の正確な価格が返り、Registerリクエストではその価格を明示的に承認する形になります。

エージェントと返金不可の購入に関する注意

エージェントがあなたの代わりにドメインを登録する場合、アカウントのデフォルト支払い方法に課金されます。ドメイン登録は完了すると返金不可です。エージェントのフローは、登録エンドポイントを呼び出す前にドメイン名と価格をユーザーに確認するべきです。Checkステップは、その確認を明示的かつ一意に行うために存在します。

APIは正しい実装に必要なツールを提供しますが、ユーザーの承認なしに購入を行わないようにする責任はエージェント側の論理にあります。デフォルトでAPIドキュメントには、register API呼び出し時にユーザーの許可を求めるエージェント向けの明確な指示が含まれています。

なぜCloudflareはこれを異なる形で提供できるのか

多くの開発者プラットフォームがドメインワークフローを追加する中で、Cloudflareが異なるのはCloudflare自身がレジストラを運営している点です。つまり、プロジェクトが構築・デプロイされる同じプラットフォーム上でドメインを検索・登録・管理でき、余分なマークアップが乗りません。

At-cost(原価)での価格設定がCloudflare Registrarモデルの核心です。レジストリが請求する額をそのまま請求します。これはダッシュボード経由、API直接呼び出し、あるいはエージェント経由いずれでも同じです。

今後の予定

このベータはドメインライフサイクルの最初の重要な瞬間、つまり検索・チェック・登録に焦点を当てています。購入後もプログラムでドメインを管理できるよう、APIを拡張する作業を進めています。対象には転送、更新、連絡先の更新などのライフサイクル要素が含まれます。

このAPIはより広い registrar-as-a-service 提供に向けた第一歩です。現在その開発が進行中で、今年後半のローンチを目指しています。APIが拡張されれば、ウェブサイトビルダー、ホスティングプロバイダ、AI製品、その他のマルチテナントアプリケーションがドメイン登録を自社のユーザー体験に組み込めるようになります。

今すぐ構築を始める

Registrar APIはビルダーの要望から生まれました。ベータ版が利用可能になった今、Cloudflare Community、X、Discordであなたが作るものをぜひ見せてください。

開始方法:

  • Review the Registrar API guide
  • Check out the API reference

ワークフローが壊れる、機能が足りない、大規模なプラットフォームユースケースに向けて構築している、などあればお知らせください。私たちは更新、転送、更新(renewals)、およびその他の機能のサポートに向けて迅速に機能拡張を進めています。皆さんが何を作るか楽しみにしています!

特別な謝辞: Lucy Dryaeva と Fred Pinto の貴重な貢献に感謝します。

Cloudflareの接続クラウドは、企業ネットワーク全体を保護し、インターネット規模のアプリケーションを効率的に構築するのを支援し、あらゆるウェブサイトやインターネットアプリケーションを加速し、DDoS攻撃から守り、ハッカーを遠ざけ、Zero Trustへの道を支援します。任意のデバイスから 1.1.1.1 を訪れて、インターネットを速くより安全にする無料アプリを始めてください。私たちのミッションについて詳しくは start here をご覧ください。新しいキャリアをお探しなら、open positions をチェックしてください。

タグ: server-island-start, Registrar, Developers, AI, API, Developer Platform, Agents, Agents Week