{
  "openapi": "3.0.1",
  "info": {
    "title": "GSMArena Phone Specs Scraper: Filters, Prices and New Launches",
    "description": "Scrape GSMArena phone, tablet and watch specs with screen, RAM, storage, battery and cameras as numbers. Filter by specs, search by name or brand, add store prices and track new launches and changes. Export CSV, Excel or JSON. No API key. Filtered devices cost nothing. Not affiliated with GSMArena.",
    "version": "0.1",
    "x-build-id": "dTtt96T724qzJbKNU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/getascraper~gsmarena-phone-specs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-getascraper-gsmarena-phone-specs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/getascraper~gsmarena-phone-specs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-getascraper-gsmarena-phone-specs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/getascraper~gsmarena-phone-specs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-getascraper-gsmarena-phone-specs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "What to read",
            "enum": [
              "newest",
              "popular",
              "search",
              "brands",
              "urls"
            ],
            "type": "string",
            "description": "Newest: the newest device pages first, the way to follow launches. Most popular: the site's own daily interest ranking. Search: devices whose name matches your search terms. Brands: whole brand catalogs, newest first. Links only: just the pages you list under Start URLs.",
            "default": "newest"
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Device names such as \"Galaxy S25\" or \"Pixel 10 Pro\". Every word of a term must appear in the brand, the device name or its common spellings, so \"Galaxy S25\" also finds the S25 Ultra and S25 Edge. Used by Search mode; in Newest and Most popular modes they narrow the list to matching devices.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Brand names (Samsung, Apple, Xiaomi) or brand page links such as https://www.gsmarena.com/samsung-phones-9.php. Brands mode reads each brand's whole catalog, newest first. The other modes keep only devices of these brands.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "GSMArena links for Links only mode: device pages, compare pages (every compared device), price and pictures pages (read as their device) and brand pages (the brand from that page on).",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "deviceTypes": {
            "title": "Device types",
            "type": "array",
            "description": "Keep only these kinds of devices. Leave empty to keep phones, tablets and watches alike.",
            "items": {
              "type": "string",
              "enum": [
                "phone",
                "tablet",
                "watch"
              ],
              "enumTitles": [
                "Phones",
                "Tablets",
                "Watches"
              ]
            },
            "default": []
          },
          "statuses": {
            "title": "Launch status",
            "type": "array",
            "description": "Keep only devices with one of these statuses. Coming soon and rumored devices are the ones whose specs and prices still change.",
            "items": {
              "type": "string",
              "enum": [
                "available",
                "coming-soon",
                "discontinued",
                "cancelled",
                "rumored"
              ],
              "enumTitles": [
                "Available",
                "Coming soon",
                "Discontinued",
                "Cancelled",
                "Rumored"
              ]
            },
            "default": []
          },
          "announcedFromYear": {
            "title": "Announced from year",
            "minimum": 1990,
            "maximum": 2100,
            "type": "integer",
            "description": "Keep devices announced in this year or later."
          },
          "announcedToYear": {
            "title": "Announced up to year",
            "minimum": 1990,
            "maximum": 2100,
            "type": "integer",
            "description": "Keep devices announced in this year or earlier."
          },
          "operatingSystems": {
            "title": "Operating systems",
            "type": "array",
            "description": "Keep only devices that ship with one of these systems.",
            "items": {
              "type": "string",
              "enum": [
                "android",
                "ios",
                "ipados",
                "harmonyos",
                "wearos",
                "watchos",
                "other"
              ],
              "enumTitles": [
                "Android",
                "iOS",
                "iPadOS",
                "HarmonyOS",
                "Wear OS",
                "watchOS",
                "Other systems"
              ]
            },
            "default": []
          },
          "chipsetKeywords": {
            "title": "Chipset contains",
            "type": "array",
            "description": "Keep devices whose chipset name contains one of these words, such as \"Snapdragon 8\", \"Dimensity\" or \"Tensor\". Case does not matter.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minRamGb": {
            "title": "Minimum RAM",
            "minimum": 0,
            "maximum": 1024,
            "type": "number",
            "description": "Keep devices whose largest memory variant has at least this much RAM."
          },
          "minStorageGb": {
            "title": "Minimum storage",
            "minimum": 0,
            "maximum": 65536,
            "type": "number",
            "description": "Keep devices whose largest variant has at least this much built-in storage. 1 TB is 1024 GB."
          },
          "minBatteryMah": {
            "title": "Minimum battery",
            "minimum": 0,
            "maximum": 100000,
            "type": "number",
            "description": "Keep devices whose battery holds at least this much."
          },
          "minDisplayInches": {
            "title": "Minimum screen size",
            "minimum": 0,
            "maximum": 50,
            "type": "number",
            "description": "Keep devices whose main screen is at least this large, measured diagonally."
          },
          "maxDisplayInches": {
            "title": "Maximum screen size",
            "minimum": 0,
            "maximum": 50,
            "type": "number",
            "description": "Keep devices whose main screen is at most this large, for example 6.3 for compact phones."
          },
          "maxWeightGrams": {
            "title": "Maximum weight",
            "minimum": 0,
            "maximum": 10000,
            "type": "number",
            "description": "Keep devices that weigh at most this much."
          },
          "minRefreshRateHz": {
            "title": "Minimum refresh rate",
            "minimum": 0,
            "maximum": 1000,
            "type": "number",
            "description": "Keep devices whose screen refreshes at least this fast, for example 120 for smooth-scrolling screens."
          },
          "minMainCameraMp": {
            "title": "Minimum main camera",
            "minimum": 0,
            "maximum": 1000,
            "type": "number",
            "description": "Keep devices whose best rear camera has at least this many megapixels."
          },
          "require5g": {
            "title": "5G",
            "type": "boolean",
            "description": "Keep only devices that support 5G networks.",
            "default": false
          },
          "requireNfc": {
            "title": "NFC",
            "type": "boolean",
            "description": "Keep only devices with NFC, for contactless payments.",
            "default": false
          },
          "requireEsim": {
            "title": "eSIM",
            "type": "boolean",
            "description": "Keep only devices that take an eSIM.",
            "default": false
          },
          "requireHeadphoneJack": {
            "title": "3.5 mm headphone jack",
            "type": "boolean",
            "description": "Keep only devices with a 3.5 mm headphone jack.",
            "default": false
          },
          "requireCardSlot": {
            "title": "Memory card slot",
            "type": "boolean",
            "description": "Keep only devices with a memory card slot.",
            "default": false
          },
          "requireWirelessCharging": {
            "title": "Wireless charging",
            "type": "boolean",
            "description": "Keep only devices that charge wirelessly.",
            "default": false
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "maximum": 100000000,
            "type": "number",
            "description": "Keep devices that cost at least this much in the currency below."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "maximum": 100000000,
            "type": "number",
            "description": "Keep devices that cost at most this much in the currency below."
          },
          "priceCurrency": {
            "title": "Price currency",
            "enum": [
              "EUR",
              "USD",
              "GBP",
              "INR"
            ],
            "type": "string",
            "description": "The currency the price limits are in. GSMArena gives most launch estimates in euros, so euros match the most devices; with another currency, a device priced only in euros does not pass.",
            "default": "EUR"
          },
          "includeStorePrices": {
            "title": "Add store prices",
            "type": "boolean",
            "description": "Adds the per-store price table to each device that has store offers: region, store, memory variant, price, currency and offer count. It reads one more page per such device and is billed as an add-on for each row that gets the table.",
            "default": false
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "How many devices to save. The default keeps a first run short; raise it to collect whole catalogs.",
            "default": 20
          },
          "maxDevicesChecked": {
            "title": "Max device pages read",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "How many device pages one run may read at most. Filters and the changes-only option can pass over devices after reading them, so this caps how long a run takes. It is never lower than Max results.",
            "default": 100
          },
          "onlyNewOrChanged": {
            "title": "Only new or changed devices",
            "type": "boolean",
            "description": "Save only devices that are new to the monitor or changed since its last run. Turns the monitor on even without a monitor name.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "maxLength": 30,
            "type": "string",
            "description": "A name for the monitor's memory, so separate schedules keep separate histories. Setting a name turns the monitor on. Letters, digits and dashes, up to 30 characters. Leave it empty with the option above ticked to get a name made from your settings."
          },
          "trackedChanges": {
            "title": "Changes to track",
            "type": "array",
            "description": "Which changes make a device UPDATED: launch status and dates, the spec sheet (each section separately) and prices.",
            "items": {
              "type": "string",
              "enum": [
                "status",
                "specs",
                "prices"
              ],
              "enumTitles": [
                "Launch status and dates",
                "Spec sheet",
                "Prices"
              ]
            },
            "default": [
              "status",
              "specs",
              "prices"
            ]
          },
          "notificationWebhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "An HTTPS address that receives a short JSON summary when the run ends: the counts, the first saved devices and a link to the results. Local and private addresses are refused. The address is kept with the run input like every other field, so use a webhook link you can replace."
          },
          "notifyOnNoChanges": {
            "title": "Notify when nothing was saved",
            "type": "boolean",
            "description": "Also send the webhook summary when the run saved no rows.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "The default Apify Proxy setting works for this site. Change it only to use your own proxies.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}