Public API overview

The GitStars.io public API is served from:

https://gitstars.io/api

Response envelope

Successful responses use a data field and may include meta.

{
  "data": [],
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 100,
    "hasMore": true,
    "nextCursor": "..."
  }
}

Error responses use an error object.

{
  "data": null,
  "error": {
    "code": "NOT_FOUND",
    "message": "Repository not found"
  }
}

Endpoint families

• Lists: rankings and search
• Repository detail and metrics
• Facets and trend facets
• Watchlists
• Embeds
• Home and stats

Authentication

The public API does not require authentication for public data. You can optionally send an API key for higher rate limits:

curl -H "Authorization: Bearer YOUR_API_KEY" "https://gitstars.io/api/trending"

Create and revoke keys from the GitStars.io user menu after signing in. See API keys.