Find bridges

Find the entities that connect otherwise separate groups (betweenness centrality).

POST/api/v2.0-preview/atlas/analysis/bridges

Authorizations

Bearer

Authorizationstringrequiredheader

Required Bearer API key: your NOSIBLE API key from the API Dashboard.

Example: Bearer nos_sk_...

Body

application/json

graphobjectrequiredbody

The graph to analyse: the same object as the By entity body (entities, hops 1 to 3 defaulting to 2, and the filters). as_of and from go at the top level, not inside graph. Scope is capped at 100,000 entities.

Example: {"entities":[{"type":"ORG","name":"OpenAI"},{"type":"ORG","name":"Anthropic"},{"type":"ORG","name":"xAI"}],"hops":1,"direction":"in","predicates":["invests_in"],"min_support":5}

limitintegerbody

Entities returned. Defaults to 25, maximum 500.

Example: 6

samplesintegerbody

Source entities sampled. Defaults to 256, maximum 2,048. More samples are slower and more precise.

Example: 256

as_ofdatebody

Point in time (YYYY-MM-DD). Only events dated on or before it count. Defaults to the latest date in the release. `to` is accepted as the same parameter, as in the World API.

Example: 2024-12-31

fromdatebody

Optional start of the evidence window (YYYY-MM-DD, inclusive).

Example: 2020-01-01

How to use this endpoint

guidance

Use Find bridges to find the entities that sit on the paths between groups, such as the intermediaries between two companies' networks. Scores are betweenness centrality, sampled with a fixed seed when the graph has more entities than samples (approximate is then true). Around one entity at one hop the graph is a star in which only the centre scores, so start from entities that are not directly connected: the example asks which investors connect OpenAI, Anthropic and xAI. The three labs, each the hub of its own investors, rank first; next come Sequoia Capital and Nvidia, which invest in all three, ahead of investors in two of them.

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.

bridgesobject[]

[{rank, entity, score}], highest score first.

samplesinteger

Source entities sampled.

scopeobject

{nodes, edges, truncated}: the size of the graph analysed.

approximateboolean

True when the answer comes from sampling or an iteration cap.

schemastring

Response schema name.

as_ofdate

The point in time the answer is computed for.

date_windowobject

The evidence window: from, to, archive_cutoff and include_live (always false).

releasestring

Immutable id of the graph release that answered. The same request against the same release returns identical bytes.

took_msinteger

Server time in milliseconds.

Responses and errors

HTTP

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

400invalid_request — A parameter is missing, malformed or out of range; the message names it.

400invalid_entity_type — The entity type is not one Atlas holds. TICKER is refused: send the company as an ORG.

400unknown_predicate — A relationship type is not in the graph; list them with Relationship types.

401api_key_required — No API key was sent. Send it as Authorization: Bearer <key> or the api-key header.

401invalid_api_key — The API key is invalid or has been revoked.

404unknown_entity — No entity of that type has that name in this release. When the name exists under another type, the message says which.

404not_found — No endpoint matches this method and path.

410cursor_expired — The cursor belongs to another release or request; restart from the first page.

422unprocessable_request — Each value is valid but not together, such as from after as_of.

422request_too_broad — The request ran out of its work budget before it could answer; narrow it.

429rate_limited — Too many requests for this key; wait for Retry-After.

501backend_not_configured — The Atlas backend is not configured for this deployment.

502backend_error — The Atlas backend could not be reached; retry shortly.

503unavailable — The service is busy or starting; retry after Retry-After.

503api_key_auth_unavailable — API key authentication is temporarily unavailable; retry shortly.

504request_timeout — The request took longer than 25 seconds; narrow it.

504backend_timeout — The Atlas backend did not answer before the deadline; retry.