所有文件 Nebula 文件 所有端點 互動式文件 Markdown OpenAPI JSON
  1. REST API
  2. 查詢

文字轉主體 ID

GET /subjects
ListSubjects

查詢人物、帳號與主題（包含 AI），並取得主體端點所接受的 subject_id。不包含資產；請改用 /assets 或 /search。

參數規則：

  • subject_id 不能與 query 合併使用。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/subjects 付款。不需要 Nebula 帳號或 API 金鑰；簽署前請先確認付款條件。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 額度已用完；回應會包含續約時間與已購買的額度餘額
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"
    }
  ]
}