Skip to main content
TrackGeek Logo

Welcome to TrackGeek API

TrackGeek is a RESTful API for a unified media tracking platform that lets users track games, anime, movies, TV shows, books, and manga with an advanced progress system, social features, and seamless authentication.

Getting Started

Quickstart

Get up and running with TrackGeek API in minutes with your first authenticated request

Authentication

Learn about Better Auth integration, social providers, and session management

API Reference

Explore all available endpoints with interactive examples

GitHub Repository

View the source code, contribute, and report issues

Key Features

Media Tracking

Track games, anime, movies, TV shows, books, and manga with detailed progress tracking and status management

Social Features

Follow users, share activity through feed events, comment, react, and build your community

Custom Lists

Create and manage custom lists to organize your media collections your way

User Profiles

Customize profiles with avatars, banners, colors, and timezone preferences

Reviews & Ratings

Write reviews, rate media, and share your opinions with the community

Favorites System

Mark your favorite media and keep track of what matters most to you

Tech Stack

TrackGeek API is built with modern, production-ready technologies:
  • NestJS - Progressive Node.js framework
  • Prisma ORM - Type-safe database access
  • PostgreSQL - Reliable data storage
  • Redis - High-performance caching
  • Better Auth - Modern authentication solution
  • BullMQ - Background job processing
  • Swagger/OpenAPI - Interactive API documentation

API Base URL

The API is available at:
http://localhost:40287
All API endpoints are prefixed with the base URL. Authentication endpoints are available at /auth/* and require proper configuration of social providers.

Rate Limiting

The API implements rate limiting to ensure fair usage and system stability. Rate limits are applied per IP address and authenticated user.
Exceeding rate limits will result in 429 Too Many Requests responses. Implement proper retry logic with exponential backoff in your applications.

Support

Need help? Here’s how to get support:
  • GitHub Issues: Report bugs or request features
  • Documentation: Browse through our comprehensive guides
  • Contributing: See CONTRIBUTING.md for contribution guidelines

Next Steps

1

Complete the Quickstart

Follow our quickstart guide to make your first API request
2

Set Up Authentication

Configure authentication with your preferred social providers
3

Explore the API

Browse the API Reference to discover all available endpoints
4

Build Your App

Start building your media tracking application with TrackGeek

Build docs developers (and LLMs) love