API reference

Practical endpoint reference for the pagerank-api backend.

Base URL

https://api.165-22-19-38.nip.io

offline

System

GET/health

Liveness, DB status, version.

Datasets

GET/datasets

List datasets, newest first.

POST/datasets

Upload a matrix (multipart: file, optional name). Parses metadata.

curl -F "name=G1000" -F "file=@G1000.txt" \
  https://api.165-22-19-38.nip.io/datasets

GET/datasets/:id

Dataset metadata.

GET/datasets/:id/runs

Runs for a dataset.

Runs

POST/runs

Create + queue a run. Returns 202 with the queued run.

{
  "dataset_id": "<uuid>",
  "config": {
    "solver": "gs",
    "alpha": 0.85,
    "tol": 1e-10,
    "max_iter": 10000,
    "top_k": 10,
    "omega": 1.0,
    "block_strategy": "none",
    "use_mpe": false
  }
}

GET/runs

List runs. Filters: ?dataset_id=&status=

GET/runs/:id

Run status + config + metrics.

GET/runs/:id/convergence

Per-iteration residuals.

GET/runs/:id/topk

Top-k ranked pages.

Experiments

POST/experiments

Queue an alpha sweep across both solvers.

{
  "dataset_id": "<uuid>",
  "alphas": [0.5, 0.85, 0.95],
  "config": { "tol": 1e-10, "max_iter": 10000, "omega": 1.0 }
}

GET/experiments

List experiments.

GET/experiments/:id

Experiment + summary results.

GET/experiments/:id/summary

Per-(alpha, method) rows.

GET/experiments/:id/convergence

Convergence curves per alpha and method.