---
title: common_neighbors
url: https://nexyron.tech/docs/cypher/procedures/algorithms/similarity-and-embedding/common-neighbors
description: Similarity and embedding procedures compare nodes by neighborhood overlap, random walk context, or learned vector position. They are useful for link prediction, recommendations, de
---

# common_neighbors

## Generic Description

Score pairs by shared neighbors.

Simple example:

```cypher
CALL nexyron.common_neighbors()
```

Similarity and embedding procedures compare nodes by neighborhood overlap, random-walk context, or learned vector position. They are useful for link prediction, recommendations, deduplication, and candidate generation.

## Consumer-Level Explanation

Use `common_neighbors` when score pairs by shared neighbors is the graph-analysis or operational question you actually need to answer. Keep the call explicit because its `YIELD` columns, row grain, and required runtime state determine how the rest of the Cypher pipeline can safely compose it. Structural similarity and embedding similarity are not the same: overlap metrics are explainable and local, while embeddings can capture broader context but need downstream validation.

## Conceptual Explanation

`common_neighbors` should be read as one named procedure contract in the broader Nexyron Cypher surface. The procedure call is not only a syntax hook: it defines what runtime state, projection, registry entry, or graph algorithm is being asked to operate, and it determines which output columns downstream `YIELD`, `WITH`, and `RETURN` stages can safely use.

## More Detailed Explanation

This is one of the simplest link-prediction heuristics

In practical queries, start by deciding the row grain you want after the call: one row per node, one row per path, one row per registry object, one row per artifact, or one row per summary. Then keep that grain explicit with `YIELD` and named projections. That is the difference between a useful planner-facing example and a vague call that downstream tooling cannot safely compose. For contract-driven procedures, the executable examples on these pages intentionally inspect procedure metadata unless the required named artifacts are created in the same example.

## How It Differs From Nearby Algorithms

This is one of the simplest link-prediction heuristics.

## Advanced Example

This example yields named columns from `common_neighbors` and returns a bounded result shape that downstream planner tooling can compose without guessing column names or row grain.

```cypher
CALL nexyron.common_neighbors() YIELD source, target, score
RETURN source, target, score
LIMIT 10
```

## Real Use Cases

-   friend recommendation baselines
-   candidate-link ranking
-   sanity-checking richer predictors
-   compare algorithm output with domain labels or time windows before operationalizing it
-   feed graph-analytic scores into ranked reports, feature contracts, or investigation queues only after checking the modeling assumptions

## Real Limitations And Tradeoffs

-   very local and easy to overrate
-   algorithm output reflects the projected graph, not an abstract real-world network outside the data model
-   nearby algorithms can answer different questions even when their output columns look similar