跳转到主要内容
主题是按主题或类别（例如”产品比较”、“价格问题”）组织您的搜索词的分组。每个搜索词属于一个主题。

​
列出主题

GET /projects/{project_id}/topics
返回项目中的所有主题。

​
路径参数

参数类型描述
project_idstring (UUID)项目 ID

​
查询参数

无。 
curl "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/topics" \
  -H "X-API-Key: tk_live_..."

​
响应

{
  "success": true,
  "data": [
    {
      "topic_id": "t1u2v3w4-...",
      "project_id": "a1b2c3d4-...",
      "name": "Product comparisons",
      "description": "Prompts comparing products in the category",
      "created_at": "2026-01-20T14:00:00+00:00"
    },
    {
      "topic_id": "u5v6w7x8-...",
      "project_id": "a1b2c3d4-...",
      "name": "Pricing questions",
      "description": null,
      "created_at": "2026-01-20T14:05:00+00:00"
    }
  ]
}

​
TopicResponse 字段

字段类型可空描述
topic_idstring (UUID)No主题 ID
project_idstring (UUID)No父项目 ID
namestringNo主题显示名称
descriptionstringYes主题描述
created_atstring (ISO 8601)No创建时间
通过 搜索词 和 概览 端点中的 topic_id 字段，使用此 topic_id 将搜索词与其所属主题分组关联起来。