GSMArena API (gsmarena.com)

GSMArena phone specification and finder. This project is still in early development.

The API basically reads from GSMArena website and results JSON data.

Table of Contents

• Implemented Features
• Online Demo
• Documentation
• Quick Start
• Endpoints
• Proxy
• Contact
• License

Implemented Features

• Get all brands
• Get devices by brand
• Get device specification
• Find devices by keyword
• Top of devices
• Hot deals
• Glossary
• Glossary detail
• Find devices by advanced filters
• News
• Reviews

Online Demo

• Brand list
• Device list by brand
• Device detail
• Searching for device
• Top
• Deals
• Glossary
• Glossary detail

Documentation

Click here to view the Swagger UI documentation

Quick Start

npm install
npm start

Endpoints

Brand list

Endpoint /brands

[
  {
    "name": "Apple",
    "devices": "98",
    "url": "apple-phones-48"
  }
]

Device list by brand

Endpoint /brand/:brand, example /brand/apple-phones-48

{
  "data": [
    {
      "name": "iPhone 13 Pro Max",
      "img": "https://fdn2.gsmarena.com/vv/bigpic/apple-iphone-13-pro-max.jpg",
      "url": "apple_iphone_13_pro_max-11089",
      "description": "Apple iPhone 13 Pro Max smartphone. Announced Sep 2021..."
    }
  ],
  "pages": [
    {
      "number": 1,
      "active": true
    },
    {
      "number": 2,
      "url": "apple-phones-f-48-0-p2"
    }
  ],
  "next": "apple-phones-f-48-0-p2"
}

Device detail

Endpoint /device/:device, example /device/apple_iphone_13_pro_max-11089

{
  "title": "Apple iPhone 13 Pro Max",
  "img": "https://fdn2.gsmarena.com/vv/bigpic/apple-iphone-13-pro-max.jpg",
  "img_url": "apple_iphone_13_pro_max-pictures-11089.php",
  "quick_spec": [
    {
      "name": "Display size",
      "value": "6.7\""
    }
  ],
  "spec_detail": [
    {
      "category": "Network",
      "specs": [
        {
          "name": "Technology",
          "value": "GSM / CDMA / HSPA / EVDO / LTE / 5G"
        }
      ]
    }
  ]
}

Searching for device

Endpoint /search/:device, example /search/casio

[
  {
    "name": "Casio G'zOne CA-201L",
    "img": "https://fdn2.gsmarena.com/vv/bigpic/casio-gzone-ca-201l.jpg",
    "url": "casio_g_zone_ca_201l-5384",
    "description": "Casio G'zOne CA-201L Android smartphone. Announced Mar 2013..."
  }
]

Top

Endpoint /top

[
  {
    "category": "Top 10 by daily interest",
    "list": [
      {
        "position": "1",
        "name": "Xiaomi 12",
        "url": "xiaomi_12-11285",
        "daily_hits": "50,330"
      }
    ]
  }
]

Deals

Endpoint /deals

[
  {
    "image": "https://m.media-amazon.com/images/I/31ICm7rK-hS._SL500_.jpg",
    "url": "https://www.amazon.co.uk/dp/B08V1NKHZF?tag=gsmcom-21&linkCode=osi&th=1&psc=1",
    "title": "OnePlus 9",
    "link": "oneplus_9-10747",
    "description": "OnePlus 9 5G (UK) SIM-Free Smartphone with Hasselblad Camera for Mobile - Arctic Sky...",
    "deal": {
      "memory": "128GB 8GB RAM",
      "store_img": "https://fdn.gsmarena.com/imgroot/static/stores/amazon-uk1.png",
      "price": "£ 449.00",
      "discount": "24.6"
    },
    "history": [
      {
        "time": "Previous",
        "price": "£ 479.00"
      }
    ]
  }
]

Glossary

Endpoint /glossary

[
  {
    "letter": "X",
    "list": [
      {
        "link": "xenon-flash",
        "name": "Xenon flash"
      }
    ]
  }
]

Glossary detail

Endpoint /glossary/:term, example /glossary/xenon-flash

{
  "title": "Xenon flash - definition",
  "html": "<p>A xenon flash produces an extremely intense full-spectrum white...</p>"
}

Proxy

If you want to use proxy add a constant HTTP_PROXY in .env file or HTTPS_PROXY if you use https

Contact

Created by @nordmarin - feel free to contact me!

License

GSMArena API is MIT licensed.