Scores
Hierarchical benchmark scores for every tested device.
GET/scores
/scoresReturns computed benchmark scores for all tested devices. Scores are on a 0–950 scale (higher is better) and organized in a hierarchy from sub-scores to an overall device score.
Parameters
Standard PostgREST filtering. Common filters:
| Filter | Effect |
|---|---|
?device_id=eq.apple_iphone_17_pro_max | Scores for one device |
?score_definition=eq.overall | Just overall scores for all devices |
?level=eq.0 | Only sub-scores |
?is_parent=is.true | Only parent/rollup scores |
?select=device_id,brand,model,score_definition,score | Select specific fields |
Response Fields
| Field | Type | Description |
|---|---|---|
device_id | string | Device identifier |
brand | string | Manufacturer |
model | string | Device model |
score_definition | string | Score name (see hierarchy below) |
variant | string | Lens/display variant (null for non-camera scores) |
score | number | Score value (0–950 scale, 1 decimal) |
level | number | Hierarchy level (0=sub-score, 1=category, 2=camera_overall, 3=overall) |
is_parent | boolean | Whether this score rolls up from child scores |
component | string | Parent score this feeds into |
Score Hierarchy
Scores are organized into four levels. Each child score feeds into its parent via the component field.
overallcamera_overallbattery, camera (per lens: Main / UW / Tele / Front), charging, display, performance, speaker
battery_web, battery_video, battery_gaming
camera_sharpness, camera_color, camera_dynamic_range, camera_stabilization, camera_depth (each per lens variant)
charging_wired, charging_wireless
display_brightness, display_color_accuracy, display_resolution, display_refresh_rate, display_responsiveness
performance_cpu, performance_gpu, performance_ai
speaker_loudness, speaker_bass, speaker_clarity, speaker_cleanliness
biometrics, connectivity, microphone
Example: Get Overall Ranking
curl "https://api.bandicootlab.com/rest/v1/scores?score_definition=eq.overall&select=device_id,brand,model,score&order=score.desc" \
-H "apikey: YOUR_API_KEY" \
-H "Accept-Profile: api"Example: Compare Camera Scores
curl "https://api.bandicootlab.com/rest/v1/scores?device_id=in.(apple_iphone_17_pro_max,samsung_galaxy_s25_ultra)&score_definition=eq.camera_overall" \
-H "apikey: YOUR_API_KEY" \
-H "Accept-Profile: api"Example Response
[
{
"device_id": "samsung_galaxy_s25_ultra",
"brand": "Samsung",
"model": "Galaxy S25 Ultra",
"score_definition": "overall",
"variant": null,
"score": 812.4,
"level": 3,
"is_parent": true,
"component": null
},
{
"device_id": "apple_iphone_16_pro_max",
"brand": "Apple",
"model": "iPhone 16 Pro Max",
"score_definition": "overall",
"variant": null,
"score": 798.1,
"level": 3,
"is_parent": true,
"component": null
},
{
"device_id": "google_pixel_9_pro_xl",
"brand": "Google",
"model": "Pixel 9 Pro XL",
"score_definition": "overall",
"variant": null,
"score": 771.6,
"level": 3,
"is_parent": true,
"component": null
}
]