---
title: "POST /api/admin/discover/explain"
method: POST
path: "/api/admin/discover/explain"
tags: ["Admin"]
---

# POST /api/admin/discover/explain

`POST /api/admin/discover/explain`

## Request body

- object
  - `userId` string, required

## Response `200`

OK

- object
  - `state` object, required
    - `isGenerating` boolean, required
    - `seenSinceGeneration` number, required
    - `recentExaQueries` string[], required
  - `stats` object[], required
    - `sourceKind` 'interest' | 'explore' | 'timely' | 'search' | 'question' | 'shared', required
    - `seen` number, required
    - `engaged` number, required
    - `skipped` number, required
    - `opened` number, required
    - `loved` number, required
  - `topics` object[], required
    - `key` string, required
    - `label` string, required
    - `kind` 'interest' | 'explore', required
    - `state` 'active' | 'cooldown', required
    - `alpha` number, required
    - `beta` number, required
    - `score` number, required
    - `laneId` string, nullable, required
    - `lastEngagedAt` string, nullable, required
    - `cooldownUntil` string, nullable, required
  - `pool` object[], required
    - `id` string, required
    - `headline` string, required
    - `topicKey` string, nullable, required
    - `sourceKind` 'interest' | 'explore' | 'timely' | 'search' | 'question' | 'shared', required
    - `sourceQuery` string, required
    - `relevance` number, required
    - `topicScore` number, required
    - `score` number, required
    - `dislikeSim` number, required
    - `suppressed` boolean, required
    - `windowRank` number, nullable, required
    - `position` number, required
  - `recentSeen` object[], required
    - `id` string, required
    - `headline` string, required
    - `topicKey` string, nullable, required
    - `sourceKind` 'interest' | 'explore' | 'timely' | 'search' | 'question' | 'shared', required
    - `dwellMs` number, required
    - `opened` boolean, required
    - `openDwellMs` number, required
    - `engaged` boolean, required
    - `reaction` 'loved' | 'disliked', nullable, required
    - `seenAt` string, nullable, required
  - `signals` object[], required
    - `kind` 'search_query' | 'card_question', required
    - `text` string, required
    - `cardId` string, nullable, required
    - `createdAt` string, required

---

[API](https://skmtc.dev/fromolive/apis/olive-api.md) · [All operations](https://skmtc.dev/fromolive/apis/olive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fromolive/olive-api/revisions/01f6261481a3/schema)