ClassifyAI

API Documentation

RESTful API for programmatic access to the classification engine. Authenticate with an API key via the X-API-Key header.

Endpoints

POST/api/v1/classify Auth required

Classify a single patent by title and abstract

Request

{
  "title": "Solar cell with perovskite layer",
  "abstract": "A photovoltaic device comprising..."
}

Response

{
  "section": { "code": "H", "name": "Electricity", "confidence": 0.89 },
  "class": { "code": "H01", "confidence": 0.76 },
  "subclass": { "code": "H01L", "confidence": 0.62 },
  "processing_time_ms": 45
}

Code Examples

curl -X POST https://api.classifyai.com/api/v1/classify \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{"title": "Solar cell...", "abstract": "A photovoltaic..."}'

Authentication

All authenticated endpoints require an API key passed via the X-API-Key header. Contact your administrator to obtain an API key. The health endpoint is publicly accessible without authentication.