1回の通信で最大100件の商標ヨミを一括検索し、類似度スコア付きの結果を即座に返却するBtoB向け超高速APIです。AI推論のオーバーヘッドを排除した堅牢なJSON APIとして、貴社のネーミング自動生成システムや社内ワークフローにシームレスに組み込めます。
最大100件一括
1リクエストで高速バルク検索
Bearer認証
APIキーで安全に接続
シンプルなJSON
類似度スコア付きで即統合
| エンドポイント | POST https://tr-api-service-996068966024.asia-northeast1.run.app/api/public/search |
|---|---|
| 認証方式 | APIキー（HTTPヘッダー Authorization: Bearer {YOUR_API_KEY}） |
| Content-Type | application/json |
リクエストボディは JSON です。ヨミの配列を一括で送り、必要に応じて類似群コードで絞り込みます。
yomi_list検索対象のヨミ（カタカナ推奨）。最大100件まで一括指定可能。
sim_codes絞り込みを行う類似群コード（例: "35B01"）。最大20件まで。
{
"yomi_list": ["ソクヒョウ", "サンプル"],
"sim_codes": ["35B01"]
}ステータス、処理されたヨミの件数に加え、resultsオブジェクト内に「リクエストしたヨミ」をキーとして、それぞれの上位類似商標（最大30件）が配列で返却されます。
| Field | Description |
|---|---|
| status | 処理結果。成功時は "success" |
| sim_codes_used | 実際に適用された類似群コードの配列 |
| total_yomi_processed | 処理されたヨミの件数 |
| results | ヨミをキーとしたオブジェクト。各値は類似商標の配列（最大30件） |
各ヒットには registration_number / trademark_name / pronunciation / type / similarity_score が含まれます。
{
"status": "success",
"sim_codes_used": ["35B01"],
"total_yomi_processed": 2,
"results": {
"ソクヒョウ": [
{
"registration_number": "9999999",
"trademark_name": "SOKUHYO",
"pronunciation": "ソクヒョウ",
"type": "国内",
"similarity_score": 1.0
},
{
"registration_number": "9999998",
"trademark_name": "即標",
"pronunciation": "ソクヒョウ",
"type": "国内",
"similarity_score": 1.0
}
],
"サンプル": [
{
"registration_number": "1234567",
"trademark_name": "SAMPLE",
"pronunciation": "サンプル",
"type": "国内",
"similarity_score": 1.0
}
]
}
}公正な利用のため、APIキーごとに1日あたりの検索上限が設けられています。制限はリクエスト回数ではなく、検索したヨミの数（クレジット）で消費されます。
| 制限の単位 | リクエスト（通信）回数ではなく、検索したヨミの数（クレジット）で消費されます。例:yomi_listに10件含めれば、1回の通信で10クレジット消費します。 |
|---|---|
| 上限枠 | 1日あたり最大 100ヨミ まで検索可能です。 |
| リセット | 毎日 日本時間（JST）の午前0時に消費クレジットがリセットされます。 |
1日の利用上限を超えた場合、APIは検索を実行せずに HTTP 429 Too Many Requests を返します。クライアント側ではこのステータスを検知し、翌日のリセットまで待機するか、リクエスト件数を減らして再試行してください。
| Status | 意味 |
|---|---|
| 429 | 日次のヨミ検索上限（クレジット）を超過した |
{
"detail": "Daily query limit exceeded. You have 0 queries remaining today, but requested 50."
}お好みの言語で、すぐに呼び出しを試せます。
import requests
import json
url = "https://tr-api-service-996068966024.asia-northeast1.run.app/api/public/search"
api_key = "sk_live_XXXXXXXXXXXXXXXXXXXXXX"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
data = {
"yomi_list": ["ソクヒョウ", "サンプル"],
"sim_codes": ["35B01"]
}
response = requests.post(url, headers=headers, json=data)
print(json.dumps(response.json(), indent=2, ensure_ascii=False))無料でAPIキーを発行できます。発行時にSokuhyoへの被リンク設置にご同意いただく必要があります。キーは一度だけ表示されますので、安全な場所に保管してください。
API利用申請ページへTerms & Disclaimer — APIご利用前に必ずご確認ください
本APIは現在β版（ベータ版）として提供されています。仕様の変更、一時的なアクセス制限、または事前の予告なしにサービスが停止・終了する可能性があります。
サーバーへの過度な負荷をかける行為、スクレイピング目的の悪質なリクエスト、その他当法人が「スパム的な使用」あるいは「不適切」と判断した通信については、事前の警告なしに即座にAPIキーを無効化し、利用を停止する権利を留保します。