API

AI IQ publishes a small JSON API for public model, benchmark, ranking, chart, and methodology metadata. The API is designed for simple read-only integrations and returns sanitized public fields only.

The canonical base URL is https://aiiq.org. All endpoints return JSON.

Endpoints

GET /api/models

Public model summaries with rank, IQ, per-dimension IQ scores, cost block, update timestamp, and canonical URL.

GET /api/models/:id

Detailed public data for one model, including source-backed benchmark results.

GET /api/benchmarks

Benchmark metadata with stable IDs, names, categories, update timestamp, and public URL.

GET /api/rankings

Derived rankings and per-benchmark rankings with score, rank, direction, provider, and model profile URL.

GET /api/charts

Canonical chart metadata, related benchmarks, and tags.

GET /api/methodology

Public methodology metadata with version, derived ranking hierarchy, timestamp, and URL.

curl https://aiiq.org/api/models
curl https://aiiq.org/api/models/gpt-5.5
curl https://aiiq.org/api/benchmarks
curl https://aiiq.org/api/rankings
curl https://aiiq.org/api/charts
curl https://aiiq.org/api/methodology

Models

GET /api/models returns a list of public model summaries. Every response is wrapped in an envelope with apiVersion, methodologyVersion, updatedAt, and a models array.

Field	Description
id	Stable model identifier, matching the model name slug used by AI IQ.
name	Human-readable model name.
provider	Public provider grouping used in charts.
rank	Current Composite IQ rank when the model has a derived IQ.
iq	Rounded Composite IQ, or `null` when the model is not ranked.
dimensions	Compact map from dimension slug to rounded dimension IQ score. Seven entries: `abstract-reasoning`, `mathematical-reasoning`, `scientific-reasoning`, `software-engineering`, `computer-use`, `reliability`, `social-reasoning`. Each value is `null` when the dimension cannot be computed for that model.
cost	Cost block: `inputPer1M`, `outputPer1M`, `ioPer1M`, `usageMultiplier`, `effectivePer1M`, `unit` ("USD per 1M tokens"). `null` when pricing is unavailable.
updatedAt	ISO timestamp derived from the newest model or benchmark data file.
url	Canonical public AI IQ model profile URL.

{
  "apiVersion": "1",
  "methodologyVersion": "2026-06-04-designarena-fullstack",
  "updatedAt": "2026-06-04T15:23:16.657Z",
  "models": [
    {
      "id": "gpt-5.5",
      "name": "gpt-5.5",
      "provider": "OpenAI",
      "rank": 1,
      "iq": 132,
      "dimensions": {
        "abstract-reasoning": 118,
        "mathematical-reasoning": 141,
        "scientific-reasoning": 139,
        "software-engineering": 136,
        "computer-use": 137,
        "reliability": 126,
        "social-reasoning": 126
      },
      "cost": {
        "inputPer1M": 5,
        "outputPer1M": 30,
        "ioPer1M": 35,
        "usageMultiplier": 1.042,
        "effectivePer1M": 36.4848,
        "unit": "USD per 1M tokens"
      },
      "updatedAt": "2026-06-04T15:23:16.657Z",
      "url": "https://aiiq.org/models/gpt-5.5/"
    }
  ]
}

Benchmarks

GET /api/benchmarks returns metadata for benchmarks incorporated into the seven IQ dimensions. Benchmark scores and rankings are exposed through GET /api/rankings.

Field	Description
id	Stable benchmark identifier used in benchmark results and rankings.
name	Human-readable benchmark name.
description	Plain-text description when available.
category	Benchmark category: `iq` for most benchmarks, `eq` for social-reasoning benchmarks (Arena Elo, AttuneBench Composite, EQ-Bench 3 Elo).
dimension	The dimension slug this benchmark contributes to (e.g. `abstract-reasoning`, `social-reasoning`).
direction	`higher_is_better` or `lower_is_better`.
unit	Unit string when available (e.g. `percent`, `Elo`), or `null`.
updatedAt	ISO timestamp derived from the newest model or benchmark data file.
url	Public chart or chart-gallery URL associated with the benchmark.

{
  "apiVersion": "1",
  "methodologyVersion": "2026-06-04-designarena-fullstack",
  "updatedAt": "2026-06-04T15:23:16.657Z",
  "benchmarks": [
    {
      "id": "arc-agi-2",
      "name": "ARC-AGI-2",
      "description": "",
      "category": "iq",
      "dimension": "abstract-reasoning",
      "direction": "higher_is_better",
      "unit": "percent",
      "updatedAt": "2026-06-04T15:23:16.657Z",
      "url": "https://aiiq.org/charts/"
    }
  ]
}

Model Detail

GET /api/models/:id returns a single public model with the full dimensions block, cost block, all benchmark results, and the methodology version. The envelope is the same as other endpoints (apiVersion, methodologyVersion, updatedAt) with model fields at the top level.

The dimensions block here is the full form (vs. the compact slug→iq map on /api/models): each entry includes iq, benchmarksCovered, benchmarksTotal, and imputed. Each benchmarkResults entry includes dimension and direction in addition to value, field, name, and category.

{
  "apiVersion": "1",
  "methodologyVersion": "2026-06-04-designarena-fullstack",
  "updatedAt": "2026-06-04T15:23:16.657Z",
  "id": "gpt-5.5",
  "name": "gpt-5.5",
  "provider": "OpenAI",
  "rank": 1,
  "iq": 132,
  "dimensions": {
    "abstract-reasoning": {
      "iq": 118,
      "benchmarksCovered": 3,
      "benchmarksTotal": 3,
      "imputed": false
    },
    "mathematical-reasoning": {
      "iq": 141,
      "benchmarksCovered": 4,
      "benchmarksTotal": 5,
      "imputed": false
    },
    "social-reasoning": {
      "iq": 126,
      "benchmarksCovered": 3,
      "benchmarksTotal": 3,
      "imputed": false
    }
  },
  "cost": {
    "inputPer1M": 5,
    "outputPer1M": 30,
    "ioPer1M": 35,
    "usageMultiplier": 1.042,
    "effectivePer1M": 36.4848,
    "unit": "USD per 1M tokens"
  },
  "url": "https://aiiq.org/models/gpt-5.5/",
  "benchmarkResults": {
    "arc-agi-2": {
      "value": 85,
      "field": "arcAgi2",
      "name": "ARC-AGI-2",
      "category": "iq",
      "dimension": "abstract-reasoning",
      "direction": "higher_is_better"
    },
    "eq-bench-3-elo": {
      "value": 1596.5,
      "field": "eqBenchElo",
      "name": "EQ-Bench 3 Elo",
      "category": "eq",
      "dimension": "social-reasoning",
      "direction": "higher_is_better"
    }
  }
}

Rankings

GET /api/rankings returns all rankings in one list. Use rankingType to distinguish types. The order is: composite-iq (derived), effective-cost (derived), seven dimension IQ rankings (type dimension, ids abstract-reasoning-iq through social-reasoning-iq), then per-benchmark rankings (type benchmark). Composite IQ is higher-is-better; Effective Cost is lower-is-better. The Composite EQ ranking was retired — Social Reasoning is now the seventh IQ dimension (social-reasoning-iq).

Field	Description
id	Stable ranking identifier. Dimension rankings use the pattern `<slug>-iq`.
rankingName	Human-readable ranking name.
rankingType	`derived` for Composite IQ and Effective Cost; `dimension` for per-dimension IQ rankings; `benchmark` for source-backed benchmark rankings.
dimension	Dimension slug — present on `dimension` and `benchmark` rankings.
field	Source data field, present on `benchmark` rankings.
category	Benchmark category (e.g. `iq`, `eq`, `cost`), present on `benchmark` rankings.
methodologyVersion	Present on `derived` and `dimension` rankings.
direction	`higher_is_better` or `lower_is_better`.
unit	Present when the ranking has an explicit unit.
models	Ranked model rows with `id`, `name`, `provider`, `rank`, `score`. Dimension rankings also include `imputed`. Benchmark rankings also include `url`.

{
  "apiVersion": "1",
  "methodologyVersion": "2026-06-04-designarena-fullstack",
  "updatedAt": "2026-06-04T15:23:16.657Z",
  "rankings": [
    {
      "id": "composite-iq",
      "rankingName": "Composite IQ",
      "rankingType": "derived",
      "methodologyVersion": "2026-06-04-designarena-fullstack",
      "direction": "higher_is_better",
      "models": [
        { "id": "gpt-5.5", "name": "gpt-5.5", "provider": "OpenAI", "rank": 1, "score": 132 }
      ]
    },
    {
      "id": "effective-cost",
      "rankingName": "Effective Cost",
      "rankingType": "derived",
      "methodologyVersion": "2026-06-04-designarena-fullstack",
      "direction": "lower_is_better",
      "unit": "USD per 1M I/O Tokens",
      "models": [
        { "id": "gpt-oss-20b", "name": "gpt-oss-20b", "provider": "OpenAI", "rank": 1, "score": 0.2056 }
      ]
    },
    {
      "id": "abstract-reasoning-iq",
      "rankingName": "Abstract Reasoning IQ",
      "rankingType": "dimension",
      "dimension": "abstract-reasoning",
      "methodologyVersion": "2026-06-04-designarena-fullstack",
      "direction": "higher_is_better",
      "models": [
        { "id": "gpt-5.5", "name": "gpt-5.5", "provider": "OpenAI", "rank": 1, "score": 118, "imputed": false }
      ]
    },
    {
      "id": "social-reasoning-iq",
      "rankingName": "Social Reasoning IQ",
      "rankingType": "dimension",
      "dimension": "social-reasoning",
      "methodologyVersion": "2026-06-04-designarena-fullstack",
      "direction": "higher_is_better",
      "models": [
        { "id": "gpt-5.5", "name": "gpt-5.5", "provider": "OpenAI", "rank": 1, "score": 126, "imputed": false }
      ]
    },
    {
      "id": "aime",
      "rankingName": "AIME",
      "rankingType": "benchmark",
      "field": "aime",
      "category": "iq",
      "dimension": "mathematical-reasoning",
      "direction": "higher_is_better",
      "models": [
        { "id": "gemini-3.1-pro", "name": "gemini-3.1-pro", "provider": "Google", "rank": 1, "score": 98.125, "url": "https://aiiq.org/models/gemini-3.1-pro/" }
      ]
    }
  ]
}

Charts

GET /api/charts returns promoted canonical chart metadata. Chart URLs are stable share pages, not rendered SVG exports. More / Experimental charts are excluded.

Field	Description
id	Stable chart slug.
title	Public chart title.
description	Plain-text chart description.
url	Canonical chart page URL.
relatedBenchmarks	Benchmark IDs used by the chart, when applicable.
tags	Category and chart-kind tags.

Methodology

GET /api/methodology exposes public methodology metadata and the hierarchy behind the two derived rankings (Composite IQ and Effective Cost). For the full scoring explanation, use the Methodology page.

The Composite EQ standalone ranking was retired. Social Reasoning is now the seventh IQ dimension (D7, slug social-reasoning) within Composite IQ. The summary field documents this history.

Each dimension in the Composite IQ derivedRankings entry carries a slug field (e.g. abstract-reasoning) that matches the dimension slugs used in model detail and dimension rankings. D7 also includes a note field explaining the EQ retirement.

{
  "apiVersion": "1",
  "version": "2026-06-04-designarena-fullstack",
  "summary": "Composite IQ uses public benchmark results mapped through IQ 70-160 expected-score ladders, conservative imputation rules, and chart display policies documented on the methodology page. Effective Cost uses its own documented source-backed derivation. Social Reasoning is the seventh IQ dimension and is the capability historically surfaced as a standalone Composite EQ score.",
  "derivedRankings": [
    {
      "id": "composite-iq",
      "rankingName": "Composite IQ",
      "direction": "higher_is_better",
      "scoreField": "iq",
      "dimensions": [
        {
          "id": "D1",
          "slug": "abstract-reasoning",
          "name": "Abstract Reasoning",
          "minBenchmarks": 1,
          "benchmarks": [
            { "field": "arcAgi2", "name": "ARC-AGI-2" },
            { "field": "arcAgi1", "name": "ARC-AGI-1" },
            { "field": "arcAgi3", "name": "ARC-AGI-3" }
          ]
        },
        {
          "id": "D7",
          "slug": "social-reasoning",
          "name": "Social Reasoning",
          "note": "Historically surfaced as Composite EQ; identical capability, expressed as the seventh IQ dimension.",
          "minBenchmarks": 2,
          "benchmarks": [
            { "field": "eqBenchSocialIQ", "name": "eqBenchSocialIQ" },
            { "field": "arenaSocialIQ", "name": "arenaSocialIQ" },
            { "field": "attuneSocialIQ", "name": "attuneSocialIQ" }
          ]
        }
      ]
    },
    {
      "id": "effective-cost",
      "rankingName": "Effective Cost",
      "direction": "lower_is_better",
      "scoreField": "effectiveCost",
      "unit": "USD per 1M I/O Tokens",
      "breakdown": [
        {
          "id": "published-pricing",
          "name": "Published Token Pricing",
          "inputs": [
            { "field": "inP", "name": "Input token price" },
            { "field": "outP", "name": "Output token price" }
          ]
        }
      ]
    }
  ],
  "updatedAt": "2026-06-04T15:23:16.657Z",
  "url": "https://aiiq.org/methodology/"
}

Privacy Boundary

The public API exposes only sanitized public data intended for read-only integrations. It omits private configuration, unpublished records, internal review metadata, and operational tooling details.

API