Watchlists

Watchlists let signed-in users keep a persistent set of repositories. GitStars.io also has public token-based watchlist API endpoints for creating, reading, updating, and clearing shared watchlist records.

Product behavior

• Signed-in users see Watchlist in the menu.
• Save icons are visible on repository cards and detail pages.
• Signed-out users are sent to login when they try to save.
• Watchlist counts are shown in the menu when available.

Public API

The public API includes token-based watchlist endpoints:

• POST /api/watchlists
• GET /api/watchlists/:token
• PATCH /api/watchlists/:token
• DELETE /api/watchlists/:token
• GET /api/watchlists/:token/repositories
• POST /api/watchlists/:token/items
• DELETE /api/watchlists/:token/items/:repositoryId
• DELETE /api/watchlists/:token/items

For signed-in account watchlists, the app uses /api/me/watchlist routes, which require authentication.

Best practices

• Keep public token watchlists small enough for fast repository lookups.
• Prefer signed-in watchlists for user workflows.
• Use window on repository list calls to keep score context consistent.