AuthorizationstringrequiredheaderRequired Bearer API key: your NOSIBLE API key from the API Dashboard.
Example: Bearer nos_sk_...
Rank the entities of a graph by importance from the point of view of chosen seeds, to find what matters most.
Ranks the entities of a graph from NOSIBLE Atlas V2.0 by importance, from the point of view of the seed entities you choose. Use it to find what matters most around some entities, for example the chipmakers closest to a given company, ranked above the rest.
These are the fields you can build against. Nested names use dot notation; optional sections are called out in their descriptions.
rankingobject[][{rank, entity, score}], highest score first.
seeds_outside_graphobject[]Seeds the graph does not contain, so they could not personalise the ranking. When none of the seeds is in the graph, the ranking is personalised to the graph's entities instead.
absent_entitiesobject[]Entities in graph (or, for Rank entities, in seeds) that had no event on or before as_of: {type, name, normalized, reason}. They did not exist in the graph at that date, so they are left out of the analysis: never ranked, grouped or scored. When none of graph's entities existed, the answer is empty with a scope of 0 nodes. Present only when not empty.
absent_entities[].typestringEntity type: ORG, PERSON, GPE, LOC or PRODUCT.
absent_entities[].namestringThe entity's canonical name: an alias you sent resolves to it.
absent_entities[].normalizedstringThe entity's normalized spelling.
absent_entities[].reasonstringWhy the entity is absent: no relationship or event on or before as_of, so it does not exist in the graph at that point in time. To see it, send an as_of after its first event (Entity relationships gives an entity's first_seen).
scopeobject{nodes, edges, truncated}: the size of the graph analysed.
approximatebooleanTrue when the answer comes from sampling or an iteration cap.
schemastringResponse schema name.
as_ofdateThe point in time the answer is computed for.
date_windowobjectThe evidence window: from, to, archive_cutoff and include_live (always false).
releasestringImmutable id of the graph release that answered. The same request against the same release returns identical bytes.
took_msintegerServer time in milliseconds.
invalid_request — The body is not valid JSON, is missing, or the request framing is broken. A request whose parameters are the problem is a 422 validation_error. Every error body, 401 included, is {error, message, status}.api_key_required — No API key was sent. Send it as Authorization: Bearer <key> or the api-key header.invalid_api_key — The API key is invalid or has been revoked.unknown_entity — No entity of that type has that name in this release. When the name exists under another type, the message says which.not_found — No endpoint has this path.method_not_allowed — The path exists but not for this method (a GET to a POST endpoint, or the reverse); the Allow header lists the methods it takes.cursor_expired — The cursor belongs to another release or request; restart from the first page.validation_error — A parameter the API cannot decode or validate: a missing required parameter, an unknown parameter, a value of the wrong type or outside its range (as_of outside the release's dates, a min_support below 1), or a date that does not exist, such as 2026-02-30. The message names the parameter and what is wrong.invalid_entity_type — The entity type is not one of ORG, PERSON, GPE, LOC or PRODUCT, in an entity or in other_types or exclude_types. For a ticker, send its company as an ORG.unknown_predicate — A relationship type is not in the graph; list them with Relationship types.unprocessable_request — Each value is valid but not together, such as from after as_of.request_too_broad — The request ran out of its work budget before it could answer; narrow it.rate_limited — Too many requests for this key; wait for Retry-After.backend_not_configured — The Atlas backend is not configured for this deployment.backend_error — The Atlas backend could not be reached; retry shortly.unavailable — The service is busy or starting; retry after Retry-After.api_key_auth_unavailable — API key authentication is temporarily unavailable; retry shortly.api_key_metering_unavailable — API key usage metering is temporarily unavailable, so the request was not served; wait for the Retry-After header (30 seconds) and retry.request_timeout — The request took longer than 25 seconds; narrow it.backend_timeout — The Atlas backend did not answer before the deadline; retry.