---
title: "列产品榜单（热门/今日/随机/月榜）"
method: GET
path: "/v1/products"
tags: ["检索"]
---

# 列产品榜单（热门/今日/随机/月榜）

`GET /v1/products`

## Request

- Base URL: `https://api.opcmenu.com`
- URL: `https://api.opcmenu.com/v1/products`
- Auth: none declared

用户想「逛逛」「看热门」「今日新品」「月度榜」时调用，比语义搜索更适合无明确意图的浏览。

## Query parameters

- `type` 'hottest' | 'today' | 'random' | 'leaderboard'
- `limit` integer

## Response `200`

产品列表

- object
  - `ok` boolean
  - `data` object
    - `items` ProductCard[]
      - `id` string
      - `slug` string
      - `name` string
      - `tagline` string
      - `logoUrl` string, nullable
      - `coverUrl` string, nullable
      - `category` string
      - `publishedAt` string, date-time

---

[API](https://skmtc.dev/opcmenu/apis/opc-api.md) · [All operations](https://skmtc.dev/opcmenu/apis/opc-api/llms.txt) · [OpenAPI document](https://skmtc.dev/opcmenu/apis/opc-api/revisions/ccdee07fb248?raw)