{
 "profile": "tabular-data-package",
 "name": "magellan-longevity-open-evidence-dataset",
 "title": "Magellan Longevity Open Evidence Dataset",
 "description": "Evidence grades for 130 longevity products and 2692 linked study-level records (2646 distinct PMIDs), published under CC BY 4.0.",
 "version": "1.0.0",
 "created": "2026-08-11",
 "homepage": "https://magellanlongevity.com/data/",
 "licenses": [
  {
   "name": "CC-BY-4.0",
   "title": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
   "path": "https://creativecommons.org/licenses/by/4.0/"
  }
 ],
 "contributors": [
  {
   "title": "Gabriel Radu, DO",
   "role": "author",
   "organization": "Magellan Longevity"
  }
 ],
 "keywords": [
  "longevity",
  "healthspan",
  "supplements",
  "evidence grading",
  "PubMed",
  "geroscience",
  "open data"
 ],
 "resources": [
  {
   "name": "products",
   "path": "products.csv",
   "format": "csv",
   "mediatype": "text/csv",
   "encoding": "utf-8",
   "profile": "tabular-data-resource",
   "schema": {
    "fields": [
     {
      "name": "product_id",
      "type": "integer",
      "description": "Stable catalogue identifier. Resolves to https://magellanlongevity.com/p/<product_id>.html"
     },
     {
      "name": "product_name",
      "type": "string",
      "description": "Retail product name as listed on the site."
     },
     {
      "name": "category_id",
      "type": "integer",
      "description": "Storefront category (1–7)."
     },
     {
      "name": "category_name",
      "type": "string",
      "description": "Human-readable category label."
     },
     {
      "name": "monograph_id",
      "type": "string",
      "description": "Compound/device monograph the product inherits its evidence from. Many products share one monograph."
     },
     {
      "name": "compound_or_device",
      "type": "string",
      "description": "Title of that monograph — the active compound or device class actually studied."
     },
     {
      "name": "evidence_grade",
      "type": "string",
      "description": "One of six tier labels. See the rubric on https://magellanlongevity.com/data/"
     },
     {
      "name": "evidence_grade_letter",
      "type": "string",
      "description": "Short letter form of the tier (A, B, C, C-, D)."
     },
     {
      "name": "evidence_tier_key",
      "type": "string",
      "description": "Machine key for the tier: strong | moderate | emerging | preliminary | tool | refuted."
     },
     {
      "name": "grade_source",
      "type": "string",
      "description": "How the grade was arrived at: curated_product (physician-reviewed, product-specific), curated_compound (physician-reviewed at the compound level), instrument_default (diagnostic/wearable graded as a measurement tool), provisional_from_citation_count (conservative fallback, capped below Strong)."
     },
     {
      "name": "grade_rationale",
      "type": "string",
      "description": "The plain-language reason shown to readers for why this grade applies."
     },
     {
      "name": "grade_caveat",
      "type": "string",
      "description": "The published caveat — where the evidence is weak, null, conflicted or industry-funded. Negative findings are retained deliberately."
     },
     {
      "name": "studied_dose",
      "type": "string",
      "description": "The dose range actually used in human trials, where a verified range exists. Empty where none has been established — never inferred."
     },
     {
      "name": "studied_dose_source",
      "type": "string",
      "description": "Which source supplied studied_dose."
     },
     {
      "name": "dietary_dose",
      "type": "string",
      "description": "How much of the compound is obtainable from food, where that is meaningful."
     },
     {
      "name": "pathway_id",
      "type": "string",
      "description": "Mechanistic system key assigned to the product."
     },
     {
      "name": "pathway_name",
      "type": "string",
      "description": "Human-readable pathway name (e.g. \"NAD+ / Sirtuin Axis\")."
     },
     {
      "name": "citation_count",
      "type": "integer",
      "description": "Number of peer-reviewed study records linked to this product's monograph."
     },
     {
      "name": "distinct_pmid_count",
      "type": "integer",
      "description": "Distinct PubMed IDs among those citations (a few papers appear under more than one internal key)."
     },
     {
      "name": "studies_with_writeup",
      "type": "integer",
      "description": "How many of those citations have a full structured write-up in table 2."
     },
     {
      "name": "pmids",
      "type": "string",
      "description": "Semicolon-separated PubMed IDs for every linked citation."
     },
     {
      "name": "study_keys",
      "type": "string",
      "description": "Semicolon-separated join keys into table 2 (studies.study_key)."
     },
     {
      "name": "key_finding_quote",
      "type": "string",
      "description": "A verbatim sentence from the specific study used to justify the pathway assignment. Quoted, never paraphrased."
     },
     {
      "name": "key_finding_pmid",
      "type": "string",
      "description": "PubMed ID of that study."
     },
     {
      "name": "key_finding_journal",
      "type": "string",
      "description": "Journal of that study."
     },
     {
      "name": "key_finding_year",
      "type": "integer",
      "description": "Publication year of that study."
     },
     {
      "name": "key_finding_source",
      "type": "string",
      "description": "Whether the key finding came from the curated pathway justification (product.why) or the first monograph citation."
     },
     {
      "name": "listed_price_usd",
      "type": "number",
      "description": "Typical listed US price at the release date. A snapshot, not a live price."
     },
     {
      "name": "affiliate_search_url",
      "type": "string",
      "description": "Amazon search URL carrying the Associates tag. Commission does not affect the grade (editorial firewall)."
     },
     {
      "name": "product_page_url",
      "type": "string",
      "description": "Canonical static product page."
     },
     {
      "name": "category_page_url",
      "type": "string",
      "description": "Canonical static category page."
     },
     {
      "name": "monograph_page_url",
      "type": "string",
      "description": "Canonical molecule monograph page, where one is published. Empty otherwise."
     }
    ],
    "primaryKey": "product_id"
   }
  },
  {
   "name": "studies",
   "path": "studies.csv",
   "format": "csv",
   "mediatype": "text/csv",
   "encoding": "utf-8",
   "profile": "tabular-data-resource",
   "schema": {
    "fields": [
     {
      "name": "study_key",
      "type": "string",
      "description": "Internal join key. Primary key of this table; join to products.study_keys."
     },
     {
      "name": "record_type",
      "type": "string",
      "description": "catalog_citation | catalog_citation_with_writeup | writeup_only."
     },
     {
      "name": "pmid",
      "type": "string",
      "description": "PubMed identifier."
     },
     {
      "name": "doi",
      "type": "string",
      "description": "Digital Object Identifier where recorded. Empty where the catalogue has none — never reconstructed."
     },
     {
      "name": "doi_url",
      "type": "string",
      "description": "Resolvable https://doi.org/ URL."
     },
     {
      "name": "pubmed_url",
      "type": "string",
      "description": "Resolvable PubMed URL."
     },
     {
      "name": "title",
      "type": "string",
      "description": "Article title as recorded."
     },
     {
      "name": "journal",
      "type": "string",
      "description": "Journal name as recorded."
     },
     {
      "name": "year",
      "type": "integer",
      "description": "Publication year."
     },
     {
      "name": "primary_compound",
      "type": "string",
      "description": "Title of the first monograph citing this study (deterministic, insertion order)."
     },
     {
      "name": "linked_compounds",
      "type": "string",
      "description": "Semicolon-separated titles of every monograph citing this study."
     },
     {
      "name": "linked_monograph_ids",
      "type": "string",
      "description": "Semicolon-separated monograph keys citing this study."
     },
     {
      "name": "linked_monograph_count",
      "type": "integer",
      "description": "How many monographs cite it."
     },
     {
      "name": "linked_product_ids",
      "type": "string",
      "description": "Semicolon-separated product ids that inherit this citation."
     },
     {
      "name": "linked_product_count",
      "type": "integer",
      "description": "How many catalogue products inherit this citation."
     },
     {
      "name": "cited_by_monograph",
      "type": "boolean",
      "description": "False for records held in the catalogue but not yet attached to a monograph."
     },
     {
      "name": "outcome_statement",
      "type": "string",
      "description": "The outcome in the source's own words: the write-up takeaway where one exists, otherwise the verbatim quoted finding."
     },
     {
      "name": "outcome_statement_source",
      "type": "string",
      "description": "Which field outcome_statement came from."
     },
     {
      "name": "reported_direction",
      "type": "string",
      "description": "favorable | mixed | no_difference | unfavorable | unclear. A coarse rule-based reading of the direction the source itself reports — NOT an independent appraisal. See the classifier notes below."
     },
     {
      "name": "direction_rule",
      "type": "string",
      "description": "Which branch of the classifier fired."
     },
     {
      "name": "direction_evidence",
      "type": "string",
      "description": "The exact phrase(s) that triggered the classification, so any row can be audited or rejected."
     },
     {
      "name": "direction_basis",
      "type": "string",
      "description": "Which text was classified: the write-up conclusion+takeaway, or the catalogue quote fragment."
     },
     {
      "name": "has_writeup",
      "type": "boolean",
      "description": "Whether a full structured write-up exists."
     },
     {
      "name": "writeup_url",
      "type": "string",
      "description": "Canonical study write-up page where one exists."
     },
     {
      "name": "research_question",
      "type": "string",
      "description": "The question the study set out to answer (write-ups only)."
     },
     {
      "name": "hypothesis",
      "type": "string",
      "description": "The stated hypothesis (write-ups only)."
     },
     {
      "name": "methods",
      "type": "string",
      "description": "Design, population, dose and duration (write-ups only)."
     },
     {
      "name": "results",
      "type": "string",
      "description": "Reported results (write-ups only)."
     },
     {
      "name": "conclusion",
      "type": "string",
      "description": "The authors' conclusion (write-ups only)."
     },
     {
      "name": "limitations",
      "type": "string",
      "description": "Stated limitations, retained verbatim including \"none stated\" (write-ups only)."
     },
     {
      "name": "source_file",
      "type": "string",
      "description": "Which source file(s) the row was assembled from."
     },
     {
      "name": "is_primary_record_for_pmid",
      "type": "boolean",
      "description": "True for exactly one row per PMID. Filter on this to de-duplicate to unique papers."
     }
    ],
    "primaryKey": "study_key"
   }
  }
 ]
}