AIエージェント向けAPI
AIエージェントをBlaBlaPriceに連携しましょう。売り手なら、フィルターに合う新しい依頼を確認し、価格表からオファーを送ります。買い手なら、依頼を作成し、オファーを追跡して、いちばんお得なものを教えてくれます。
エージェントはあなたの側（Claude、ChatGPT、n8n、自作のプログラム）で動き、私たちはMCPまたはAPIでアクセスを提供します。AIはあなたの側で動くので、キーは私たちには見えません。エージェントが相手の連絡先を見られるのは、連絡先の交換後だけです。
エージェントのキーは、ダッシュボード → 「マイAIエージェント」で作成します。コネクター対応のアプリは、キーなしでログインして接続します。
AIアシスタントへ：どの国を選ぶか
BlaBlaPriceは国ごとに別のバージョンがあり、売り手、価格、通貨もそれぞれ違います。依頼の内容、言語、都市、通貨から利用者の国を判断してその国のフォルダーへ案内し、国が一覧にない場合はルート（英語、米ドル）へ案内してください。判断できないときは推測せず、質問を1つしてください。
プログラム向けの国、言語、アドレスの一覧： countries.json, llms.txt
AIアシスタント向けのオープンデータ
AIアシスタントが読んで引用できる2つのページと、そのプログラム向けのコピーです。キーも登録も不要で、このページの国のデータです。
| BlaBlaPriceと日本のほかの買い方 | compare.json: 買い方の種類、それぞれ何に向いているか、BlaBlaPriceが不向きなとき、買い手の質問。 |
| 市場分析 | price-index.json, price-index.csv: その月のカテゴリー別価格：中央値、25・75パーセンタイル、1カテゴリーあたり5件以上。 |
MCPサーバー
URL https://blablaprice.com/api/mcp（Streamable HTTP、セッションなし）。アクセスはOAuthでのログイン、または Authorization: Bearer bbp_… ヘッダーのキーで行います。使えるツールは、売り手か買い手かによって変わります。
Claude、ChatGPTなど、コネクターに対応したアプリ
URL https://blablaprice.com/api/mcp でカスタムコネクター（Custom connector / MCP）を追加してください。アプリがBlaBlaPriceを開くので、ログインして「許可」をタップします。連携は「マイAIエージェント」で解除できます。技術情報：PKCEと動的登録に対応したOAuth 2.1、メタデータは /.well-known/oauth-authorization-server にあります。
Claude Code
claude mcp add --transport http blablaprice https://blablaprice.com/api/mcp --header "Authorization: Bearer YOUR_KEY"n8n
ノード MCP Client Tool：Endpoint https://blablaprice.com/api/mcp、Authentication は Header Auth（Authorization = Bearer YOUR_KEY）。
売り手向けツール
list_new_requests | 売り手のフィルターに一致する新しい依頼のうち、まだ返信していないもの |
get_request | 1件の依頼：テキスト、買い手の写真（あれば）、カテゴリ、予算、地域、期限、ほかのオファーの有無、自分のオファーとその順位（上位3／5／10） |
send_offer | オファーを送る：テキスト（具体的な内容、価格または価格を左右する条件、条件面）と写真 |
update_offer | 買い手が選ぶまで、テキストや写真を変更できます |
withdraw_offer | オファーを取り下げる |
message_buyer | 依頼の個別チャットで買い手にメッセージ:提案前は質問3件まで、提案後は自由 |
my_offers | 自分のオファー。承諾されたものには買い手の連絡先が含まれます |
my_account | プラン、フィルター、上限 |
買い手向けツール
create_request | 依頼を作成します。カテゴリは任意で、こちらで選びます。写真は1枚まで。POST /uploadsで取得したimageを指定します（1日10枚まで） |
find_category | フレーズに対するカテゴリ候補 |
my_requests | オファー数つきの自分の依頼 |
get_my_request | 依頼と、お得な順に並べたすべてのオファー：場所、売り手のレビュー、売り手のコメント |
message_seller | 依頼の個別チャットで提案の売り手にメッセージ:質問や交渉(価格、値引き、配送、納期) |
since_id | get_request と get_my_request はチャットも返します(messages、last_message_id)。since_id = last_message_id で新しいメッセージだけを取得 |
extend_request / close_request | 7日間延長／終了（確認後のみ） |
prepare_accept → accept_offer | オファーの承諾は2段階：本人の「はい」の後、かつダッシュボードで許可されている場合のみ |
my_contacts | 売り手の連絡先つきの成立した取引 |
my_account | 地域、上限、承諾を許可するかどうか |
REST API
ベースURL：https://blablaprice.com/api/v1、レスポンスはJSON、キーはAuthorization: Bearer bbp_…ヘッダーに入れます。
GET /me | 売り手、プラン、フィルター、上限 |
GET /requests?since=&limit= | フィルターに一致する新しい依頼。since：最後に受け取った依頼のID（next_sinceフィールドの値）またはISO 8601形式の時刻。指定すると、それより新しいものだけが古い順に届きます。include_answered=1：すでに返信済みのものも含めます |
GET /requests/{id} | 1件の依頼 |
GET|POST /requests/{id}/messages | 買い手とのチャット:GET で読み取り(?since_id=)、POST {"text": "…"} で送信(message_buyer と同じ) |
POST /requests/{id}/offer | オファーを送る：{"comment": "…", "images": ["…"]} |
GET /offers?status= | 自分のオファー：active（デフォルト）、outbid、accepted、all |
GET /offers/{id} | 1件のオファー |
PATCH /offers/{id} | commentやimagesを変更 |
DELETE /offers/{id} | オファーを取り下げる |
POST /uploads | オファー用の写真（multipart、フィールドfile、JPG/PNG/WEBPで10MBまで）→ {"url": "…"} |
買い手用キー向け（GET /me は両方で使えます） | |
GET /categories?q= | カテゴリ候補 |
POST /my/requests | 依頼を作成：{"text": "…", "category_id": 788, "budget": 15000, "region_id": 0, "days": 7, "image": "…"}（category_idとimageは任意。連絡先入りの写真がある依頼は保留になります） |
GET /my/requests?status= | open, expired, accepted, closed, all |
GET /my/requests/{id} | 依頼とオファー（?sort=best|new） |
POST /my/requests/{id}/extend, /close | 延長／終了（{"confirm": true}） |
POST /my/offers/{id}/prepare-accept, /accept | 2段階で承諾（{"confirm_token": "…"}） |
GET|POST /my/offers/{id}/messages | 提案の売り手とのチャット:GET で読み取り(?since_id=)、POST {"text": "…"} で送信(message_seller と同じ)。提案前に書いてきた売り手には /my/requests/{id}/sellers/{seller_id}/messages |
GET /my/contacts | 連絡先つきの成立した取引 |
例
curl -H "Authorization: Bearer YOUR_KEY" "https://blablaprice.com/api/v1/requests?limit=5"
curl -X POST -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
-d '{"comment": "Bosch WAN28263、新品、￥52,000、2年保証、2日で配送"}' \
https://blablaprice.com/api/v1/requests/319/offerレスポンスに含まれる依頼
{
"id": 319,
"text": "洗濯機、8kg、新品、配送付き",
"category": {"id": 788, "name": "家電・電子機器 / 生活家電 / 洗濯機"},
"budget": 58000,
"currency": "JPY",
"region": {"id": 0, "name": "日本全国"},
"status": "open",
"created_at": "2026-09-29T14:20:09Z",
"deadline": "2026-10-06T23:59:59Z",
"has_offers": true,
"my_offer": null
}エラーと制限
エラーは常に次の形式です：{"error": {"code": "…", "message": "…"}}：
401：キーがない、または無効、403：エージェントが一時停止中、プランなし（plan_required）、またはプランのコンタクトを使い切り（no_balance）、
404：依頼が終了した、またはフィルターの対象外、409：オファーがすでにある（duplicate）、またはもう変更できない（closed）、
422：データが無効、429：リクエスト回数の制限。
チャットのエラー:422 contacts_blocked(連絡先を開く前の連絡先)、429 limit(1つのチャットで片側1日60件)、409 closed。
キーごとに毎分最大60回の呼び出し、エージェントからのオファーは一日あたり最大300件です。売り手のエージェントはどのプランでも動作し、オファーの送信は無料です。プランのコンタクトを使い切った場合、オファーは保存・確認されますが（moderation: held、理由 no_balance）、買い手には表示されません。プランの新しい月が始まったとき、またはプランを変更したときに、買い手に表示されます。
通知（Webhook）
ダッシュボードにhttps://…のURLを設定すると、JSON形式のPOSTを即時に送信します。
request.new | フィルターに一致する新しい依頼（data.request） |
offer.accepted | 買い手がオファーを承諾しました。連絡先つきです（data.offer.buyer） |
offer.outbid | 他の人のオファーがあなたより有利になりました（data.offer、placeとahead_haveを含みます。上位のオファーに含まれる内容です） |
offer.new | 買い手へ：依頼に新しいオファーが届きました（data.offer、連絡先なし） |
offer.updated | 買い手へ：売り手がオファーを変更しました（data.offer） |
buyer.message | 売り手へ:買い手またはそのエージェントがチャットに書き込みました(data.request_id、offer_id、message_id、text) |
seller.message | 買い手へ:売り手またはそのエージェントがチャットに書き込みました(data.request_id、offer_id、seller_id、seller、message_id、text) |
本文：{"id": "evt_…", "type": "request.new", "created_at": "…", "country": "ua", "data": {…}}。ヘッダー：X-BBP-Event、X-BBP-Delivery、署名X-BBP-Signature: sha256=…。ダッシュボードのシークレットを使った本文のHMAC-SHA256です。
$body = file_get_contents('php://input');
$sig = 'sha256=' . hash_hmac('sha256', $body, $secret);
if (!hash_equals($sig, $_SERVER['HTTP_X_BBP_SIGNATURE'] ?? '')) {
http_response_code(401); exit;
}
$event = json_decode($body, true); // $event['type'], $event['data']2xxのコードで応答してください。URLが応答しない場合は、1分後、5分後、30分後、2時間後に再試行します。5回失敗すると通知を一時停止して、メールでお知らせします。
リクエストの準備ができました。
販売店からの見積もりをどこに送りますか？
BlaBlaPriceにログイン
購入も販売もひとつのアカウントで。パスワードは不要です。Googleかメールに届くコードでログインすると、アカウントは自動で作られます。
ご依頼を保存しました。ログインしたらすぐに売り手へお送りします 🚀
Googleで続行または
連絡先が見えるのは、あなたが選んだ販売店だけです。
続行すると、利用規約とプライバシーポリシーに同意したことになります。
リクエストの準備ができました。
販売店からの見積もりをどこに送りますか？
BlaBlaPriceに登録
購入も販売もひとつのアカウントで。パスワードは不要です。Googleかメールに届くコードでログインすると、アカウントは自動で作られます。
ご依頼を保存しました。ログインしたらすぐに売り手へお送りします 🚀
- あなたのカテゴリの買い手の依頼を、無料で受け取れます。
- オファーの送信は無料です。連絡先の交換はプランの月間枠に含まれます（Start 5件、Business 40件、Pro 無制限）。
- 価格表をアップロードすると、BlaBlaPriceがあなたの価格で買い手に代わって返信します。
または
連絡先が見えるのは、あなたが選んだ販売店だけです。
続行すると、利用規約とプライバシーポリシーに同意したことになります。
- Argentina
- Australia
- Canada
- Chile
- Colombia
- Dominican Republic
- Georgia
- Hong Kong English 繁體中文
- India
- Israel
- Japan
- Kazakhstan Русский Қазақша
- Kuwait العربية English
- Malaysia English Bahasa Melayu
- Mexico
- New Zealand
- Pakistan
- Panama
- Philippines
- Qatar العربية English
- Singapore
- South Africa
- South Korea
- Switzerland
- Taiwan
- Ukraine
- United Arab Emirates English العربية
- United States