Getting Started

Sparepart API Documentation

Access comprehensive data for 14,000+ computer components including CPUs, GPUs, Memory, Motherboards, Cases, Coolers, PSUs, and Storage devices.

🌐

Base URL https://partcomp.ruang.app

14,031 Components

8 Categories

REST API Type

JSON Format

Authentication

The API uses two authentication methods:

🔑

JWT Token

Used for account management operations like creating and managing API keys.

Header: Authorization: Bearer <token>

🔐

API Key

Used for accessing component data. Get your key from the dashboard.

Header: X-API-Key: sk_your_key_here

Quick Start Guide

Get up and running in 3 simple steps:

Create an Account

POST /api/auth/register

{
  "email": "your@email.com",
  "password": "yourpassword",
  "name": "Your Name"
}

Login & Get Token

POST /api/auth/login

{
  "email": "your@email.com",
  "password": "yourpassword"
}

// Response
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": { "id": 1, "name": "Your Name" }
}

Create API Key & Access Data

POST /api/auth/api-key JWT Required

// Request
{ "name": "My Application" }

// Response
{
  "apiKey": {
    "key": "sk_abc123def456...",
    "name": "My Application"
  }
}

GET /api/cpu API Key

curl -H "X-API-Key: sk_abc123..." \
     https://partcomp.ruang.app/api/cpu

Register User

POST /api/auth/register

Create a new user account.

Request Body

Parameter	Type	Required	Description
`email`	string	Yes	Valid email address
`password`	string	Yes	Min 6 characters
`name`	string	Yes	Display name

Response

{
  "message": "User registered successfully",
  "user": {
    "id": 1,
    "email": "user@example.com",
    "name": "John Doe"
  }
}

Login

POST /api/auth/login

Authenticate and receive a JWT token valid for 24 hours.

Request Body

Parameter	Type	Required	Description
`email`	string	Yes	Registered email
`password`	string	Yes	Account password

Response

{
  "message": "Login successful",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": 1,
    "email": "user@example.com",
    "name": "John Doe"
  }
}

Create API Key

POST /api/auth/api-key JWT Required

Generate a new API key. Store it securely - it's only shown once!

Headers

Header	Value
`Authorization`	Bearer YOUR_JWT_TOKEN

Request Body

Parameter	Type	Required	Description
`name`	string	Yes	Key identifier

⚠️ Important: The full API key is only shown once. Save it immediately!

List API Keys

GET /api/auth/api-keys JWT Required

List all API keys for your account. Keys are masked for security.

Delete API Key

DELETE /api/auth/api-key/:id JWT Required

Revoke an API key. The key will stop working immediately.

Get All Components

GET /api/{component} API Key

Retrieve paginated list of components. Replace {component} with: cpu, gpu, memory, motherboard, case, cooler, psu, or storage.

Query Parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number
`limit`	integer	20	Items per page (max 100)

Example

Request

curl -H "X-API-Key: sk_your_key" \
     "https://partcomp.ruang.app/api/cpu?page=1&limit=5"

Response

{
  "data": [
    {
      "id": 1,
      "partType": "cpu",
      "name": "Intel Core i9-14900K",
      "brand": "Intel",
      "socket": "LGA 1700",
      "speed": 6.0,
      "coreCount": 24,
      "threadCount": 32,
      "power": 125
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 5,
    "total": 458,
    "totalPages": 92
  }
}

Get Single Component

GET /api/{component}/:id API Key

Retrieve a single component by its ID.

Example

curl -H "X-API-Key: sk_your_key" \
     "https://partcomp.ruang.app/api/gpu/42"

Search Components

GET /api/{component}/search API Key

Search components by name (case-insensitive partial match).

Query Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search keyword
`limit`	integer	No	Max results (default 20)

Example

curl -H "X-API-Key: sk_your_key" \
     "https://partcomp.ruang.app/api/gpu/search?q=RTX%204090"

CPU Schema

/api/cpu 458 items

Field	Type	Description
`id`	integer	Unique identifier
`partType`	string	Always "cpu"
`name`	string	Full product name
`brand`	string	Intel or AMD
`socket`	string	Socket type (LGA 1700, AM5, etc.)
`speed`	number	Base clock speed in GHz
`coreCount`	integer	Number of cores
`threadCount`	integer	Number of threads
`power`	integer	TDP in watts

GPU Schema

/api/gpu 2,515 items

Field	Type	Description
`id`	integer	Unique identifier
`partType`	string	Always "gpu"
`name`	string	Full product name
`brand`	string	NVIDIA, AMD, or Intel
`vram`	integer	Video memory in GB
`resolution`	string	Target resolution
`power`	integer	TDP in watts

Memory Schema

/api/memory 1,707 items

Field	Type	Description
`id`	integer	Unique identifier
`partType`	string	Always "memory"
`name`	string	Full product name
`type`	string	DDR4, DDR5, etc.
`size`	string	Capacity (16GB, 32GB, etc.)

Motherboard Schema

/api/motherboard 2,422 items

Field	Type	Description
`id`	integer	Unique identifier
`partType`	string	Always "motherboard"
`name`	string	Full product name
`brand`	string	Manufacturer
`socket`	string	CPU socket type
`size`	string	Form factor (ATX, mATX, ITX)

Case Schema

/api/case 1,571 items

Field	Type	Description
`id`	integer	Unique identifier
`partType`	string	Always "case"
`name`	string	Full product name
`size`	string	Supported form factors

Cooler Schema

/api/cooler 872 items

Field	Type	Description
`id`	integer	Unique identifier
`partType`	string	Always "cooler"
`name`	string	Full product name
`type`	string	Air or Liquid

PSU Schema

/api/psu 2,314 items

Field	Type	Description
`id`	integer	Unique identifier
`partType`	string	Always "psu"
`name`	string	Full product name
`power`	integer	Wattage
`size`	string	Form factor (ATX, SFX)

Storage Schema

/api/storage 2,172 items

Field	Type	Description
`id`	integer	Unique identifier
`partType`	string	Always "storage"
`name`	string	Full product name
`type`	string	SSD, HDD, or NVMe
`space`	string	Storage capacity

Ready to Start Building?

Create your free account and get your API key in seconds.

Get Your API Key →