Network Graph
Find how one person reaches another through Orbit’s Network Graph, by the fewest people or by the strongest ties.
GET
/
v3
/
people
/
{profile_id}
/
network
/
path
curl "https://api.orbitsearch.com/v3/people/FROM_PROFILE_ID/network/path?to=TO_PROFILE_ID&mode=strongest" \
-H "Authorization: Bearer sk_orb_REDACTED"
{
"from_profile_id": "FROM_PROFILE_ID",
"to_profile_id": "TO_PROFILE_ID",
"mode": "strongest",
"found": true,
"degrees": 2,
"strength": 0.275,
"people": [
{ "profile_id": "FROM_PROFILE_ID", "name": "Ana Ruiz" },
{ "profile_id": "MIDDLE_PROFILE_ID", "name": "Ben Cole" },
{ "profile_id": "TO_PROFILE_ID", "name": "Cara Diaz" }
],
"links": [
{
"from_profile_id": "FROM_PROFILE_ID",
"to_profile_id": "MIDDLE_PROFILE_ID",
"strength": 0.55,
"relationships": ["coworker"],
"organizations": [{ "name": "Acme", "overlap_years": 3 }],
"schools": []
},
{
"from_profile_id": "MIDDLE_PROFILE_ID",
"to_profile_id": "TO_PROFILE_ID",
"strength": 0.5,
"relationships": ["colleague"],
"organizations": [],
"schools": []
}
],
"reason": null,
"billing": {
"id": "BILLING_OPERATION_ID",
"pricingVersion": "2026-11-03",
"reservedCredits": 5,
"consumedCredits": 5,
"releasedCredits": 0,
"heldCredits": 0,
"status": "settled"
},
"contract_version": "network-path.v1"
}
{
"from_profile_id": "FROM_PROFILE_ID",
"to_profile_id": "TO_PROFILE_ID",
"mode": "shortest",
"found": false,
"degrees": null,
"strength": null,
"people": [],
"links": [],
"reason": "no_path",
"billing": null,
"contract_version": "network-path.v1"
}
The Network Graph holds the ties between the people in Orbit. This endpoint returns the chain of people that connects one person to another, with the strength of each link and what ties each pair.
Two people are linked when Orbit holds a direct relationship between them (family, a stated connection, a mutual follow on social media) or when they worked, or studied, at the same place in the same years. A path has at most six links.
Modes
| Mode | Returns |
|---|---|
shortest (default) | The path with the fewest people. Among paths of that length, the strongest. |
strongest | The path with the strongest ties. It can be one link longer than the shortest path. |
Strength
Each link has astrength from 0 to 1. Family and long overlaps at one employer are strong. A mutual follow alone, or a short overlap, is weak. The path’s strength is the strengths of its links multiplied, so a shorter path of strong ties scores higher than a longer path of weak ones.
Credits
A found path is charged at the Network Graph path rate in the pricing catalog. A search that finds no path is free:found is false, reason says why, and billing is null. Send an Idempotency-Key header to retry a request without a second charge. See Credits.
curl "https://api.orbitsearch.com/v3/people/FROM_PROFILE_ID/network/path?to=TO_PROFILE_ID&mode=strongest" \
-H "Authorization: Bearer sk_orb_REDACTED"
{
"from_profile_id": "FROM_PROFILE_ID",
"to_profile_id": "TO_PROFILE_ID",
"mode": "strongest",
"found": true,
"degrees": 2,
"strength": 0.275,
"people": [
{ "profile_id": "FROM_PROFILE_ID", "name": "Ana Ruiz" },
{ "profile_id": "MIDDLE_PROFILE_ID", "name": "Ben Cole" },
{ "profile_id": "TO_PROFILE_ID", "name": "Cara Diaz" }
],
"links": [
{
"from_profile_id": "FROM_PROFILE_ID",
"to_profile_id": "MIDDLE_PROFILE_ID",
"strength": 0.55,
"relationships": ["coworker"],
"organizations": [{ "name": "Acme", "overlap_years": 3 }],
"schools": []
},
{
"from_profile_id": "MIDDLE_PROFILE_ID",
"to_profile_id": "TO_PROFILE_ID",
"strength": 0.5,
"relationships": ["colleague"],
"organizations": [],
"schools": []
}
],
"reason": null,
"billing": {
"id": "BILLING_OPERATION_ID",
"pricingVersion": "2026-11-03",
"reservedCredits": 5,
"consumedCredits": 5,
"releasedCredits": 0,
"heldCredits": 0,
"status": "settled"
},
"contract_version": "network-path.v1"
}
{
"from_profile_id": "FROM_PROFILE_ID",
"to_profile_id": "TO_PROFILE_ID",
"mode": "shortest",
"found": false,
"degrees": null,
"strength": null,
"people": [],
"links": [],
"reason": "no_path",
"billing": null,
"contract_version": "network-path.v1"
}
Headers
Path Parameters
Query Parameters
Response
The path, or why no path was returned.
⌘I
curl "https://api.orbitsearch.com/v3/people/FROM_PROFILE_ID/network/path?to=TO_PROFILE_ID&mode=strongest" \
-H "Authorization: Bearer sk_orb_REDACTED"
{
"from_profile_id": "FROM_PROFILE_ID",
"to_profile_id": "TO_PROFILE_ID",
"mode": "strongest",
"found": true,
"degrees": 2,
"strength": 0.275,
"people": [
{ "profile_id": "FROM_PROFILE_ID", "name": "Ana Ruiz" },
{ "profile_id": "MIDDLE_PROFILE_ID", "name": "Ben Cole" },
{ "profile_id": "TO_PROFILE_ID", "name": "Cara Diaz" }
],
"links": [
{
"from_profile_id": "FROM_PROFILE_ID",
"to_profile_id": "MIDDLE_PROFILE_ID",
"strength": 0.55,
"relationships": ["coworker"],
"organizations": [{ "name": "Acme", "overlap_years": 3 }],
"schools": []
},
{
"from_profile_id": "MIDDLE_PROFILE_ID",
"to_profile_id": "TO_PROFILE_ID",
"strength": 0.5,
"relationships": ["colleague"],
"organizations": [],
"schools": []
}
],
"reason": null,
"billing": {
"id": "BILLING_OPERATION_ID",
"pricingVersion": "2026-11-03",
"reservedCredits": 5,
"consumedCredits": 5,
"releasedCredits": 0,
"heldCredits": 0,
"status": "settled"
},
"contract_version": "network-path.v1"
}
{
"from_profile_id": "FROM_PROFILE_ID",
"to_profile_id": "TO_PROFILE_ID",
"mode": "shortest",
"found": false,
"degrees": null,
"strength": null,
"people": [],
"links": [],
"reason": "no_path",
"billing": null,
"contract_version": "network-path.v1"
}
