---
title: "Search every listed shop and receive signed offers"
method: POST
path: "/api/v1/market/search"
---

# Search every listed shop and receive signed offers

`POST /api/v1/market/search`

## Request

- Base URL: `https://qomvia.com`
- URL: `https://qomvia.com/api/v1/market/search`
- Auth: one of:
  - HTTP bearer
  - none

One call compares every merchant whose feed is fresh and ships to the destination country. Returns offers priced at the merchant's own price minus the agent discount, ranked by landed price. Each offer is signed, time-limited and unique to the inquiry.

## Request body

- SearchInput
  - `q` string: Free-text product search
  - `gtin` string: Exact GTIN/EAN match
  - `sku` string: Exact SKU match
  - `category` string
  - `brand` string
  - `shipTo` string, required: ISO-2 destination country
  - `currency` string: ISO-4217; adds a converted price hint
  - `qty` integer
  - `maxPriceCents` integer
  - `limit` integer

## Response `200`

Ranked offers for the inquiry.

- object
  - `inquiryId` string
  - `offers` OfferView[]
    - `offerId` string
    - `code` string: Human-readable code, QV- prefixed
    - `token` string: Signed offer token
    - `merchant` object
    - `product` object
    - `list` object
      - `cents` integer
      - `currency` string
    - `agent` object
      - `cents` integer
      - `currency` string
      - `discountCents` integer
      - `discountPercent` number
    - `shipping` object
    - `landedCents` integer: qty-adjusted agent price plus shipping
    - `availability` 'in_stock' | 'low_stock'
    - `qtyCap` integer
    - `expiresAt` string, date-time
    - `terms` object: Merchant's published return, warranty and seller terms
    - `extensible` boolean
    - `converted` object: Present when a currency hint was requested
  - `expiresAt` string, date-time, nullable
  - `shipTo` string

## Other responses

- `400`: Invalid request.
- `429`: Rate limited.

---

[API](https://skmtc.dev/qomvia/apis/qomvia-public-api.md) · [All operations](https://skmtc.dev/qomvia/apis/qomvia-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qomvia/apis/qomvia-public-api/revisions/0faa5a30f1a7?raw)