文本转主体 ID

GET /subjects

ListSubjects

查找人物、账号和话题（包括 AI），并获取主体端点都接受的 subject_id。不包含资产；请使用 /assets 或 /search 查找资产。

参数规则：

subject_id 不能与 query 组合使用。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/subjects 使用。无需 Nebula 账户或 API key；签名前请先查看支付报价。x402 支付指南。

参数

subject_id string QUERY

通过 /subjects 或 /search 返回的规范 subject_id 查找单个主体。不能与 query 组合使用。

Example:text:jensen huang

query string QUERY

跨公开标识符和名称进行不区分大小写的搜索。

Example:NVIDIA

limit integer QUERY

返回的最大结果数。

Default:50

offset integer QUERY

跳过的结果数量。

Default:0

cURL 示例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/subjects' \
  --header 'X-API-Key: YOUR_API_KEY'

响应

200 OK

400 错误请求

401 未授权

402 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额

403 禁止访问

404 未找到

405 方法不被允许；Allow 响应头列出了支持的方法

429 请求过多

500 内部服务器错误

503 服务不可用

媒体类型 application/json

has_more

boolean 必填

返回的记录之后还有可用页面时为 true。

limit

integer 必填

请求的最大记录数。

offset

integer 必填

跳过的匹配记录数。

subjects

array<object> 必填

符合发现筛选条件的非资产主体。

subjects[].name

string 必填

人类可读的名称。

subjects[].subject_id

string 必填

非资产的人物、账户或主题的规范标识符。

{
  "has_more": false,
  "limit": 50,
  "offset": 0,
  "subjects": [
    {
      "name": "Artificial Intelligence",
      "subject_id": "text:artificial intelligence"
    }
  ]
}