Da testo a subject ID

GET /subjects

ListSubjects

Cerca persone, account e argomenti, inclusi quelli AI, e ottieni subject_id accettati dagli endpoint dei soggetti. Gli asset non sono inclusi; usa /assets o /search per quelli.

Regole dei parametri:

subject_id non può essere combinato con query.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/subjects. Non sono richiesti un account Nebula o una chiave API; controlla l'offerta di pagamento prima di firmare. Guida al pagamento x402.

Parametri

subject_id string QUERY

Cerca un singolo soggetto tramite il subject_id canonico restituito da /subjects o /search. Non può essere combinato con query.

Example:text:jensen huang

query string QUERY

Ricerca senza distinzione tra maiuscole e minuscole su identificatori pubblici e nomi.

Example:NVIDIA

limit integer QUERY

Numero massimo di risultati restituiti.

Default:50

offset integer QUERY

Numero di risultati saltati.

Default:0

Esempio cURL

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

Risposte

200 OK

400 Richiesta non valida

401 Non autorizzato

402 Crediti esauriti; la risposta include i tempi di rinnovo e il saldo dei crediti acquistati

403 Vietato

404 Non trovato

405 Metodo non consentito; l'header Allow elenca il metodo supportato

429 Troppe richieste

500 Errore interno del server

503 Servizio non disponibile

Tipo di media application/json

has_more

boolean obbligatorio

True quando è disponibile un'altra pagina dopo i record restituiti.

limit

integer obbligatorio

Numero massimo di record richiesti.

offset

integer obbligatorio

Numero di record corrispondenti saltati.

subjects

array<object> obbligatorio

Soggetti non asset che corrispondono ai filtri di discovery.

subjects[].name

string obbligatorio

Nome leggibile.

subjects[].subject_id

string obbligatorio

Identificatore canonico per una persona, un account o un argomento non riconducibile a un asset.

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