API

Hỗ trợ người dùng thao tác với các tính năng của GemLogin thông qua API.

Để truy cập vào tài liệu trên tool, bạn có thể bấm vào nút API để hiển thị các request có thể thực hiện khi Gemlogin đang được mở.

Servers: Mặc định là http://localhost:1010 – Đây là địa chỉ local mà API đang hoạt động.

GemLogin hỗ trợ các request sau:

versions

Lấy danh sách browser được cài

curl -X 'GET' \
  'http://localhost:1010/api/browser_versions' \
  -H 'accept: application/json'

Request này sẽ trả về kết quả dưới dạng json như sau, dưới dạng json:

{
  "success": true,
  "message": "OK",
  "data": [
    {
      "id": 1,
      "version": "128"
    }
  ]
}

groups

Lấy danh sách groups

curl -X 'GET' \
  'http://localhost:1010/api/groups' \
  -H 'accept: application/json'

Request này trả về kết quả có danh sách group như sau:

{
  "success": true,
  "message": "OK",
  "data": [
    {
      "id": 1,
      "name": "Group1",
      "created_at": "2025-04-07 09:22:38.788 +00:00",
      "updated_at": "2025-04-07 09:22:38.788 +00:00",
      "sort": 1,
      "created_by": -1
    },
    {
      "id": 2,
      "name": "Group2",
      "created_at": "2025-04-07 09:22:45.503 +00:00",
      "updated_at": "2025-04-07 09:22:45.503 +00:00",
      "sort": 1,
      "created_by": -1
    }
  ]
}

profiles

Lấy thông tin profile có id được chỉ định

curl -X 'GET' \
  'http://localhost:1010/api/profiles/delete/{profileId}' \
  -H 'accept: application/json'

Request này yêu cầu chỉ định profile id cần xóa, sẽ trả về kết quả như sau nếu xóa thành công:

{
  "success": true,
  "message": "Xóa thành công",
  "data": null
}

Mở profile được chỉ định

curl -X 'GET' \
  'http://localhost:1010/api/profiles/start/{profileId}?addination_args={args}&win_pos={browserPosition}&win_size={browserSize}&win_scale={browserScale}' \
  -H 'accept: application/json'

Request này sẽ mở profile được chỉ định. Các tham số yêu cầu trong request như sau:

Name

Description

ID của profile cần start

addination_args

Tham số dùng để khởi động, tham số cần tách nhau bởi khoảng trống

win_pos

Vị trí của browser ở định dạng x,y

win_size

Kích thước của cửa sổ theo định dạng chiều rộng, chiều cao

win_scale

Tỉ lệ scale của cửa sổ trình duyệt

Request trả về kết quả như sau:

{
  "success": true,
  "message": "OK",
  "data": {
    "success": true,
    "profile_id": 23,
    "browser_location": "C:\\Users\\dell\\.gemlogin\\browser\\133\\Chrome-bin\\chrome.exe",
    "remote_debugging_address": "127.0.0.1:56170",
    "driver_path": "C:\\Users\\dell\\.gemlogin\\browser\\133\\Chrome-bin\\gemlogindriver.exe"
  }
}

Đóng profile được chỉ định

curl -X 'GET' \
  'http://localhost:1010/api/profiles/close/1' \
  -H 'accept: application/json'

Request này sẽ thực hiện việc đóng cửa sổ trình duyệt có profile id được chỉ định đang được mở. Request cần truyền vào id của profile cần được đóng. Kết quả trả về sẽ như sau:

{
  "message": "Close profile success",
  "success": true
}

Cập nhật thông tin profile chỉ định

curl -X 'POST' \
  'http://localhost:1010/api/profiles/update/23' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "profile_name": "Demo23",
  "group_id": 1,
  "raw_proxy": "192.168.0.5:5050",
  "startup_url": "https://www.youtube.com",
  "note": "This is a sample note",
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36",
  "browser_version": "133",
  "web_rtc": "noise",
  "language": "vi,en",
  "time_zone": "Asia/Bangkok",
  "country": "Vietnam",
  "lat": 30.425078442292502,
  "long": 115.69026310963571,
  "os": {
    "type": "Windows",
    "version": "win10"
  }
}'

Request này thực hiện việc cập nhật thông tin của profile được chỉ định.

Request này yêu cầu chỉ định profile id cần được update thông tin:

Name

Description

profile_id

ID của profile được update.

Đồng thời, thông tin profile được update có thể được chỉ định dưới dạng json như sau:

{
  "profile_name": "Demo23",
  "group_id": 1,
  "raw_proxy": "192.168.0.5:5050",
  "startup_url": "https://www.youtube.com",
  "note": "This is a sample note",
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36",
  "browser_version": "133",
  "web_rtc": "noise",
  "language": "vi,en",
  "time_zone": "Asia/Bangkok",
  "country": "Vietnam",
  "lat": 30.425078442292502,
  "long": 115.69026310963571,
  "os": {
    "type": "Windows",
    "version": "win10"
  }
}

Khi thành công, request sẽ trả về response như sau:

{
  "success": true,
  "message": "Update profile success"
}

Tạo profile mới

curl -X 'POST' \
  'http://localhost:1010/api/profiles/create' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "profile_name": "Test profile 1",
  "group_name": "All",
  "raw_proxy": "",
  "startup_urls": "",
  "is_masked_font": true,
  "is_noise_canvas": false,
  "is_noise_webgl": false,
  "is_noise_client_rect": false,
  "is_noise_audio_context": true,
  "is_random_screen": false,
  "is_masked_webgl_data": true,
  "is_masked_media_device": true,
  "is_random_os": false,
  "os": {
    "type": "Windows",
    "version": "win10"
  },
  "webrtc_mode": 2,
  "browser_version": "133",
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
  "language": "vi,en",
  "time_zone": "Asia/Bangkok",
  "country": "Vietnam",
  "lat": 29.425078442292502,
  "long": 115.69026310963571
}'

Request này sẽ tạo profile mới theo thông số được chỉ định trong body của request. Phần body chứa thông tin được cung cấp có thể bao gồm các thông tin sau:

{
  "profile_name": "Test profile 1",
  "group_name": "All",
  "raw_proxy": "",
  "startup_urls": "",
  "is_masked_font": true,
  "is_noise_canvas": false,
  "is_noise_webgl": false,
  "is_noise_client_rect": false,
  "is_noise_audio_context": true,
  "is_random_screen": false,
  "is_masked_webgl_data": true,
  "is_masked_media_device": true,
  "is_random_os": false,
  "os": {
    "type": "Windows",
    "version": "win10"
  },
  "webrtc_mode": 2,
  "browser_version": "133",
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
  "language": "vi,en",
  "time_zone": "Asia/Bangkok",
  "country": "Vietnam",
  "lat": 29.425078442292502,
  "long": 115.69026310963571
}

Khi thành công, request sẽ trả về kết quả như sau:

{
  "success": true,
  "data": {
    "id": 56,
    "name": "Test profile 1",
    "raw_proxy": "",
    "profile_path": "C:\\Users\\dell\\.gemlogin/profile\\profiles\\56",
    "browser_type": "Chrome",
    "browser_version": "133",
    "note": null,
    "group_id": null,
    "created_at": "2025-04-07T11:07:59.575Z"
  },
  "message": "OK"
}

Lấy thông tin profile

curl -X 'GET' \
  'http://localhost:1010/api/profile/{profileId}' \
  -H 'accept: application/json'

Request này sẽ trả về thông tin của profile có id chỉ định. Kết quả trả về sẽ ở dạng json như sau:

{
  "success": true,
  "message": "OK",
  "data": {
    "id": "23",
    "name": "Demo23",
    "raw_proxy": "http://192.168.0.5:5050",
    "browser_type": "chromium",
    "browser_version": 133,
    "group_id": "1",
    "profile_path": "C:\\Users\\dell\\.gemlogin/profile\\profiles\\23",
    "note": "",
    "created_at": "2025-04-07 10:46:05.922 +00:00"
  }
}

Lấy danh sách profile

curl -X 'GET' \
  'http://localhost:1010/api/profiles?group_id=1&page=1&per_page=50&sort=0' \
  -H 'accept: application/json'

Request này sẽ lấy danh sách profile phù hợp với tham số được truyền vào. Các tham số được liệt kê như sau:

Name

Description

group_id

Group id chứa profile

page

Số phân trang

per_page

Số lượng profile được hiển thị trên mỗi trang

sort

Kiểu sắp xếp được chỉ định (0 = latest, 1 = oldest, 2 = A-Z, 3 = Z-A)

Kết quả trả về sẽ như sau:

{
  "success": true,
  "message": "success",
  "data": [
    {
      "id": 24,
      "name": "1",
      "raw_proxy": "http://146.19.196.101:40604",
      "browser_type": "chromium",
      "browser_version": 132,
      "group_id": "1",
      "profile_path": "C:\\Users\\dell\\.gemlogin/profile\\profiles\\24",
      "note": null,
      "created_at": "2025-04-07 09:22:54.956 +00:00"
    },
    {
      "id": 23,
      "name": "Demo23",
      "raw_proxy": "http://192.168.0.5:5050",
      "browser_type": "chromium",
      "browser_version": 133,
      "group_id": "1",
      "profile_path": "C:\\Users\\dell\\.gemlogin/profile\\profiles\\23",
      "note": "",
      "created_at": "2025-04-07 10:46:05.922 +00:00"
    }
  ]
}

Thay đổi fingerprint của profile

curl -X 'GET' \
  'http://localhost:1010/api/profiles/changeFingerprint?profileIds=28%2C29' \
  -H 'accept: application/json'

Request này thực hiện việc cập nhật fingerprint của profile có id được chỉ định.

Name

Description

profileIds

Danh sách profile id (chuỗi, tách bởi dấu ",")

Khi request thành công, kết quả trả về sẽ như sau:

{
  "success": true,
  "message": "Change fingerprint successfully"
}

scripts

Lấy danh sách script

curl -X 'GET' \
  'http://localhost:1010/api/scripts' \
  -H 'accept: application/json'

Request này sẽ trả về danh sách scripts đang có trong tool. Kết quả trả về sẽ như sau:

{
  "success": true,
  "message": "OK",
  "data": [
    {
      "id": "tIYyrsUWpgNyj2HurAu65",
      "name": "(Youtube) Watch video",
      "parameters": [
        {
          "name": "youtubeLink",
          "label": "label",
          "type": "string",
          "description": "",
          "defaultValue": "",
          "required": false
        }
      ]
    },
    {
      "id": "hRGThZTYLFs_mgbZjA-2W",
      "name": "(Google) Reg account (dailyOtp)",
      "parameters": [
        {
          "name": "lanOption",
          "label": "Tùy chọn ngôn ngữ cho thông tin của tài khoản mới",
          "type": "string",
          "description": "vi|en",
          "defaultValue": "en",
          "required": false
        },
        {
          "name": "dailyOtpToken",
          "label": "DailyOtpToken",
          "type": "string",
          "description": "",
          "defaultValue": "f3fd86cb7e8554542043f7a6e8b1735c0hoKZUZrEvkfbkWE9D0A",
          "required": false
        },
        {
          "name": "gemmmoToken",
          "label": "Gemmmo Token",
          "type": "string",
          "description": "",
          "defaultValue": "sckmsz9lbjcgtvlahtv87g6bcj7v8czot4vhmrt2vjx5ocnnaxaccirr12jbvxkry9keoo1740306129",
          "required": false
        },
        {
          "name": "resultTxtPath",
          "label": "Đường dẫn tới file txt chứa thông tin tài khoản sau reg",
          "type": "string",
          "description": "",
          "defaultValue": "D:\\Reg Gmail\\rg reg gmail acc.txt",
          "required": false
        }
      ]
    },
    {
      "id": "iXLjTLZdD_ghgWlj6U7NP",
      "name": "(hotmail) Reg account",
      "parameters": [
        {
          "name": "newAccountTxtPath",
          "label": "Đường dẫn tới file txt dùng để ghi thông tin account mới tạo",
          "type": "string",
          "description": "",
          "defaultValue": "E:\\gemlogin-scripts\\test-context\\MailX.txt",
          "required": true
        },
        {
          "name": "omoCaptchaApiKey",
          "label": "API Key của OmoCaptcha để giải captcha",
          "type": "string",
          "description": "",
          "defaultValue": "",
          "required": false
        }
      ]
    }
  ]
}

Thực hiện script chỉ định

curl -X 'POST' \
  'http://localhost:1010/api/scripts/execute/tIYyrsUWpgNyj2HurAu65' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "profileId": 23,
  "closeBrowser": true,
  "parameters": {
    "youtubeLink": "https://www.youtube.com/watch?v=6R3isnB85ys"
  }
}'

Request này sẽ thực hiện script có id được chỉ định. Thông tin thực hiện script có thể được chỉ định trong body như sau:

{
  "profileId": 23,
  "closeBrowser": true,
  "parameters": {
    "youtubeLink": "https://www.youtube.com/watch?v=6R3isnB85ys"
  }
}

Khi thành công, kết quả trả về sẽ như sau:

{
    "success": true,
    "id": "tIYyrsUWpgNyj2HurAu65"
}

Lấy trạng thái thực hiện của script

curl -X 'POST' \
  'http://localhost:1010/api/scripts/check-status/tIYyrsUWpgNyj2HurAu65' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "profileId": 23
}'

Request này sẽ trả về trạng thái của script có id được chỉ định với profile có id được chỉ định. Script id được chỉ định trong tham số, còn profile id cần được chỉ định trong body của request:

Name

Description

ID của script cần kiểm tra

{
  "profileId": 23
}

Kết quả trả về sẽ như sau nếu success:

{
  "is_running": true,
  "message": "Script is running"
}

Dừng chạy script đang được thực hiện

curl -X 'POST' \
  'http://localhost:1010/api/scripts/kill-execute/tIYyrsUWpgNyj2HurAu65' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "profileId": 23,
  "closeBrowser": true
}'

Request này sẽ thực hiện dừng script đang được thực hiện trên profile có id được chỉ định.

Name

Description

ID của script đang được thực hiện

{
  "profileId": 23,
  "closeBrowser": true
}

Request sẽ trả về kết quả như sau:

{
  "success": true,
  "message": "Kill excute success"
}

PreviousTài liệu API NextSetup chung

Last updated 1 month ago