API Documentation

Free, public API for AI model rankings

Getting Started

The LLM Mood Tracker API provides real-time access to community-driven AI model rankings and performance data. No authentication required - just start making requests!

Base URL: https://llmmood.com/api/v1

Get All Models

GET

/api/v1/models

Query Parameters

Parameter	Type	Description
`category`	string	Filter by category (llm, image, code)
`provider`	string	Filter by provider (openai, anthropic, etc.)
`limit`	number	Results per page (max: 100, default: 50)
`offset`	number	Pagination offset (default: 0)

Example Response

{
  "models": [
    {
      "id": "gpt-4",
      "name": "GPT-4",
      "provider": "openai",
      "category": "llm",
      "context_length": 8192,
      "current_performance": "4.5",
      "current_intelligence": "4.7",
      "total_votes": 1523,
      "overall_score": 4.6,
      "updated_at": "2024-01-15T12:00:00Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 134,
    "hasMore": true
  }
}

Get Single Model

GET

/api/v1/models/{modelId}

Path Parameters

Parameter	Type	Description
`modelId`	string	The model ID (e.g., "gpt-4", "claude-3-opus")

Get Rankings

GET

/api/v1/rankings

Query Parameters

Parameter	Type	Description
`period`	string	Time period: today, week, month (default: today)
`category`	string	Filter by category (llm, image, code)

Example Response

{
  "period": "today",
  "rankings": [
    {
      "id": "claude-3-opus",
      "name": "Claude 3 Opus",
      "provider": "anthropic",
      "category": "llm",
      "avg_performance": "4.8",
      "avg_intelligence": "4.9",
      "vote_count": 234,
      "overall_score": 4.85
    }
  ]
}

Rate Limits

The API is free to use with generous rate limits: 1000 requests per hour per IP address. Responses include cache headers for optimal performance. No API key required!