Ontology Classifier

Classify text against NOSIBLE's live semantic ontologies.

POST/api/models/ontology

Authorizations

Bearer

Authorizationstringrequiredheader

Required Bearer API key. Programmatic access to the World API needs a key; browsing nosible.world in a browser does not.

Example: Bearer nos_sk_...

Body

application/json

textstringrequiredbody

Text to classify. Maximum 50,000 characters.

Example: The company announced a new data centre investment.

How to use this endpoint

guidance

Use Ontology Classifier when you need live taxonomy predictions for text that is not yet in the World archive. The endpoint accepts the same text-only request and response shape as the other model endpoints.

Response body

application/json

These are the fields you can build against. Nested names use dot notation; optional sections are called out in their descriptions.

schemastring

Stable classifier response schema shared by the text model endpoints.

Example: nosible_model_classification_v1

modelstring

Pinned classifier name, version, and immutable build identifier.

Example: NOSIBLE/ontology-classifier-v2.0-preview@sha256:49b2ce9a6743b6b98f1428a392198f03e2b7a0dac3cac5fa3f0014b2149bfd54

textstring

The exact input text classified by the model.

Example: The company announced a new data centre investment.

predictionsobject[]

Flat list of predictions, ordered by descending score where scores are available.

Example: [{ "ontology": "gics", "label": "Information Technology", "score": 0.94 }]

predictions[].ontologystring

Ontology that produced the prediction.

Example: gics

predictions[].labelstring

Predicted class label.

Example: Information Technology

predictions[].scorenumber

Model confidence score when supplied by the classifier.

Example: 0.94

Responses and errors

HTTP

200Request succeeded. The response body is shown in the panel on the right.

400invalid_request — The request is syntactically valid JSON but a value, date, filter, or combination of fields is invalid.

401unauthorized — The required API key or Bearer credential is missing or invalid.

422validation_error — The request shape is understood but one or more values fail validation.

429rate_limited — The request exceeded the account or public-window rate limit. Respect Retry-After when supplied.

502upstream_error — An upstream retrieval service failed while processing the request.

504upstream_timeout — An upstream retrieval service did not respond within the request timeout.