---
title: "get topic detail"
method: GET
path: "/v1/tool/get-topic"
tags: ["Tool"]
---

# get topic detail

`GET /v1/tool/get-topic`

Fetches structured details for one topic so an LLM can quickly understand what it is about.
Input is topic_id (from trending or search).
Output should include a topic description/definition, core keywords,
representative post summaries (post ids/links/authors/timestamps), and metadata.

## Query parameters

- `topic_id` string, required

## Response `200`

OK

- PubtoolDataResponseDomainStory
  - `data` DomainStory
    - `analysis_time` string
    - `authors` string[]
    - `current_rank` integer
    - `first_tweet_time` string — the time of the first tweet in this story
    - `id` string
    - `is_manual` boolean
    - `is_new` boolean — first time in top stories
    - `keyword` string
    - `rank_status` string — 'new','up','down','same'
    - `score` number
    - `snapshot_time` string
    - `source_type` string
    - `summary` string
    - `tweet_urls` string[]

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests

---

[API](https://skmtc.dev/chainbase/apis/data-cloud-task-api.md) · [All operations](https://skmtc.dev/chainbase/apis/data-cloud-task-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chainbase/data-cloud-task-api/revisions/4013781aa422/schema)