# GSMArena Device Database & Spec Sheet Extractor (`vexaloom-labs/gsmarena-device-database-and-spec-sheet-extractor`) Actor

Search GSMArena's phone catalog by keyword, brand or popularity, or pull a full spec sheet for one device, covering display, chipset, camera, battery, connectivity and body details.

- **URL**: https://apify.com/vexaloom-labs/gsmarena-device-database-and-spec-sheet-extractor.md
- **Developed by:** [vexaloom-labs](https://apify.com/vexaloom-labs) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## GSMArena Device Database & Spec Sheet Extractor

GSMArena maintains one of the most complete historical records of mobile phones, from early-2000s feature phones to the newest flagships. This actor reads that catalog in two depths: a lighter summary record for browsing/searching many devices at once, and a full spec-sheet record for one device at a time.

### What this actor does

- Searches the catalog by keyword with optional OS, availability and sort filters.
- Lists every device for a given brand, or the current top devices by popularity/price/weight/camera/battery.
- Pulls a complete specification sheet — display, chipset, cameras, battery, connectivity, body and sensors — for one device by URL or slug.
- Normalizes shorthand specs (RAM, storage, battery capacity, display size) out of the brief text shown in listings.
- Fields GSMArena doesn't publish for a device (e.g. no listed price, no memory card slot) are left out of that record.

### Output per device (search, byBrand, topDevices modes)

| Field | Description |
| --- | --- |
| `url` | GSMArena device page URL. |
| `slug` | GSMArena's URL slug for the device. |
| `deviceName` | Full device name as listed. |
| `brand` | Manufacturer, inferred from the device name. |
| `imageUrl` | Listing thumbnail image URL. |
| `os` | Operating system, when shown in the listing's brief specs. |
| `released` | Announcement or release period, when shown in the brief specs. |
| `displaySize` | Screen size, when shown in the brief specs. |
| `chipset` | Chipset/SoC, when shown in the brief specs. |
| `battery` | Battery capacity, when shown in the brief specs. |
| `storage` | Internal storage, when shown in the brief specs. |
| `ram` | RAM capacity, when shown in the brief specs. |
| `scrapedAt` | ISO timestamp of when the record was captured. |

### Output per device (deviceDetails mode)

| Field | Description |
| --- | --- |
| `url` / `slug` | Device page URL and GSMArena slug. |
| `deviceName` / `brand` | Full device name and manufacturer. |
| `imageUrl` | Product image URL. |
| `released` / `status` | Release date and current availability status. |
| `displaySize` / `displayResolution` / `displayType` / `displayProtection` | Screen size, resolution, panel technology, and protective glass/coating. |
| `chipset` / `cpu` / `gpu` | Processor, CPU core layout, and graphics processor. |
| `os` | Operating system and version/skin. |
| `ram` / `storage` / `memorySlot` | RAM capacity, internal storage, and memory-card slot support. |
| `rearCamera` / `rearCameraDetails` | Main rear camera resolution and the full rear camera module specs. |
| `frontCamera` / `frontCameraDetails` | Selfie camera resolution and full front camera specs. |
| `battery` / `batteryDetails` | Battery capacity and full battery/charging details. |
| `network` / `networkTechnology` | Highest supported network generation and the full network band list. |
| `wlan` / `bluetooth` / `nfc` / `usb` / `gps` / `radio` | Connectivity specs. |
| `dimensions` / `weight` / `build` | Physical size, weight, and build materials. |
| `sim` / `bodyOther` | SIM configuration and other body notes. |
| `sensors` | List of onboard sensors. |
| `colors` / `models` | Available color options and regional model numbers. |
| `price` | Suggested or observed retail price, when GSMArena lists one. |
| `scrapedAt` | ISO timestamp of when the record was captured. |

### Input

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | String (select) | `search` | `search`, `deviceDetails`, `byBrand`, or `topDevices`. |
| `searchQuery` | String | `Samsung Galaxy` | Keyword to search for (mode=search). |
| `osFilter` | String (select) | – | Filter by operating system: Android, iOS, feature phones, KaiOS, Windows Phone, Symbian, BlackBerry, Bada, or Firefox OS (mode=search). |
| `availability` | String (select) | – | Filter by availability: Available, Coming soon, Discontinued, or Rumored (mode=search). |
| `sortBy` | String (select) | `0` (Popularity) | Sort order: Popularity, Price, Weight, Camera resolution, or Battery capacity (mode=search and topDevices). |
| `deviceUrl` | String | – | Full device URL or slug (mode=deviceDetails). |
| `brandSlug` | String | – | Brand slug to list, e.g. `apple`, `xiaomi`, `google` (mode=byBrand). |
| `maxItems` | Integer | 20 | Maximum number of device records to return. |

#### Example: search Android phones sorted by battery capacity

```json
{
  "mode": "search",
  "searchQuery": "Galaxy",
  "osFilter": "2",
  "sortBy": "4",
  "maxItems": 30
}
```

#### Example: full spec sheet for one device

```json
{
  "mode": "deviceDetails",
  "deviceUrl": "samsung_galaxy_s25_ultra-12610"
}
```

#### Example: every current device from a brand

```json
{
  "mode": "byBrand",
  "brandSlug": "xiaomi",
  "maxItems": 100
}
```

### Use cases

- **Tech comparison sites** pulling spec sheets for review articles and comparison tables.
- **E-commerce catalogs** enriching phone listings with authoritative display, camera and battery specs.
- **Market researchers** tracking which chipsets, display types or camera resolutions ship across a brand's lineup.
- **App and accessory developers** building device-compatibility matrices from dimensions, SIM type and connectivity data.
- **Price trackers** monitoring suggested retail prices across a large set of devices.

### FAQ

**Is GSMArena's data public?**
Yes. This actor reads the same specification pages GSMArena publishes openly to any visitor, without an account or login.

**Why does a `search` or `byBrand` record have fewer fields than `deviceDetails`?**
Search and brand-listing pages only show a brief spec summary per device. To get the complete spec sheet for a device, run `deviceDetails` on that device's URL or slug.

**How current is the device catalog?**
GSMArena typically adds new devices within days of their announcement, and this actor reads the live catalog on each run.

**Does this cover older or discontinued phones?**
Yes, GSMArena's archive spans from early feature phones to current flagships; use the `availability` filter to narrow to Discontinued or Rumored devices specifically.

**What's the best way to collect every device from one manufacturer?**
Use `byBrand` with that brand's slug and a high `maxItems`; large manufacturers can have over a thousand devices across their history.

**Why might `price` be missing from a device record?**
GSMArena only lists a price when one has been reported for that device; without one, the field is omitted.

**Is this affiliated with GSMArena?**
No. This is an independent tool and is not affiliated with, endorsed by, or sponsored by GSMArena.

# Actor input Schema

## `mode` (type: `string`):

What to scrape.

## `searchQuery` (type: `string`):

Free-text search (mode=search). Example: `Samsung Galaxy S25`.

## `osFilter` (type: `string`):

Filter by operating system (mode=search).

## `availability` (type: `string`):

Filter by device availability (mode=search).

## `sortBy` (type: `string`):

Sort search results (mode=search and mode=topDevices).

## `deviceUrl` (type: `string`):

Full URL or slug for mode=deviceDetails. Example: `samsung_galaxy_s25_ultra-12610` or `https://www.gsmarena.com/samsung_galaxy_s25_ultra-12610.php`.

## `brandSlug` (type: `string`):

Brand slug for mode=byBrand. Example: `samsung`, `apple`, `xiaomi`, `google`, `huawei`, `sony`, `nokia`, `motorola`, `oneplus`, `realme`, `honor`, `oppo`, `vivo`, `lenovo`.

## `maxItems` (type: `integer`):

Maximum number of device records to return.

## Actor input object example

```json
{
  "mode": "search",
  "searchQuery": "Samsung Galaxy",
  "osFilter": "",
  "availability": "",
  "sortBy": "0",
  "deviceUrl": "samsung_galaxy_s25_ultra-12610",
  "brandSlug": "samsung",
  "maxItems": 20
}
```

# Actor output Schema

## `devices` (type: `string`):

Dataset containing all scraped GSMArena device records.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "searchQuery": "Samsung Galaxy",
    "osFilter": "",
    "availability": "",
    "sortBy": "0",
    "deviceUrl": "samsung_galaxy_s25_ultra-12610",
    "brandSlug": "samsung",
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("vexaloom-labs/gsmarena-device-database-and-spec-sheet-extractor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "searchQuery": "Samsung Galaxy",
    "osFilter": "",
    "availability": "",
    "sortBy": "0",
    "deviceUrl": "samsung_galaxy_s25_ultra-12610",
    "brandSlug": "samsung",
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("vexaloom-labs/gsmarena-device-database-and-spec-sheet-extractor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchQuery": "Samsung Galaxy",
  "osFilter": "",
  "availability": "",
  "sortBy": "0",
  "deviceUrl": "samsung_galaxy_s25_ultra-12610",
  "brandSlug": "samsung",
  "maxItems": 20
}' |
apify call vexaloom-labs/gsmarena-device-database-and-spec-sheet-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,vexaloom-labs/gsmarena-device-database-and-spec-sheet-extractor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/tpBnVcz24aahTjgPx/builds/wYudlKHiGyDkysZW2/openapi.json
