Text to subject ID

GET /subjects

ListSubjects

Look up people, accounts, and topics, AI included, and get the subject_id the subject endpoints take. Assets are not included; use /assets or /search for those.

Parameter rules:

subject_id cannot be combined with query.

Wallet payment available at https://nebula-api.hiddensystems.ai/api/v1/x402/subjects. No Nebula account or API key required; check the payment offer before signing. x402 payment guide.

Parameters

subject_id string QUERY

Looks up one subject by the canonical subject_id that /subjects or /search returned. It cannot be combined with query.

Example:text:jensen huang

query string QUERY

Case-insensitive search across public identifiers and names.

Example:NVIDIA

limit integer QUERY

Maximum results returned.

Default:50

offset integer QUERY

Number of results skipped.

Default:0

cURL Example

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

Responses

200 OK

400 Bad Request

401 Unauthorized

402 Credits used up; response includes renewal timing and purchased credit balance

403 Forbidden

404 Not Found

405 Method not allowed; the Allow header lists the supported method

429 Too Many Requests

500 Internal Server Error

503 Service Unavailable

Media type application/json

has_more

boolean required

True when another page is available after the returned records.

limit

integer required

Maximum records requested.

offset

integer required

Number of matching records skipped.

subjects

array<object> required

Non-asset subjects matching the discovery filters.

subjects[].name

string required

Human-readable name.

subjects[].subject_id

string required

Canonical identifier for a non-asset person, account, or topic.

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