Skip to content

Core concepts

A repository is a public GitHub or GitLab project tracked by GitStars.io. Repositories have provider metadata, star and fork totals, language and topic metadata, provider timestamps, and availability flags.

A snapshot captures current repository metrics at a point in time. GitStars.io uses snapshots to compute deltas and trend windows.

A rollup summarizes snapshots into a window such as 24h, 7d, or 30d. Rollups power rankings, repository pages, and list APIs.

Rankings are materialized views of repositories ordered by a scoring strategy:

  • Trending balances star growth, activity, and confidence.
  • Rising Stars highlights fast relative growth.
  • New and Hot focuses on newer projects with meaningful early momentum.
  • Fork Growth emphasizes fork velocity.

Some public lists can be filtered with reliableOnly=true. This keeps items with enough recent data quality to make the trend score useful. A repository can appear in GitStars.io before every chart or metadata field is complete.

GitStars.io currently supports GITHUB and GITLAB. Public API input accepts provider names case-insensitively, but responses use uppercase provider values.

A window is the time range used for a score or metric delta. Public list endpoints commonly support 24h, 7d, and 30d. Repository metric endpoints support longer chart ranges such as 90d and all.