Texto a ID de sujeto

GET /subjects

ListSubjects

Busca personas, cuentas y temas, incluida la IA, y obtén los subject_id que acepta cada endpoint de sujetos. Los activos no se incluyen; usa /assets o /search para esos.

Reglas de los parámetros:

subject_id no se puede combinar con query.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/subjects. No se requiere cuenta de Nebula ni clave de API; consulta la oferta de pago antes de firmar. Guía de pago x402.

Parámetros

subject_id string QUERY

Busca un sujeto por el subject_id canónico que devolvió /subjects o /search. No se puede combinar con query.

Example:text:jensen huang

query string QUERY

Búsqueda sin distinción de mayúsculas y minúsculas en identificadores públicos y nombres.

Example:NVIDIA

limit integer QUERY

Número máximo de resultados devueltos.

Default:50

offset integer QUERY

Número de resultados omitidos.

Default:0

Ejemplo de cURL

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

Respuestas

200 OK

400 Solicitud incorrecta

401 No autorizado

402 Créditos agotados; la respuesta incluye el momento de renovación y el saldo de créditos comprados

403 Prohibido

404 No encontrado

405 Método no permitido; el encabezado Allow enumera el método admitido

429 Demasiadas solicitudes

500 Error interno del servidor

503 Servicio no disponible

Tipo de medio application/json

has_more

boolean obligatorio

True cuando hay otra página disponible después de los registros devueltos.

limit

integer obligatorio

Número máximo de registros solicitados.

offset

integer obligatorio

Número de registros coincidentes omitidos.

subjects

array<object> obligatorio

Sujetos que no son activos y que coinciden con los filtros de descubrimiento.

subjects[].name

string obligatorio

Nombre legible para personas.

subjects[].subject_id

string obligatorio

Identificador canónico de una persona, cuenta o tema que no es un activo.

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