support@tenderhive.com
Subscribe
TenderHive Intelligence

開発者向けAPI

入札データAPI

公開入札、契約締結情報、その他の調達データを自社システムに取り込みます。1つのキーで、JSONレスポンス、カーソルページネーション、日次変更フィードを利用できます。

APIアクセスを取得
エンドポイント
12
REST · JSON
v1
APIキーごと
60/分
1ページあたりのレコード数
200

クイックスタート

最初のリクエストを送信する

APIアクセスはご契約プランに応じて発行されます。当社が提供するキーをBearerトークンとして使用し、任意のエンドポイントを呼び出してください。

ベースURLhttps://app.tenderhive.com/api/public/v1
curl
curl "https://app.tenderhive.com/api/public/v1/tenders?country=KE" \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンスはJSON形式です。ページネーションには next_cursorを使用します。各キーは月間許容量の範囲内で1分間に60リクエストまで許可されます。いずれかの制限を超えると、 429.

AIアシスタントを接続

このアドレスをClaude、ChatGPT、またはMCPをサポートする任意のアシスタントに追加し、TenderHive Intelligenceアカウントでサインインしてください。

https://app.tenderhive.com/api/public/mcp

試す

ライブリクエストを送信

ライブAPIに対してキーを使用し、レスポンス、ヘッダー、対応するcurlコマンドを確認します。

キーはこのブラウザタブ内に保持され、APIにのみ送信されます。

同等のcurlコマンド

curl "https://app.tenderhive.com/api/public/v1/tenders?limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

キーを貼り付けてリクエストを送信すると、ライブレスポンスが表示されます。

日次同期

システムを最新に保つ

ライセンスデータを一度読み込んだ後は、毎日新規および変更されたレコードのみを取得します。すべての変更にはコンテンツハッシュが付与されるため、変更のないレコードはスキップできます。

# 1. First run: page through everything in your licence
curl "https://app.tenderhive.com/api/public/v1/tenders?limit=200" \
  -H "Authorization: Bearer $TENDERHIVE_KEY"
# repeat with &cursor=<next_cursor> until next_cursor is null

# 2. Every day after: fetch only what changed since your last run
curl "https://app.tenderhive.com/api/public/v1/tenders/changes?since=2026-10-07T00:00:00Z&limit=200" \
  -H "Authorization: Bearer $TENDERHIVE_KEY"

リファレンス

制限とエラー

制限金額ヘッダー
毎分の制限デフォルトでキーごとに毎分60リクエスト。契約により増加可能X-RateLimit-Limit / -Remaining / -Reset
毎秒の制限エンタープライズ契約：キーごとに毎秒最大20リクエスト、2秒間のバースト付きX-RateLimit-Limit-Second / -Remaining-Second, RateLimit, RateLimit-Policy
条件付きリクエストすべてのレスポンスにETagが含まれます。If-None-Matchを送信すると、変更がない場合に304が返りますETag / If-None-Match
月間割り当てプランまたは契約により設定され、組織ごとにカウントされ、毎月1日（UTC）にリセットされますx-quota-limit / -remaining / -reset
ページサイズリクエストあたり最大200レコード。カーソルページネーションnext_cursor
キー制限キーはライセンスされた国やセクターに制限でき、有効期限を設定できます—
ステータスコード意味
400bad_requestフィルターまたはカーソルが無効です。
401unauthenticatedキーが存在しない、不明、失効、または期限切れです。
402plan_requiredご利用のプランにはAPIアクセスが含まれていません。
403scope_deniedこのキーはこのデータまたは国に対してライセンスされていません。
429rate_limitedバースト制限または月間割り当てに達しました。retry-after秒待ってください。
503service_unavailable一時的な問題です。バックオフして再試行してください。

リファレンス

エンドポイント

12 エンドポイント

すべてのレスポンスには x-ratelimit-limit, x-ratelimit-remaining および x-ratelimit-resetが含まれ、さらに x-quota-* 月間許容量が適用される場合は、

ご質問がありますか？ お問い合わせ