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 /browse
GET /browse/{path}
Path Parameters
The path prefix to browse under (e.g., 1969, 1969/july). Omit to browse from the root.
Authentication
Requires a valid service key via the verify_service_key dependency.
Response
The browsed path prefix (e.g., /1969 or / for root)
List of available path segments under this prefix
The next path segment (e.g., 1969, july, apollo-11-moon-landing)
Number of moments under this segment
Human-readable label (currently same as segment)
Examples
Browse Root
curl -X GET "https://api.timepoint.io/browse" \
-H "X-Service-Key: your_service_key"
{
"prefix": "/",
"items": [
{
"segment": "1960s",
"count": 142,
"label": "1960s"
},
{
"segment": "1969",
"count": 38,
"label": "1969"
},
{
"segment": "1970s",
"count": 95,
"label": "1970s"
},
{
"segment": "ancient",
"count": 203,
"label": "ancient"
}
]
}
Browse Specific Year
curl -X GET "https://api.timepoint.io/browse/1969" \
-H "X-Service-Key: your_service_key"
{
"prefix": "/1969",
"items": [
{
"segment": "january",
"count": 5,
"label": "january"
},
{
"segment": "july",
"count": 12,
"label": "july"
},
{
"segment": "august",
"count": 8,
"label": "august"
},
{
"segment": "december",
"count": 4,
"label": "december"
}
]
}
Browse Month
curl -X GET "https://api.timepoint.io/browse/1969/july" \
-H "X-Service-Key: your_service_key"
{
"prefix": "/1969/july",
"items": [
{
"segment": "apollo-11-moon-landing",
"count": 1,
"label": "apollo-11-moon-landing"
},
{
"segment": "chappaquiddick-incident",
"count": 1,
"label": "chappaquiddick-incident"
}
]
}
Behavior Notes
- Only public moments are included in browse results
- Results are sorted alphabetically by segment name
- The
count field shows the total number of moments under that segment, including all nested paths
- Empty segments (with no public moments) are not returned
- Leading and trailing slashes in the path are automatically normalized
Use Cases
- Navigation UI: Build hierarchical navigation menus
- Discovery: Let users explore moments by time period or category
- Analytics: Understand content distribution across the graph
- Autocomplete: Suggest valid path segments for search interfaces