Documentation Index Fetch the complete documentation index at: https://mintlify.com/timepoint-ai/timepoint-clockchain/llms.txt
Use this file to discover all available pages before exploring further.
Endpoint GET /graph/neighbors/{path}
Returns all nodes connected to the specified node through edges, including edge metadata such as type, weight, and theme.
Authentication Requires service key authentication via X-Service-Key header.
Path Parameters The full path of the node (without leading slash). Example: events/1945/world-war-ii-ends
Response Returns an array of neighbor nodes with edge information.
Array of connected nodes The full path ID of the neighboring node
Display name of the neighboring node
Type of relationship. One of:
causes - Causal relationshipcontemporaneous - Events occurring in similar timeframe (within 1 year)same_location - Events in the same locationthematic - Events sharing common themes/tags Edge weight representing connection strength. Default values:
1.0 - causes (manual)0.5 - contemporaneous, same_location0.3 - thematic For thematic edges, contains comma-separated list of shared tags. Empty for other edge types.
Edge Types Explained Manually curated causal relationships where one event led to another. These represent the strongest semantic connections in the graph.
Automatically generated edges connecting events that occurred within 1 year of each other. Useful for discovering parallel historical developments.
Automatically generated edges connecting events in the same geographic location (matching country, region, and city). Helps discover location-based patterns.
Automatically generated edges connecting events that share common tags. The theme field contains the specific overlapping tags.
Example Request curl -X GET "https://api.timepointclockchain.com/graph/neighbors/events/1945/world-war-ii-ends" \ -H "X-Service-Key: your_service_key"
Example Response [ { "path" : "/events/1945/atomic-bomb-hiroshima" , "name" : "Atomic Bombing of Hiroshima" , "edge_type" : "causes" , "weight" : 1.0 , "theme" : "" }, { "path" : "/events/1945/yalta-conference" , "name" : "Yalta Conference" , "edge_type" : "contemporaneous" , "weight" : 0.5 , "theme" : "" }, { "path" : "/events/1946/nuremberg-trials" , "name" : "Nuremberg Trials Begin" , "edge_type" : "contemporaneous" , "weight" : 0.5 , "theme" : "" }, { "path" : "/events/1939/world-war-ii-begins" , "name" : "World War II Begins" , "edge_type" : "thematic" , "weight" : 0.3 , "theme" : "war, military, global-conflict" } ]
Error Responses Node not found { "detail" : "Node not found" }
Missing or invalid service key { "detail" : "Unauthorized" }
Notes
The response includes both incoming and outgoing edges
Edges are automatically generated based on temporal proximity, location, and thematic similarity
Manual causes edges must be explicitly created and represent curated relationships
An empty array is returned if the node has no neighbors