Skip to content
GitStars.io Docs

Quickstart

Use the web app

Section titled “Use the web app”
  1. Open gitstars.io.
  2. Start with Trending to see repositories with strong current momentum.
  3. Use the dropdown in the Trending headline to switch to Rising Stars, New and Hot, or Fork Growth.
  4. Use Explore to filter by provider, language, topic, stars, forks, age, and search query.
  5. Open a repository page to inspect snapshots, rollups, related repositories, and discovery context.

Save repositories

Section titled “Save repositories”

Sign in with a magic link, Google SSO, or GitHub SSO to use a persistent Watchlist. The save icon remains visible for every visitor; signed-out users are sent to login when they try to save.

Call the API

Section titled “Call the API”

Use the public API for list views, repository details, metrics, facets, and embeds.

Terminal window
curl "https://gitstars.io/api/trending?window=24h&limit=10"

Responses use this envelope:

{
  "data": [],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 123,
    "hasMore": true
  }
}

Add an embed

Section titled “Add an embed”
<img
  src="https://gitstars.io/api/embed/gitstars.svg?provider=github&repo=vercel/next.js&theme=light&range=1y&metric=stars"
  alt="GitStars.io trend for vercel/next.js"
/>

Next steps

Section titled “Next steps”