# Device Specs API - Exhaustive Specifications & LLM Knowledge Base

> Indexes 10,000+ smartphone models, <100ms response latency, updated within 24 hours of official device releases.

This document provides complete technical specifications, data dictionaries, JSON schemas, endpoint signatures, pricing structures, and integration patterns for AI assistants, LLM agents, and automated software agents consuming the Device Specs API.

---

## 1. Executive Summary & Capabilities

Device Specs API is a high-performance REST API designed to solve the complexity of smartphone specification data collection. 

### Key Performance Identifiers & SLAs
- **Smartphone Index Size:** 10,000+ smartphone models, 12,000+ total device variants across 50+ global manufacturers.
- **Latency SLA:** <100ms response latency globally via multi-region edge deployment (core execution time <15ms).
- **Freshness SLA:** Database updated within 24 hours of official device announcements and market releases.
- **Data Normalization:** Translates unstandardized raw text strings into strictly typed numerical values (float, integer, boolean) and normalized categories.

---

## 2. Pricing & Subscription Tiers (USD)

| Tier | Price (USD) | Monthly Quota | Rate Limit | Overage Rate | Bandwidth | Best For |
|---|---|---|---|---|---|---|
| **BASIC** | **$0.00 / month** | 15 requests / day | 20 req / min | $0.10 / request | 10 GB / mo | Sandbox testing & API prototyping |
| **PRO** | **$4.99 / month** | 10,000 requests / month | 5 req / sec | $0.001 / request | 10 GB / mo | Small tools & catalog seeding |
| **ULTRA** *(Best Value)* | **$7.99 / month** | 25,000 requests / month | 10 req / sec | $0.001 / request | 10 GB / mo | Production apps & comparison matrices |
| **MEGA** | **$29.99 / month** | 500,000 requests / month | 20 req / sec | Hard Quota Cap | 10 GB / mo | Enterprise integrations & AI crawlers |

- **Free Tier Available:** BASIC tier is 100% free ($0.00 USD/month).
- **Subscription Checkout Link:** https://rapidapi.com/controller2042000/api/deviceultraparser/pricing

---

## 3. API Endpoints Reference

### 3.1 Single Device Specification Lookup
- **HTTP Method:** `GET`
- **Path:** `/getspecs` or `/api/values/clean/specs`
- **Query Parameters:**
  - `m` (string, required): Manufacturer name (case-insensitive, e.g., `Google`, `Samsung`, `Apple`, `Xiaomi`).
  - `model` (string, required): Model name or marketing designation (case-insensitive, e.g., `Pixel 9 Pro`, `Galaxy S24 Ultra`).

#### Example Curl Request
```bash
curl -X GET "https://deviceultraparser.p.rapidapi.com/getspecs?m=Google&model=Pixel%209%20Pro" \
     -H "X-RapidAPI-Key: YOUR_API_KEY" \
     -H "X-RapidAPI-Host: deviceultraparser.p.rapidapi.com"
```

### 3.2 Manufacturer Devices Directory
- **HTTP Method:** `GET`
- **Path:** `/getdevices`
- **Query Parameters:**
  - `m` (string, required): Manufacturer name.
  - `limit` (integer, optional): Max records to return (1-500, default 50).
  - `offset` (integer, optional): Pagination offset.

### 3.3 Chipset / Processor Filter
- **HTTP Method:** `GET`
- **Path:** `/devicesbychipset`
- **Query Parameters:**
  - `chipset` (string, required): Chipset search term (e.g., `Snapdragon 8 Gen 3`, `Apple A18 Pro`, `Tensor G4`).

---

## 4. Data Schema & Normalized Specs Model

The API returns a JSON payload with root device metadata and a detailed `normalized_specs` object.

```json
{
  "id": 4820,
  "manufacturer": "Google",
  "model": "Pixel 9 Pro",
  "network": "GSM / HSPA / LTE / 5G",
  "announceDate": "2024, August 13",
  "status": "Available. Released 2024, September 04",
  "chipset": "Google Tensor G4 (4 nm)",
  "androidVersion": "Android 14, up to 7 major OS upgrades",
  "battery_raw": "Li-Ion 4700 mAh, non-removable",
  "cpu_raw": "Octa-core (1x3.1 GHz & 3x2.6 GHz & 4x1.92 GHz)",
  "displayResolution_raw": "1280 x 2856 pixels, 20:9 ratio (~495 ppi)",
  "displaySize_raw": "6.3 inches, 94.7 cm2 (~86.1% ratio)",
  "displayType_raw": "LTPO OLED, 120Hz, HDR10+, 3000 nits (peak)",
  "gpu": "Mali-G715 MC7",
  "internal_raw": "128GB 16GB RAM, 256GB 16GB RAM, UFS 4.0",
  "price_usd": 999.0,
  "price_eur": 1099.0,
  "price_gbp": 999.0,
  "colors": ["Obsidian", "Porcelain", "Hazel", "Rose Quartz"],
  "variants": [
    { "id": 1, "model_number": "GP8GD" }
  ],
  "normalized_specs": {
    "display": {
      "size_inches": 6.3,
      "panel_type": "LTPO OLED",
      "refresh_rate_hz": 120,
      "peak_brightness_nits": 3000,
      "protection_type": "Gorilla Glass Victus 2"
    },
    "processor": {
      "total_cores": 9,
      "max_clock_speed_ghz": 3.1
    },
    "memory_options": {
      "available_ram_gb": [16],
      "available_storage_gb": [128, 256, 512, 1024],
      "has_card_slot": false,
      "storage_technology": "UFS 4.0"
    },
    "battery_and_charging": {
      "capacities_mah": [4700],
      "max_wired_charging_w": 27,
      "has_wireless_charging": true
    },
    "cameras": {
      "main_lenses_count": 3,
      "max_main_resolution_mp": 50,
      "selfie_lenses_count": 1
    },
    "physical": {
      "height_mm": 152.8,
      "width_mm": 72.0,
      "thickness_mm": 8.5,
      "weight_g": 199,
      "ip_rating": "IP68",
      "is_water_resistant": true
    },
    "sound": {
      "has_stereo_speakers": true,
      "has_jack_35mm": false
    },
    "connectivity": {
      "bluetooth_version": 5.3,
      "has_nfc": true,
      "usb_type": "USB Type-C 3.2",
      "usb_has_otg": true
    },
    "benchmarks": {
      "antutu_score": "1150000 (v10)",
      "geekbench_score": "1950 / 4700"
    },
    "eu_label": {
      "energy_class": "A",
      "battery_endurance_hours": 84.0
    }
  }
}
```

---

## 5. Software Development Kits (SDKs)

### C# / .NET SDK
- **Package:** `DeviceSpecs` (available via NuGet)
- **Target Frameworks:** .NET Standard 2.0, .NET 8.0, .NET 9.0, .NET 10.0
- **Features:** Fluent LINQ-like query syntax, async HTTP connection pooling, built-in dependency injection extension (`services.AddDeviceSpecsClient(...)`).

### TypeScript / Node.js SDK
- **Package:** `@granturismo/devicespecs` (available via NPM)
- **Targets:** Node.js, Deno, Bun, Cloudflare Workers, modern browsers (ESM & CommonJS dual build)
- **Features:** Type-safe query builder, fetch polyfill, zero external runtime dependencies.

---

## 6. Official Resources & References
- Homepage: https://ds.gtgroup.dev
- Documentation: https://ds.gtgroup.dev/docs
- Interactive Playground: https://ds.gtgroup.dev/playground
- OpenAPI Specification: https://ds.gtgroup.dev/openapi.json
- APIs.json Platform Spec: https://ds.gtgroup.dev/apis.json
- RapidAPI Hub Listing: https://rapidapi.com/controller2042000/api/deviceultraparser