Skip to main content

​
Welcome to the Judge System API

The Judge System API enables you to create intelligent content evaluation systems with customizable criteria. Whether you’re evaluating text, video, audio, or image content, our API provides the tools you need.

​
Base URL

All API requests are made to: 
https://api.judge.example.com

​
Authentication

Include your API key in the Authorization header for all requests: 
Authorization: Bearer YOUR_API_KEY

​
Response Format

All responses are in JSON format with consistent structure:

​
Success Response

{
  "data": {
    // Response data here
  },
  "status": "success",
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Error Response

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable error message",
    "details": {
      // Additional error context
    }
  },
  "status": "error",
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Status Codes

CodeDescription
200Success
201Created
202Accepted (async operation started)
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Internal Server Error

​
Rate Limits

API calls are rate limited per API key:
  • Standard: 100 requests per minute
  • Premium: 1000 requests per minute
Rate limit headers are included in responses: 
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1642248000

​
Content Types

The API supports evaluation of multiple content types:
  • Text: Articles, documents, social media posts
  • Video: MP4, AVI, MOV files
  • Audio: MP3, WAV, M4A files
  • Image: JPG, PNG, GIF files

​
Judge System Workflow

  1. Create Judges - Define evaluation criteria for your content
  2. Upload Content - Submit content for evaluation
  3. Run Evaluations - Process content against judge criteria
  4. Review Results - Get detailed scores and feedback

​
SDKs and Libraries

We provide official SDKs for popular programming languages:
  • Python: pip install judge-api
  • JavaScript: npm install @judge/api
  • Go: go get github.com/judge/api-go

​
Support