AimRank Exports API
The Exports API from AimRank — 6 operation(s) for exports.
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-exports-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 Exports 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: Exports
paths:
/api/v1/exports/stats:
get:
tags:
- Exports
summary: Get Export Stats
description: 'Get statistics about available RLHF export data.
Returns counts, model-prediction coverage rates, and estimated value.'
operationId: get_export_stats_api_v1_exports_stats_get
parameters:
- name: domains
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Comma-separated domains
title: Domains
description: Comma-separated domains
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExportStats'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/exports/rlhf:
post:
tags:
- Exports
summary: Create Rlhf Export
description: 'Create an RLHF dataset export.
Supports multiple formats:
- `anthropic_hh`: Anthropic Human-Harmlessness format
- `openai_rm`: OpenAI Reward Model format
- `dpo`: Direct Preference Optimization format
- `aimrank_full`: Full AimRank format with all metadata
For large exports, returns an export_id to check status.
For small exports (<1000), returns data directly.'
operationId: create_rlhf_export_api_v1_exports_rlhf_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ExportRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExportResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/exports/formats:
get:
tags:
- Exports
summary: Get Export Formats
description: Get available RLHF export formats with descriptions.
operationId: get_export_formats_api_v1_exports_formats_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/api/v1/exports/domains:
get:
tags:
- Exports
summary: Get Available Domains
description: 'Get available domains with sample counts.
Filters out domains that are currently under an anchor-buyer
exclusivity window (per LOI §1.4) — except for the domain owner,
who always sees their own listings.'
operationId: get_available_domains_api_v1_exports_domains_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/api/v1/exports/sample/{domain}:
get:
tags:
- Exports
summary: Get Sample Data
description: 'Get anonymized sample RLHF data for a domain (public, no auth required).
Returns up to 10 sample preference records for data quality preview.
Voter IDs and entity IDs are anonymized.
Returns 403 if the domain is currently under an anchor-buyer
exclusivity window (per LOI §1.4) and the requester is not the owner.'
operationId: get_sample_data_api_v1_exports_sample__domain__get
parameters:
- name: domain
in: path
required: true
schema:
type: string
title: Domain
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/exports/rlhf/{ranking_id}.jsonl:
get:
tags:
- Exports
summary: Stream RLHF preference data as newline-delimited JSON
description: 'Stream a ranking''s preference data as JSONL (one record per line).
Drop-in compatible with `datasets.load_dataset("json", data_files=URL)`
and `trl`''s preference dataset loaders. Owner-only.
Format options match POST /exports/rlhf:
- `dpo` — DPO chosen/rejected pair format
- `anthropic_hh` — Anthropic Helpful-Harmless format
- `openai_rm` — OpenAI Reward Model format
- `aimrank_full` — full metadata (rating before/after, voter segment,
decision time)
Auth: API key OR JWT, Pro plan or higher, and must own the ranking.'
operationId: stream_rlhf_jsonl_api_v1_exports_rlhf__ranking_id__jsonl_get
security:
- APIKeyHeader: []
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
- name: format
in: query
required: false
schema:
$ref: '#/components/schemas/ExportFormatEnum'
default: dpo
- name: min_confidence
in: query
required: false
schema:
type: number
default: 0.0
title: Min Confidence
- name: include_llm_votes
in: query
required: false
schema:
type: boolean
default: false
title: Include Llm Votes
responses:
'200':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ExportStats:
properties:
total_samples:
type: integer
title: Total Samples
with_model_prediction:
type: integer
title: With Model Prediction
model_prediction_rate:
type: number
title: Model Prediction Rate
average_confidence:
type: number
title: Average Confidence
domains:
additionalProperties: true
type: object
title: Domains
estimated_value:
additionalProperties: true
type: object
title: Estimated Value
type: object
required:
- total_samples
- with_model_prediction
- model_prediction_rate
- average_confidence
- domains
- estimated_value
title: ExportStats
description: Statistics about available export data.
ExportFormatEnum:
type: string
enum:
- anthropic_hh
- openai_rm
- dpo
- aimrank_full
title: ExportFormatEnum
ExportFilters:
properties:
min_voter_accuracy:
type: number
maximum: 1.0
minimum: 0.0
title: Min Voter Accuracy
default: 0.0
min_confidence:
type: number
maximum: 1.0
minimum: 0.0
title: Min Confidence
default: 0.0
require_model_prediction_data:
type: boolean
title: Require Model Prediction Data
default: false
min_votes_per_voter:
type: integer
minimum: 0.0
title: Min Votes Per Voter
default: 0
type: object
title: ExportFilters
description: Filters for RLHF export.
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
ExportResponse:
properties:
export_id:
type: string
title: Export Id
status:
type: string
title: Status
format:
type: string
title: Format
sample_count:
type: integer
title: Sample Count
data:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
title: Data
download_url:
anyOf:
- type: string
- type: 'null'
title: Download Url
alignment_scaffolds:
anyOf:
- additionalProperties:
additionalProperties: true
type: object
type: object
- type: 'null'
title: Alignment Scaffolds
type: object
required:
- export_id
- status
- format
- sample_count
title: ExportResponse
description: Response for export request.
ExportRequest:
properties:
format:
$ref: '#/components/schemas/ExportFormatEnum'
default: aimrank_full
domains:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Domains
categories:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Categories
date_start:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Date Start
date_end:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Date End
filters:
anyOf:
- $ref: '#/components/schemas/ExportFilters'
- type: 'null'
include_voter_metadata:
type: boolean
title: Include Voter Metadata
default: true
include_entity_data:
type: boolean
title: Include Entity Data
default: true
include_outcomes:
type: boolean
title: Include Outcomes
default: true
sample_size:
anyOf:
- type: integer
maximum: 100000.0
- type: 'null'
title: Sample Size
include_llm_votes:
type: boolean
title: Include Llm Votes
default: false
type: object
title: ExportRequest
description: Request body for RLHF export.
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key