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

# CC-BY 4.0 reviews dataset

`GET /data/reviews.json`

## Request

- Base URL: `https://aicoolies.com`
- URL: `https://aicoolies.com/data/reviews.json`
- Auth: none required

Published aicoolies editorial reviews with 0–100 scores for overall, speed, privacy, and developer experience. 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.

## Response `200`

Reviews envelope

- ReviewsDataset
  - `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
  - `reviews` DatasetReview[], required
    - `slug` string, required
    - `title` string, required
    - `url` string, uri, required
    - `tool_slug` string, nullable
    - `score_overall` integer, nullable: 0–100 aicoolies Score v1.
    - `score_speed` integer, nullable
    - `score_privacy` integer, nullable
    - `score_dev_experience` integer, nullable
    - `summary` string, nullable
    - `verdict` string, nullable
    - `evidence_status` 'not-evidenced' | 'partial' | 'verified' | 'null', nullable
    - `evidence_badge` 'verified' | 'documented' | 'partial' | 'not-evidenced' | 'unclassified': Resolved public evidence label. tested_at, tested_version, and test_environment are null when this is documented.
    - `rubric_version` string, nullable
    - `tested_at` string, date-time, nullable: Hands-on test date. Null when evidence_badge is documented.
    - `tested_version` string, nullable: Tested product version or dated SaaS state. Null when evidence_badge is documented.
    - `test_environment` string, nullable: Reproducibility context for a hands-on record. Null when evidence_badge is documented.
    - `test_artifact_url` string, uri, 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)