Clay Public API — サービス、アプリ、連携システムを構築するためのHTTP(ウェブ上での通信規格)によるアクセス機能です。GTM(マーケティングデータ)データベース検索、構造化テーブル(整理されたデータ表)へのクエリ実行、非同期処理(完了を待たずに進行する処理)とバッチ実行(複数データの一括処理)に対応しています。
Clay Public API — HTTP access for building services, apps, and integrations: GTM database search, structured table queries, and async routine and batch runs.
CLIに加えて、ClayはHTTP経由で直接開発できる公開API(外部からアクセスできるプログラムインターフェース)を提供しています。
サービス、アプリ、または統合機能を構築する際に使用してください。シェル内での一度限りのエージェントタスクには、cliスキルを使用してください。
検索 — Clayの営業・マーケティング向けデータベースから人物または企業を見つけます。フィールドカタログの条件、複数エンティティ間でのフィルタリング、階層化した論理条件(AND/OR)など高度なクエリに対応しています。 検索の動作についてはサーチスキルおよびCLI相当機能を参照してください。一度限りの検索にはCLIを推奨します。
テーブル — Clayのテーブルに対する構造化されたクエリ。
ルーチン・バッチ処理 — 非同期(時間を待たずに実行される)ルーチン実行およびバッチ処理。
公開APIには独自のキーが必要です。clay loginから取得した認証情報は、公開API用にスコープ(権限範囲を限定)されていません。CLIで専用の公開API用キーを発行してください:
clay api-keys create --name "<name>" # → { ..., "apiKey": "<secret>" }
CLIで作成されたキーは常に公開APIに限定されます。apiKeyシークレット(秘密鍵)は作成時のみ返されます。すぐに保存してください。後で取得することはできません。https://api.clay.com/public/v0に対してBearer認証トークンとして送信してください。既存のキーはclay api-keys list | update | deleteで管理できます。
完全な開発者向けドキュメント(公開API リファレンス、CLIリファレンス、概念説明、OpenAPI仕様)は以下から提供されています:
統合コードを記述する前に、正確なエンドポイント、リクエスト・レスポンス形式、ページネーション(複数ページの取扱)、レート制限(使用量の上限)を確認するため、まずこちらを参照してください。
Beyond the CLI, Clay exposes a Public API you can develop against directly over HTTP.
Reach for it when building a service, app, or integration — not for one-off agent tasks
in a shell (use the cli skill for those).
searches skill for search behavior and the CLI equivalent. Prefer the CLI for one-off searches.The public API needs its own key — the credential from clay login is not
scoped for it. Issue a dedicated public-API key with the CLI:
clay api-keys create --name "<name>" # → { ..., "apiKey": "<secret>" }
CLI-created keys are always scoped to the public API. The apiKey secret is returned
only once, at creation — store it immediately; it can't be retrieved later. Send it
as a Bearer token against https://api.clay.com/public/v0. Manage existing keys with
clay api-keys list | update | delete.
Full developer documentation — Public API reference, CLI reference, concepts, and the OpenAPI spec — lives at:
Fetch that first to get exact endpoints, request/response shapes, pagination, and rate limits before writing integration code.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。