{
  "schemaVersion": "1.0",
  "generatedAt": "2026-09-05T05:04:06.307Z",
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "methodology": "https://harpd.com/rank/methodology/",
  "envelope": {
    "schemaVersion": "Version of the dataset schema. Field names are stable; breaking changes bump the version.",
    "generatedAt": "ISO-8601 timestamp of when the response was serialized.",
    "lastUpdated": "ISO-8601 timestamp of the most recent record-level data change in this collection. Moves only when a record actually changes, never on rebuild alone.",
    "source": "Always \"Harpd Rank\".",
    "methodology": "URL of the Harpd Rank methodology page.",
    "license": "The dataset is published under CC BY 4.0.",
    "count": "Number of records in the collection."
  },
  "excluded": "Never included: user accounts or contact details, billing or processor identifiers, credential or secret material, internal review notes, private account fields, or any unapproved/hidden listing.",
  "endpoints": [
    {
      "endpoint": "rank.json",
      "record": "rank record",
      "fields": {
        "id": "Stable record identifier. Equal to the slug.",
        "name": "Product display name.",
        "slug": "Stable URL slug used in profile URLs.",
        "url": "Canonical Harpd product profile URL.",
        "category": "Harpd Rank category slug.",
        "categoryName": "Display name of the category.",
        "rank": "Current position on the overall board.",
        "rankPoints": "Current Harpd Rank Points (1 completed Credit = 1 permanent Rank Point).",
        "verified": "True when Harpd has verified the product listing.",
        "updatedAt": "Last public update timestamp for the record."
      }
    },
    {
      "endpoint": "products.json",
      "record": "rank record + profile fields",
      "fields": {
        "website": "The maker's own public website.",
        "description": "The maker-provided public product description.",
        "productType": "Public product type label, when provided."
      }
    },
    {
      "endpoint": "categories.json",
      "record": "category record",
      "fields": {
        "slug": "Category slug.",
        "name": "Category display name.",
        "description": "Public category description.",
        "url": "Canonical category board URL.",
        "productCount": "Number of approved products in the category."
      }
    },
    {
      "endpoint": "rank-history.json",
      "record": "history period record",
      "fields": {
        "periodType": "\"monthly\" or \"weekly\".",
        "periodKey": "Period identifier (YYYY-MM or YYYY-Www).",
        "startsAt": "Period start (ISO-8601).",
        "endsAt": "Period end (ISO-8601).",
        "productCount": "Products recorded in the closed-period snapshot.",
        "url": "Canonical Harpd history page URL."
      }
    },
    {
      "endpoint": "rank.csv",
      "record": "rank record (tabular)",
      "fields": {
        "columns": "id,rank,name,slug,profile_url,category,category_name,rank_points,verified,updated_at"
      }
    }
  ]
}