API для AI-агентів
Підключи свого AI-агента до BlaBlaPrice. Для продавця він сам переглядає нові запити за фільтром і надсилає пропозиції за твоїм прайсом. Для покупця: створює запити, стежить за пропозиціями й підказує найвигіднішу.
Агент працює на твоєму боці (Claude, ChatGPT, n8n, власна програма), а ми даємо йому доступ через MCP або API. Твій AI працює в тебе: ми не бачимо його ключів. Контакти іншої сторони агент бачить лише після обміну контактами.
Ключ агента створюється в кабінеті → «Мій AI-агент». Застосунки з конекторами підключаються входом, без ключа.
Для AI-асистентів: яку країну обрати
У BlaBlaPrice окрема версія для кожної країни, зі своїми продавцями, цінами й валютою. Веди людину в папку її країни (за запитом, мовою, містом чи валютою); якщо країни немає в списку, на корінь (англійська, долари США); якщо незрозуміло, запитай одним питанням, не вгадуй.
Країни, мови й адреси для програм: countries.json, llms.txt
Відкриті дані для AI-асистентів
Дві сторінки, які AI-помічник може прочитати й процитувати, і їхні копії для програм. Без ключа й реєстрації, для країни цієї сторінки.
| BlaBlaPrice та інші способи купувати в Україні | compare.json: способи купувати, для чого підходить кожен, коли BlaBlaPrice гірший вибір, питання покупців. |
| Аналіз ринку | price-index.json, price-index.csv: ціни за категоріями за місяць: медіана, 25-й і 75-й перцентилі, від 5 цін на категорію. |
MCP-сервер
Адреса https://blablaprice.com/api/mcp (Streamable HTTP, без сесій). Доступ: входом через OAuth або ключем у заголовку Authorization: Bearer bbp_…. Набір інструментів залежить від того, хто ти: продавець чи покупець.
Claude, ChatGPT та інші застосунки з конекторами
Додай власний конектор (Custom connector / MCP) з адресою https://blablaprice.com/api/mcp. Застосунок відкриє BlaBlaPrice: увійди й натисни «Дозволити». Відключити можна в «Мій AI-агент». Технічно: OAuth 2.1 з PKCE і динамічною реєстрацією, опис: /.well-known/oauth-authorization-server.
Claude Code
claude mcp add --transport http blablaprice https://blablaprice.com/api/mcp --header "Authorization: Bearer ТВІЙ_КЛЮЧ"n8n
Вузол MCP Client Tool: Endpoint https://blablaprice.com/api/mcp, Authentication: Header Auth (Authorization = Bearer ТВІЙ_КЛЮЧ).
Інструменти продавця
list_new_requests | нові запити за фільтром продавця, на які він ще не відповів |
get_request | один запит: текст, фото покупця (якщо є), категорія, бюджет, регіон, термін, чи є вже інші пропозиції і твоя з місцем (у топ-3 / у топ-5 / у топ-10) |
send_offer | надіслати пропозицію: текст (що саме, ціна чи від чого вона залежить, умови) і фото |
update_offer | змінити текст чи фото, поки покупець не обрав |
withdraw_offer | відкликати пропозицію |
message_buyer | написати покупцю в особистий чат запиту: до 3 питань до пропозиції, після неї будь-що |
my_offers | мої пропозиції; прийняті з контактами покупця |
my_account | тариф, фільтр, ліміти |
Інструменти покупця
create_request | створити запит; категорію можна не вказувати, підберемо самі; одне фото: image з POST /uploads (до 10 на день) |
find_category | кандидати категорій для фрази |
my_requests | мої запити з кількістю пропозицій |
get_my_request | запит і всі пропозиції від найвигіднішої: місце, відгуки продавця, текст продавця |
invite.invite_url | у відповіді create_request і get_my_request: посилання для людини, одним натиском вона надішле запит знайденим компаніям зі свого телефону чи пошти; покажи його, коли companies_found більшає |
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 | прийняти пропозицію у два кроки: лише після «так» людини і якщо це дозволено в кабінеті Якщо в продавця немає тарифу, відповідь буде state=waiting_seller: у нього 24 години, щоб відкрити контакти. |
my_contacts | прийняті угоди з контактами продавців |
my_account | регіони, ліміти, чи можна приймати |
REST API
Основа https://blablaprice.com/api/v1, відповіді JSON, ключ у заголовку Authorization: Bearer bbp_….
GET /me | продавець, тариф, фільтр, ліміти |
GET /requests?since=&limit= | нові запити за фільтром. since: номер останнього отриманого запиту (з поля next_since) або час ISO 8601; тоді приходять лише новіші, від старих до нових. include_answered=1: разом із тими, на які вже відповів |
GET /requests/{id} | один запит |
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} | одна пропозиція |
PATCH /offers/{id} | змінити comment і/або images |
DELETE /offers/{id} | відкликати пропозицію |
POST /uploads | фото для пропозиції (multipart, поле file, JPG/PNG/WEBP до 10 МБ) → {"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 | прийняти у два кроки ({"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 ТВІЙ_КЛЮЧ" "https://blablaprice.com/api/v1/requests?limit=5"
curl -X POST -H "Authorization: Bearer ТВІЙ_КЛЮЧ" -H "Content-Type: application/json" \
-d '{"comment": "Bosch WAN28263UA, нова, 13 500 грн, гарантія 2 роки, доставка за 2 дні"}' \
https://blablaprice.com/api/v1/requests/319/offerЗапит у відповіді
{
"id": 319,
"text": "Пральна машина 8 кг, нова, з доставкою",
"category": {"id": 788, "name": "Електроніка / Техніка для дому / Пральні машини"},
"budget": 15000,
"currency": "UAH",
"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 (60 повідомлень на добу від однієї сторони в одному чаті), 409 closed. Власні контакти продавця в тексті не помилка: відповідь status=needs_exchange (див. with_contacts).
Контакти продавця в тексті (посилання, сайт, каталог, телефон, пошта, месенджер) це обмін контактами: покупець бачить їх одразу. Перша відповідь кожного акаунта продавця з контактами безкоштовна. Далі send_offer, update_offer і message_buyer (MCP і REST) нічого не надсилають і повертають status=needs_exchange: contacts_found, price (1 контакт тарифу або разовий доступ), coverage, options. Спитай людину, тоді повтори виклик з with_contacts=true (без тарифу чи разового доступу прийде pay_url для людини) або прибери контакти. Текст сайт не ріже.
До 60 звернень на хвилину на ключ і до 300 пропозицій від агента на добу. Агент продавця працює на кожному тарифі; надсилати пропозиції безкоштовно. Коли контакти тарифу закінчились, пропозиція зберігається й перевіряється (moderation: held, причина no_balance), але покупець її не бачить: вона піде з новим місяцем тарифу або після його зміни.
Сповіщення (вебхук)
Якщо в кабінеті вказати адресу https://…, ми одразу надсилатимемо туди POST із JSON:
request.new | новий запит за фільтром (data.request) |
offer.accepted | покупець прийняв пропозицію, з його контактами (data.offer.buyer) |
exchange.waiting | продавцю: покупець хоче обмінятися контактами, а тарифу немає (data.exchange.pay_url: посилання для людини, агент не платить) |
offer.contacts_opened / exchange.expired | покупцю: продавець відкрив контакти / не відкрив їх за 24 години |
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. Якщо адреса не відповідає, повторимо через 1, 5, 30 хвилин і 2 години; після 5 невдалих спроб сповіщення призупиняться, і ми напишемо тобі на пошту.
Ціни й пропозиції отримаєш на свій e-mail і в чаті цього запиту.
Твій запит готовий.
Куди надіслати ціни від фірм?
У цьому застосунку вхід через Google не працює. Введи e-mail нижче або відкрий сторінку в браузері.
Вхід у BlaBlaPrice
Один акаунт, щоб і купувати, і продавати. Без паролів: вхід через Google або кодом на email, акаунт створиться сам.
Твій запит ми зберегли: після входу одразу надішлемо його продавцям 🚀
Контакти побачить лише той продавець, кого ти обереш.
- Ти порівнюєш ціни кількох фірм і сам вирішуєш, чи погоджуватись.
- Ніхто не дзвонить: фірми пишуть у чат, а контакти отримає лише той, кого ти обереш.
- Безкоштовно і ні до чого не зобов'язує: закрити запит можна будь-коли.
- Ціни й пропозиції отримаєш на свій e-mail і в чаті цього запиту.
або
Продовжуючи, ти погоджуєшся з Умовами та Політикою конфіденційності. Раз на місяць ми можемо надіслати тобі корисний лист від BlaBlaPrice, відписка в один клік.
Ціни й пропозиції отримаєш на свій e-mail і в чаті цього запиту.
Твій запит готовий.
Куди надіслати ціни від фірм?
У цьому застосунку вхід через Google не працює. Введи e-mail нижче або відкрий сторінку в браузері.
Реєстрація в BlaBlaPrice
Один акаунт, щоб і купувати, і продавати. Без паролів: вхід через Google або кодом на email, акаунт створиться сам.
Твій запит ми зберегли: після входу одразу надішлемо його продавцям 🚀
- Отримуєш запити покупців у своїх категоріях безкоштовно.
- Відповідь безкоштовна. Якщо покупець захоче обмінятися з тобою контактами, тоді потрібно вибрати варіант відкриття контактів: разовий доступ або тариф.
- Завантаж прайс, і BlaBlaPrice сам відповідатиме покупцям цінами з нього.
Контакти побачить лише той продавець, кого ти обереш.
- Ти порівнюєш ціни кількох фірм і сам вирішуєш, чи погоджуватись.
- Ніхто не дзвонить: фірми пишуть у чат, а контакти отримає лише той, кого ти обереш.
- Безкоштовно і ні до чого не зобов'язує: закрити запит можна будь-коли.
- Ціни й пропозиції отримаєш на свій e-mail і в чаті цього запиту.
або
Продовжуючи, ти погоджуєшся з Умовами та Політикою конфіденційності. Раз на місяць ми можемо надіслати тобі корисний лист від 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