---
title: "CC-BY 4.0 comparisons dataset"
method: GET
path: "/api/v1/data/comparisons.json"
tags: ["Datasets"]
---

# CC-BY 4.0 comparisons dataset

`GET /api/v1/data/comparisons.json`

## Request

- Base URL: `https://aicoolies.com`
- URL: `https://aicoolies.com/api/v1/data/comparisons.json`
- Auth: none required

Published aicoolies comparisons as JSON with tool slugs, content update, source check, and editorial verification dates. The deprecated as_of alias remains for v1 readers. Licensed CC-BY 4.0. Supports conditional GET via If-None-Match. CORS is * for GET and OPTIONS. Responses carry RateLimit headers so a client can self-throttle. Version-pinned alias of /data/comparisons.json; both paths run the same handler. Versioning and deprecation policy: https://aicoolies.com/developers#versioning.

## Response `200`

Comparisons envelope

- ComparisonsDataset
  - `schema_version` integer, required
  - `license` 'CC-BY-4.0', required
  - `license_url` string, uri
  - `attribution` string
  - `attribution_url` string, uri
  - `base_url` string, uri
  - `generated_at` string, date-time
  - `count` integer, required
  - `comparisons` DatasetComparison[], required
    - `slug` string, required
    - `title` string, required
    - `url` string, uri, required
    - `tool_slugs` string[]
    - `intro` string, nullable
    - `verdict` string, nullable
    - `winner_tool_slug` string, nullable
    - `sources` PublicSource[]
      - `label` string, required
      - `url` string, uri, required
    - `published_at` string, date-time, nullable
    - `content_updated_at` string, date-time, required: Editorial content timestamp (contentModifiedAt). When unset, publishedAt, then createdAt, then CMS updatedAt.
    - `verified_at` string, date-time, nullable
    - `source_checked_at` string, date-time, nullable
    - `as_of` string, date-time, required: Deprecated v1 alias of content_updated_at.

## Other responses

- `304`: Not modified — the ETag sent in If-None-Match still matches.
- `429`: Rate limit exceeded. Retry-After carries the wait in seconds.
- `500`: Server error

---

[API](https://skmtc.dev/aicoolies/apis/aicoolies-public-api.md) · [All operations](https://skmtc.dev/aicoolies/apis/aicoolies-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aicoolies/apis/aicoolies-public-api/revisions/8d666d0ed7aa?raw)