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

# CC-BY 4.0 tools dataset

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

## Request

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

Full aicoolies tool catalog as JSON. Licensed CC-BY 4.0, attribution aicoolies.com. The community namespace contains anonymous public aggregates that never alter editorial Score or verdicts. content_updated_at and verified_at have distinct semantics; as_of remains a deprecated v1 alias of content_updated_at. 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/tools.json; both paths run the same handler. Versioning and deprecation policy: https://aicoolies.com/developers#versioning.

## Response `200`

Tools envelope

- ToolsDataset
  - `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
  - `tools` DatasetTool[], required
    - `slug` string, required
    - `name` string, required
    - `url` string, uri, required
    - `status` 'active' | 'graveyard', required
    - `tagline` string, nullable
    - `short_description` string, nullable
    - `official_url` string, uri, nullable
    - `categories` string[]
    - `tags` string[]
    - `use_cases` string[]
    - `alternative_slugs` string[]
    - `is_open_source` boolean
    - `license` 'open-source' | 'source-available' | 'proprietary': License category. Empty CMS license follows the open-source checkbox: checked is open-source, unchecked is proprietary.
    - `is_recommended` boolean
    - `pricing_model` string, nullable
    - `pricing_summary` string, nullable
    - `pricing_plans` PublicPricingPlan[]
      - `name` string, required
      - `amount` number, nullable, required
      - `currency` string, nullable, required
      - `billing_period` string, required
      - `unit` string, nullable, required
      - `limits` string, nullable, required
      - `is_starting_plan` boolean, required
      - `source_url` string, uri, required
      - `source_checked_at` string, date-time, required
    - `sources` PublicSource[]
      - `label` string, required
      - `url` string, uri, required
    - `community` DatasetToolCommunity, required: Anonymous public Community aggregates. These values are separate from editorial Score, verdicts, and catalog fields.
      - `upvotes` integer, required: Upvotes excluding the current verified maker's own vote.
      - `rating_avg` number, nullable, required: Mean published rating rounded to two decimals; null when rating_count is 0.
      - `rating_count` integer, required: Published ratings excluding the current verified maker's own rating.
      - `stacked_by` integer, required: Public consenting profiles that stack this tool.
      - `co_stacked_with` string[], required: Tool slugs sharing at least three distinct public stack profiles.
      - `open_rooms` integer, required: Visible tool rooms whose state is open.
      - `verified_runs` integer, required: Independent verified runs summed only from active task/version cohorts with at least three runs. Below-threshold cohorts publish as zero.
    - `content_updated_at` string, date-time, required: Editorial content timestamp (contentModifiedAt). Falls back to the CMS updatedAt when that stamp is unset.
    - `verified_at` string, date-time, nullable
    - `source_checked_at` string, date-time, nullable: Most recent date when all cited primary sources were rechecked.
    - `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)
