---
title: "Recommend For Ranking"
method: GET
path: "/api/v1/algorithms/recommend-for-ranking/{ranking_id}"
tags: ["Algorithms"]
---

# Recommend For Ranking

`GET /api/v1/algorithms/recommend-for-ranking/{ranking_id}`

## Request

- Base URL: `https://app.aimrank.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aimrank.io/api/v1/algorithms/recommend-for-ranking/{ranking_id}`
- Auth: none declared

Empirical algorithm recommendation for a *specific* ranking.

Combines the rule-based registry with backtesting on the ranking's
actual vote history. If the ranking has fewer than 100 votes, falls
back to rule-based. If it has more, runs paired-bootstrap log-loss
comparison across {elo, glicko2, bradley_terry, openskill, elo_mmr}
and returns the empirically-best algorithm with statistical evidence.

This is the SOTA-aligned upgrade over /algorithms/recommend.

## Path parameters

- `ranking_id` string, required

## Query parameters

- `domain` string, nullable: Domain hint (sports_1v1, products, etc.)
- `has_teams` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aimrank/apis/aimrank-api.md) · [All operations](https://skmtc.dev/aimrank/apis/aimrank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aimrank/apis/aimrank-api/revisions/3574d0aff459?raw)
