テキストからサブジェクト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 で 1 つのサブジェクトを検索します。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> 必須

discovery フィルターに一致するアセット以外のサブジェクト。

subjects[].name
string 必須

人間が読める名前。

subjects[].subject_id
string 必須

アセット以外の人物、アカウント、トピックの正規識別子。

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