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.
openapi: 3.2.0
info:
title: AimRank Leads 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: Leads
paths:
/api/v1/leads:
post:
tags:
- Leads
summary: Create Lead
description: 'Register interest in a capability that isn''t on sale yet.
Public and unauthenticated on purpose: the most valuable leads are visitors
who never made an account, and asking them to sign up first defeats the
point of asking at all.
Idempotent per (email, interest) so double-clicking, or asking twice from
two different walls, doesn''t duplicate the row -- but a second submission
still refreshes the note, since that''s usually where the useful detail is.'
operationId: create_lead_api_v1_leads_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/LeadCreate'
required: true
responses:
'201':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
LeadCreate:
properties:
email:
type: string
maxLength: 255
title: Email
interest:
type: string
maxLength: 64
title: Interest
default: pricing
source:
anyOf:
- type: string
maxLength: 64
- type: 'null'
title: Source
note:
anyOf:
- type: string
maxLength: 1000
- type: 'null'
title: Note
type: object
required:
- email
title: LeadCreate
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
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
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key