---
title: "Unified marketplace search across listings and products"
method: GET
path: "/api/v1/marketplace/search"
tags: ["Marketplace", "Commerce and purchases"]
---

# Unified marketplace search across listings and products

`GET /api/v1/marketplace/search`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/v1/marketplace/search`
- Auth: one of:
  - HTTP bearer
  - none

One ranked, paginated result list across active marketplace listings and catalogue products/packs. Each item spreads its family's existing card shape plus a `kind` discriminator (`listing` | `product`); every product item carries `createdAt` for recency interleaving. `family` selects the result families: `all`, `collectibles` (card listings + merch products) or `packs` (pack listings + packs). `listingType` and `auctionState` are dropped for `family=packs`. `minOvr`/`maxOvr` are accepted and ignored until a backing OVR field lands. `totalCount` is exact on the last page, a lower bound while `hasMore` (same convention as the list endpoints).

## Query parameters

- `family` 'all' | 'collectibles' | 'packs'
- `q` string
- `sort` 'recent' | 'price-asc' | 'price-desc'
- `page` integer
- `limit` integer
- `listingType` 'sale' | 'auction' | 'trade' | 'all'
- `auctionState` 'all' | 'ending-soon' | 'just-started' | 'has-bids'
- `minPrice` number
- `maxPrice` number
- `minOvr` number
- `maxOvr` number
- `rarities` string
- `teams` string
- `leagues` string
- `sport` string
- `league` string
- `team` string
- `includeDemo` boolean

## Response `200`

{ success, data: { items, totalCount, hasMore, page, limit } }

## Other responses

- `400`: VALIDATION_ERROR

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/v1/marketplace/search/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
