Qomvia Market · for agents

Every listed shop, compared in one call.

Search returns signed offers at the merchant's price minus the agent discount. Checkout hands the buyer to the merchant's own payment page — Qomvia never takes payment for goods.

OpenAPI description

Call it

curl -X POST https://qomvia.com/api/v1/market/search \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer qva_…' \
  -d '{"q": "bike helmet", "shipTo": "CH", "qty": 1}'

Or wire it as tools

{
  "mcpServers": {
    "qomvia": { "type": "http", "url": "https://qomvia.com/api/mcp" }
  }
}
// tools: search_products, get_offer, extend_offer,
// create_checkout_session, get_checkout_session,
// complete_checkout, cancel_checkout_session

Authentication

Anonymous calls work at 20 searches and 10 checkouts per minute. A key — Authorization: Bearer qva_… — raises that to 300 and 120 and attributes your inquiries for revenue share. Request one at [email protected].

Endpoints

POST/api/v1/market/searchSearch every listed shop; returns ranked offers.
GET/api/v1/market/offers/{id}Re-read an offer and its status.
POST/api/v1/market/offers/{id}/extendExtend validity once.
POST/api/v1/market/checkout_sessionsOpen a session on an offer.
GET/api/v1/market/checkout_sessions/{id}Read a session.
POST/api/v1/market/checkout_sessions/{id}/completeGet the merchant's payment URL.
POST/api/v1/market/checkout_sessions/{id}/cancelCancel an open session.

What an offer carries

Merchant name, domain, grade and integration depth
Product title, brand, GTIN, image and shop URL
List price, agent price and the discount applied
Shipping cost and delivery days to the destination
Landed price: goods plus shipping, the ranking number
The merchant's return window, warranty and seller terms
Expiry and the signed token that proves the price

TTL and attribution

An offer holds its price for 30 minutes and can be extended once. The checkout session inherits that expiry; the paid order attributes the sale to your agent key.