AimRank AI & Transfer Learning API
The AI & Transfer Learning API from AimRank — 18 operation(s) for ai & transfer learning.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/aimrank-io:aimrank-io-ai-transfer-learning-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: AimRank AI & Transfer Learning API
description: Ranking-as-a-Service API — Turn binary comparisons into calibrated rankings with Glicko-2, Bradley-Terry, TrueSkill, and cross-domain transfer learning. Includes webhooks, API keys, RLHF exports, and embeddable widgets.
version: 4.12.0
tags:
- name: AI & Transfer Learning
paths:
/api/v1/ai/embeddings/stats:
get:
tags:
- AI & Transfer Learning
summary: Get Embedding Stats
description: Get embedding service statistics.
operationId: get_embedding_stats_api_v1_ai_embeddings_stats_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/EmbeddingStatsResponse'
/api/v1/ai/embeddings/train:
post:
tags:
- AI & Transfer Learning
summary: Train Embeddings
description: Train or update embeddings from vote data (compute-heavy; Creator+).
operationId: train_embeddings_api_v1_ai_embeddings_train_post
parameters:
- name: force
in: query
required: false
schema:
type: boolean
description: Force retraining even if up to date
default: false
title: Force
description: Force retraining even if up to date
- name: background
in: query
required: false
schema:
type: boolean
description: Run training in background thread
default: false
title: Background
description: Run training in background thread
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TrainEmbeddingsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/embeddings/training-status:
get:
tags:
- AI & Transfer Learning
summary: Get Training Status
description: Get current embedding training status.
operationId: get_training_status_api_v1_ai_embeddings_training_status_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/api/v1/ai/embeddings/similar-users:
get:
tags:
- AI & Transfer Learning
summary: Find Similar Users
description: Find users with similar preference patterns.
operationId: find_similar_users_api_v1_ai_embeddings_similar_users_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 50
minimum: 1
default: 10
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/api__routes__ai__SimilarUserResponse'
title: Response Find Similar Users Api V1 Ai Embeddings Similar Users Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/embeddings/similar-entities/{entity_id}:
get:
tags:
- AI & Transfer Learning
summary: Find Similar Entities
description: 'Find entities similar to the given one (cross-domain capability).
Results are restricted to entities in rankings the caller may view (public
or owned) so private entity NAMES don''t leak via similarity search.'
operationId: find_similar_entities_api_v1_ai_embeddings_similar_entities__entity_id__get
parameters:
- name: entity_id
in: path
required: true
schema:
type: string
title: Entity Id
- name: limit
in: query
required: false
schema:
type: integer
maximum: 50
minimum: 1
default: 10
title: Limit
- name: same_ranking_only
in: query
required: false
schema:
type: boolean
default: false
title: Same Ranking Only
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/SimilarEntityResponse'
title: Response Find Similar Entities Api V1 Ai Embeddings Similar Entities Entity Id Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/transfer/domains:
get:
tags:
- AI & Transfer Learning
summary: Get User Domains
description: Get all domains the user has voted in with preference profiles.
operationId: get_user_domains_api_v1_ai_transfer_domains_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/DomainProfileResponse'
type: array
title: Response Get User Domains Api V1 Ai Transfer Domains Get
/api/v1/ai/transfer/discover:
get:
tags:
- AI & Transfer Learning
summary: Discover New Domains
description: Recommend new domains the user might enjoy based on preferences.
operationId: discover_new_domains_api_v1_ai_transfer_discover_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 20
minimum: 1
default: 5
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/NewDomainRecommendation'
title: Response Discover New Domains Api V1 Ai Transfer Discover Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/transfer/predict/{ranking_id}:
get:
tags:
- AI & Transfer Learning
summary: Predict In Ranking
description: Predict user preferences for entities in a ranking they haven't voted in.
operationId: predict_in_ranking_api_v1_ai_transfer_predict__ranking_id__get
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
- name: limit
in: query
required: false
schema:
type: integer
maximum: 50
minimum: 1
default: 10
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/TransferPredictionResponse'
title: Response Predict In Ranking Api V1 Ai Transfer Predict Ranking Id Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/transfer/validate/{ranking_id}:
get:
tags:
- AI & Transfer Learning
summary: Validate Transfer Accuracy
description: 'Validate cross-domain transfer prediction accuracy.
Uses leave-one-out validation on the user''s votes in the target ranking
to measure how well preferences transfer from other domains.'
operationId: validate_transfer_accuracy_api_v1_ai_transfer_validate__ranking_id__get
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/transfer/predict-matchup:
get:
tags:
- AI & Transfer Learning
summary: Predict Matchup Cross Domain
description: Predict which entity the user will prefer using cross-domain transfer.
operationId: predict_matchup_cross_domain_api_v1_ai_transfer_predict_matchup_get
parameters:
- name: entity_a_id
in: query
required: true
schema:
type: string
title: Entity A Id
- name: entity_b_id
in: query
required: true
schema:
type: string
title: Entity B Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/api__routes__ai__PreferencePredictionResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/jobs/{job_id}:
get:
tags:
- AI & Transfer Learning
summary: Check Job Status
description: Check the status of a background job.
operationId: check_job_status_api_v1_ai_jobs__job_id__get
parameters:
- name: job_id
in: path
required: true
schema:
type: string
title: Job Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/algorithms:
get:
tags:
- AI & Transfer Learning
summary: List Algorithms
description: List all available rating algorithms with their capabilities.
operationId: list_algorithms_api_v1_ai_algorithms_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/api__routes__ai__AlgorithmInfo'
type: array
title: Response List Algorithms Api V1 Ai Algorithms Get
/api/v1/ai/algorithms/{name}:
get:
tags:
- AI & Transfer Learning
summary: Get Algorithm
description: Get detailed info about a specific algorithm.
operationId: get_algorithm_api_v1_ai_algorithms__name__get
parameters:
- name: name
in: path
required: true
schema:
type: string
title: Name
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/api__routes__ai__AlgorithmInfo'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/algorithms/recommend:
get:
tags:
- AI & Transfer Learning
summary: Recommend Algorithm
description: Get algorithm recommendation based on use case.
operationId: recommend_algorithm_api_v1_ai_algorithms_recommend_get
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Domain type: sports, games, products, etc.'
title: Domain
description: 'Domain type: sports, games, products, etc.'
- name: data_sparsity
in: query
required: false
schema:
anyOf:
- enum:
- dense
- medium
- sparse
type: string
- type: 'null'
title: Data Sparsity
- name: needs_uncertainty
in: query
required: false
schema:
type: boolean
default: false
title: Needs Uncertainty
- name: needs_draws
in: query
required: false
schema:
type: boolean
default: false
title: Needs Draws
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/api__routes__ai__AlgorithmRecommendation'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/algorithms/compare:
get:
tags:
- AI & Transfer Learning
summary: Compare Algorithms
description: Compare algorithm capabilities side by side.
operationId: compare_algorithms_api_v1_ai_algorithms_compare_get
parameters:
- name: algorithms
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Comma-separated algorithm names
title: Algorithms
description: Comma-separated algorithm names
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/rankings/{ranking_id}/algorithm-settings:
get:
tags:
- AI & Transfer Learning
summary: Get Ranking Algorithm Settings
description: Get algorithm settings for a ranking.
operationId: get_ranking_algorithm_settings_api_v1_ai_rankings__ranking_id__algorithm_settings_get
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- AI & Transfer Learning
summary: Update Ranking Algorithm Settings
description: Update algorithm settings for a ranking.
operationId: update_ranking_algorithm_settings_api_v1_ai_rankings__ranking_id__algorithm_settings_put
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RankingAlgorithmSettings'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/rankings/{ranking_id}/optimize-decay:
post:
tags:
- AI & Transfer Learning
summary: Optimize Decay
description: 'Find optimal temporal decay settings via grid search (compute-heavy; Creator+).
Tests combinations of decay_rate x threshold_days and returns
the configuration that maximizes accuracy for this ranking.'
operationId: optimize_decay_api_v1_ai_rankings__ranking_id__optimize_decay_post
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
- name: algorithm
in: query
required: false
schema:
type: string
description: Algorithm to optimize for
default: glicko2
title: Algorithm
description: Algorithm to optimize for
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/ai/stats:
get:
tags:
- AI & Transfer Learning
summary: Get Ai Stats
description: Get overall AI/ML statistics.
operationId: get_ai_stats_api_v1_ai_stats_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
components:
schemas:
NewDomainRecommendation:
properties:
domain:
type: string
title: Domain
similarity_score:
type: number
title: Similarity Score
best_source_domain:
type: string
title: Best Source Domain
sample_rankings:
items:
additionalProperties:
type: string
type: object
type: array
title: Sample Rankings
reason:
type: string
title: Reason
type: object
required:
- domain
- similarity_score
- best_source_domain
- sample_rankings
- reason
title: NewDomainRecommendation
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
TransferPredictionResponse:
properties:
entity_id:
type: string
title: Entity Id
entity_name:
type: string
title: Entity Name
predicted_score:
type: number
title: Predicted Score
confidence:
type: number
title: Confidence
source_domains:
items:
type: string
type: array
title: Source Domains
reasoning:
type: string
title: Reasoning
type: object
required:
- entity_id
- entity_name
- predicted_score
- confidence
- source_domains
- reasoning
title: TransferPredictionResponse
SimilarEntityResponse:
properties:
entity_id:
type: string
title: Entity Id
entity_name:
type: string
title: Entity Name
ranking_id:
type: string
title: Ranking Id
similarity:
type: number
title: Similarity
type: object
required:
- entity_id
- entity_name
- ranking_id
- similarity
title: SimilarEntityResponse
EmbeddingStatsResponse:
properties:
users_with_embeddings:
type: integer
title: Users With Embeddings
entities_with_embeddings:
type: integer
title: Entities With Embeddings
embedding_dimensions:
type: integer
title: Embedding Dimensions
last_trained:
anyOf:
- type: string
- type: 'null'
title: Last Trained
status:
type: string
title: Status
type: object
required:
- users_with_embeddings
- entities_with_embeddings
- embedding_dimensions
- last_trained
- status
title: EmbeddingStatsResponse
api__routes__ai__PreferencePredictionResponse:
properties:
predicted_winner_id:
type: string
title: Predicted Winner Id
confidence:
type: number
title: Confidence
reasoning:
type: string
title: Reasoning
source_domains:
items:
type: string
type: array
title: Source Domains
transfer_quality:
type: string
title: Transfer Quality
type: object
required:
- predicted_winner_id
- confidence
- reasoning
- source_domains
- transfer_quality
title: PreferencePredictionResponse
RankingAlgorithmSettings:
properties:
algorithm:
type: string
title: Algorithm
description: 'Rating algorithm: elo, glicko2, bradley_terry'
default: glicko2
domain:
type: string
title: Domain
description: Domain hint for multipliers
default: custom
decisive_win_multiplier:
type: number
maximum: 2.0
minimum: 1.0
title: Decisive Win Multiplier
default: 1.2
upset_bonus:
type: number
maximum: 2.0
minimum: 1.0
title: Upset Bonus
default: 1.15
decay_rate:
type: number
maximum: 0.1
minimum: 0.0
title: Decay Rate
default: 0.02
decay_threshold_days:
type: integer
maximum: 365.0
minimum: 0.0
title: Decay Threshold Days
default: 90
algorithm_config:
additionalProperties: true
type: object
title: Algorithm Config
type: object
title: RankingAlgorithmSettings
api__routes__ai__AlgorithmInfo:
properties:
name:
type: string
title: Name
display_name:
type: string
title: Display Name
description:
type: string
title: Description
best_for:
items:
type: string
type: array
title: Best For
supports_uncertainty:
type: boolean
title: Supports Uncertainty
supports_volatility:
type: boolean
title: Supports Volatility
supports_draws:
type: boolean
title: Supports Draws
config:
additionalProperties: true
type: object
title: Config
type: object
required:
- name
- display_name
- description
- best_for
- supports_uncertainty
- supports_volatility
- supports_draws
- config
title: AlgorithmInfo
api__routes__ai__AlgorithmRecommendation:
properties:
recommended:
type: string
title: Recommended
reason:
type: string
title: Reason
alternatives:
items:
additionalProperties: true
type: object
type: array
title: Alternatives
type: object
required:
- recommended
- reason
- alternatives
title: AlgorithmRecommendation
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
DomainProfileResponse:
properties:
domain:
type: string
title: Domain
ranking_ids:
items:
type: string
type: array
title: Ranking Ids
total_votes:
type: integer
title: Total Votes
confidence:
type: number
title: Confidence
top_entities:
items:
additionalProperties: true
type: object
type: array
title: Top Entities
type: object
required:
- domain
- ranking_ids
- total_votes
- confidence
- top_entities
title: DomainProfileResponse
api__routes__ai__SimilarUserResponse:
properties:
user_id:
type: string
title: User Id
similarity:
type: number
title: Similarity
type: object
required:
- user_id
- similarity
title: SimilarUserResponse
TrainEmbeddingsResponse:
properties:
status:
type: string
title: Status
users:
type: integer
title: Users
entities:
type: integer
title: Entities
components:
type: integer
title: Components
message:
type: string
title: Message
type: object
required:
- status
- users
- entities
- components
- message
title: TrainEmbeddingsResponse
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key