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

AI Bots & LLM Agents can consume machine-readable markdown specs via /llms.txt and /llms-full.txt.

using DeviceSpecs;

var builder = WebApplication.CreateBuilder(args);

// Register IDeviceSpecsClient in ASP.NET Core DI container
builder.Services.AddDeviceSpecsClient(options =>
{
    options.ApiKey = builder.Configuration["DeviceSpecs:ApiKey"] ?? "YOUR_API_KEY";
});

// A. Deep Multi-Metric Fluent Query
app.MapGet("/devices/flagships", async (IDeviceSpecsClient client) =>
{
    var flagships = await client.Where()
        .ManufacturerIs(Brands.Samsung)
        .ChipsetContains("Snapdragon")
        .RamGreaterThanOrEqual(8)
        .RamLessOrEqual(16)
        .DisplayRefreshRateGreaterThanOrEqual(120)
        .DisplaySizeGreaterThanOrEqual(6.5)
        .BatteryGreaterThanOrEqual(5000)
        .HasWirelessCharging()
        .HasStereoSpeakers()
        .PriceUsdLessOrEqual(1200)
        .ExecuteAsync();

    return Results.Ok(flagships);
});

// B. Multi-Brand Query (ManufacturerBetween)
app.MapGet("/devices/budget-midrangers", async (IDeviceSpecsClient client) =>
{
    var devices = await client.Where()
        .ManufacturerBetween(Brands.Samsung, Brands.Xiaomi, Brands.Oppo)
        .RamGreaterThan(8)
        .HasNfc()
        .PriceUsdLessThan(800)
        .ExecuteAsync();

    return Results.Ok(devices);
});

// C. Hardware Variant / Model Number Lookup
app.MapGet("/devices/variant/{modelNumber}", async (string modelNumber, IDeviceSpecsClient client) =>
{
    var variant = await client.GetDeviceByModelNumberAsync(modelNumber);
    return variant is not null ? Results.Ok(variant) : Results.NotFound();
});

import { DeviceSpecsClient, Brands } from "@granturismo/devicespecs";

const client = new DeviceSpecsClient("YOUR_API_KEY");

// 1. Fluent deep multi-metric query
const flagshipPhones = await client
  .where()
  .manufacturerIs(Brands.Samsung)
  .ramGreaterThanOrEqual(8)
  .displayRefreshRateGreaterThanOrEqual(120)
  .hasWirelessCharging()
  .priceUsdLessOrEqual(1200)
  .execute();

// 2. Direct model lookup
const pixel = await client.getSpecs(Brands.Google, "Pixel 9 Pro");

Java & Android Client SDK

/api/values/clean/getspecs/{manufacturer}/{model}

curl --request GET \
  --url 'https://deviceultraparser.p.rapidapi.com/api/values/clean/getspecs/Google/Pixel%209%20Pro' \
  --header 'x-rapidapi-host: deviceultraparser.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

/api/values/clean/getdevices/{manufacturer}

curl --request GET \
  --url 'https://deviceultraparser.p.rapidapi.com/api/values/clean/getdevices/Apple' \
  --header 'x-rapidapi-host: deviceultraparser.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

/api/values/clean/devicesbychipset/{chipset}

1. Query Parameter Syntax

Filter parameters follow the standardized pattern:

• property: The simplified alias of the device specification property to filter by (e.g. battery, ram, chipset).
• operator: The comparison operator (e.g. gte, contains, between). If omitted, defaults to equality (eq).
• value: The argument to compare against. Commas (,) are used as delimiters for list and range operators (e.g. between=8,12).

2. Supported Comparison Operators

3. Supported Property Aliases

Use these simplified aliases to query deep nested database attributes without specifying raw paths:

4. Concrete Query Examples (REST & Fluent SDK Code)

var devices = await client.Where()
    .ChipsetContains("Snapdragon")
    .BatteryGreaterThanOrEqual(5000)
    .RamBetween(8, 16)
    .ExecuteAsync();

const devices = await client.where()
    .chipsetContains("Snapdragon")
    .batteryGreaterThanOrEqual(5000)
    .ramBetween(8, 16)
    .execute();

var devices = await client.Where()
    .ManufacturerBetween(Brands.Samsung, Brands.Xiaomi, Brands.Oppo)
    .HasNfc()
    .DisplayRefreshRateGreaterThanOrEqual(120)
    .ExecuteAsync();

const devices = await client.where()
    .manufacturerBetween(Brands.Samsung, Brands.Xiaomi, Brands.Oppo)
    .hasNfc()
    .displayRefreshRateGreaterThanOrEqual(120)
    .execute();

DisplayMetrics (normalized_specs.display)

CpuMetrics (normalized_specs.processor)

MemoryMetrics (normalized_specs.memory_options)

PowerMetrics (normalized_specs.battery_and_charging)

CameraSummary (normalized_specs.cameras)

PhysicalMetrics (normalized_specs.physical)

SoundMetrics (normalized_specs.sound)

ConnectivityMetrics (normalized_specs.connectivity)

BenchmarkMetrics (normalized_specs.benchmarks)

EuLabelMetrics (normalized_specs.eu_label)