Mobile Specs API

Discovery

GET /brands List all brands ▼

Returns all device brands available on GSMArena with their slugs and phone counts.

Example

/brands⊘ copy

GET /brands/:brandSlug Phones by brand ▼

Returns all phones listed under a specific brand on GSMArena.

Path Parameters

brandSlug string Brand slug from /brands e.g. samsung, apple, xiaomi

Example

/brands/samsung⊘ copy

GET /latest Latest releases ▼

Returns the most recently released phones from GSMArena's latest devices listing.

Example

/latest⊘ copy

GET /top-by-interest Top by user interest ▼

Returns phones ranked by current user interest / search traffic on GSMArena.

Example

/top-by-interest⊘ copy

GET /top-by-fans Top by fan count ▼

Returns phones ranked by the number of fans/followers on GSMArena.

Example

/top-by-fans⊘ copy

Search & Specs

GET /search?query=:q Search devices ▼

Searches GSMArena for devices matching the query. Returns a list of matches with slugs you can pass to other endpoints.

Query Parameters

query string · required Device name to search for

Example

/search?query=pixel 9 pro⊘ copy

GET /:slug Device specs by slug ▼

Returns full specifications for a device by its GSMArena slug. Obtain the slug from /search results.

Path Parameters

slug string GSMArena device slug e.g. samsung_galaxy_s25_ultra-12559

Example

/samsung_galaxy_s25_ultra-12559⊘ copy

GET /phone?name=:name ★ MAIN ▼

One endpoint for everything. Pass a plain device name — it searches, fetches full specs, and scrapes all camera samples in one shot. Best starting point for any integration.

Query Parameters

name string · required Plain device name e.g. samsung galaxy s25 ultra, iphone 16 pro max

Response Fields

brand, modelDevice identity

specificationsobjectFull specs table — chipset, display, battery, connectivity…

device_imagesstring[]Official press images from the specs page

hdImageUrlstringHigh-res hero image from review page (1200px)

cameraSamplesarrayAll tabs — Main, Night, Zoom, Selfie, Video with classified images

lensDetailsarrayPer-lens metadata from review page

review_urlstringGSMArena review page URL if available

Example

/phone?name=samsung galaxy s25 ultra⊘ copy

Reviews & Camera Samples

GET /review/:reviewSlug Full review data ▼

Scrapes a GSMArena review page and all camera-sample tabs. Returns hero images, article images grouped by section heading, and all camera sample categories.

Path Parameters

reviewSlug string Review slug e.g. samsung_galaxy_s25_ultra-review-2939p5 — page suffix optional

Response Fields

heroImagesstring[]Header / top-of-page images

articleImagesobjectIn-body images grouped by nearest section heading

cameraSamplesarrayAll tabs (Main Camera, Night, Zoom, Selfie, Video…) with images

Example

/review/samsung_galaxy_s25_ultra-review-2939p5⊘ copy

GET /review/:reviewSlug/camera-samples Camera samples only ▼

Returns only the camera samples section — all tabs with classified images. Lighter response than the full review endpoint.

Path Parameters

reviewSlugstringGSMArena review slug

Example

/review/samsung_galaxy_s25_ultra-review-2939p5/camera-samples⊘ copy

GET /review/:reviewSlug/images Hero + article images ▼

Returns only hero and article images for a review page — excludes camera samples. Useful for fetching high-res editorial photos.

Path Parameters

reviewSlugstringGSMArena review slug

Example

/review/samsung_galaxy_s25_ultra-review-2939p5/images⊘ copy

Debug

GET /debug DEV ▼

Health check — confirms the serverless function is alive and routing correctly.

Response

{ "ok": true, "url": "/debug", "method": "GET" }

/debug⊘ copy

GET /debug-camera DEV ▼

Diagnostic for camera sample link detection on the iQOO Z7 Pro opinions page. Returns link counts and matched camera URLs.

/debug-camera⊘ copy