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, EQ, effective cost, 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.

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.
eq	Rounded Composite EQ, or `null` when coverage is insufficient.
effectiveCost	Effective cost in USD per 1M I/O tokens, or `null`.
updatedAt	ISO timestamp derived from the newest model or benchmark data file.
url	Canonical public AI IQ model profile URL.

{
  "id": "gpt-5.5",
  "name": "gpt-5.5",
  "provider": "OpenAI",
  "rank": 1,
  "iq": 135,
  "eq": 125,
  "effectiveCost": 38.0483,
  "updatedAt": "2026-05-22T16:14:09.343Z",
  "url": "https://aiiq.org/models/gpt-5.5/"
}

Benchmarks

GET /api/benchmarks returns metadata for source-backed benchmark fields. 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	Public benchmark category, such as `iq`, `eq`, `cost`, or `benchmark`.
updatedAt	ISO timestamp derived from the newest model or benchmark data file.
url	Public chart or chart-gallery URL associated with the benchmark metadata.

{
  "id": "aa-cost-per-task",
  "name": "AA Cost per Task",
  "description": "",
  "category": "cost",
  "updatedAt": "2026-05-22T16:14:09.343Z",
  "url": "https://aiiq.org/charts/"
}

Model Detail

GET /api/models/:id returns a single public model summary plus benchmark results and the methodology version used for derived fields.

{
  "id": "gpt-5.5",
  "name": "gpt-5.5",
  "provider": "OpenAI",
  "rank": 1,
  "iq": 135,
  "eq": 125,
  "effectiveCost": 38.0483,
  "benchmarkResults": {
    "aa-cost-per-task": {
      "value": 3357,
      "field": "aaCost",
      "name": "AA Cost per Task",
      "category": "cost"
    }
  },
  "methodologyVersion": "2026-05-22-programmatic-coverage",
  "updatedAt": "2026-05-22T16:14:09.343Z",
  "url": "https://aiiq.org/models/gpt-5.5/"
}

Rankings

GET /api/rankings returns derived rankings and source-backed benchmark rankings in one list. Use rankingType to distinguish derived rankings from benchmark rankings. Composite IQ and Composite EQ are higher-is-better; Effective Cost is lower-is-better.

Field	Description
id	Stable ranking identifier.
rankingName	Human-readable ranking name.
rankingType	`derived` for Composite IQ, Composite EQ, and Effective Cost; `benchmark` for source-backed benchmark rankings.
methodologyVersion	Present on derived rankings.
field	Source data field for benchmark rankings.
category	Benchmark category for benchmark rankings.
direction	`higher_is_better` or `lower_is_better`.
unit	Present when the ranking has an explicit unit.
models	Ranked model rows with score and rank. Benchmark ranking rows also include model profile URLs.

[
  {
    "id": "composite-iq",
    "rankingName": "Composite IQ",
    "rankingType": "derived",
    "methodologyVersion": "2026-05-22-programmatic-coverage",
    "direction": "higher_is_better",
    "models": [
      {
        "id": "gpt-5.5",
        "name": "gpt-5.5",
        "provider": "OpenAI",
        "rank": 1,
        "score": 135
      }
    ]
  },
  {
    "id": "effective-cost",
    "rankingName": "Effective Cost",
    "rankingType": "derived",
    "methodologyVersion": "2026-05-22-programmatic-coverage",
    "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": "aime",
    "rankingName": "AIME",
    "rankingType": "benchmark",
    "field": "aime",
    "category": "iq",
    "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 three derived rankings. For the full scoring explanation, use the Methodology page.

{
  "version": "2026-05-22-programmatic-coverage",
  "summary": "Composite IQ and EQ scores are derived from public benchmark results...",
  "derivedRankings": [
    {
      "id": "composite-iq",
      "rankingName": "Composite IQ",
      "direction": "higher_is_better",
      "scoreField": "iq",
      "dimensions": [
        {
          "id": "D1",
          "name": "Fluid Abstraction",
          "minBenchmarks": 1,
          "benchmarks": [
            { "field": "arcAgi2", "name": "ARC-AGI-2" },
            { "field": "arcAgi1", "name": "ARC-AGI-1" }
          ]
        }
      ]
    },
    {
      "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-05-22T16:14:09.343Z",
  "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.