텍스트 → 주체 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"
    }
  ]
}