ADSSPEEDADSSPEED← Quay về trang chính

Tài liệu API cục bộ ADSSPEED

Điều khiển toàn bộ hồ sơ, proxy, trình duyệt và tự động hoá của ADSSPEED qua HTTP API cục bộ — tương thích cách dùng của AdsPower/Hidemium. Mở API trong Cài đặt → API & Tích hợp, sao chép khoá, rồi gọi các đường dẫn dưới đây.

Base URL

http://127.0.0.1:19555

Xác thực

X-API-Key: <khoá>  hoặc  ?key=<khoá>

Định dạng trả về

{ "code": 0, "data": {…}, "msg": "success" } — code=0 là thành công.

Giới hạn nhịp

Các lệnh nặng (browser/start, dcom/rotate) tối đa 1 lệnh/giây.

Hồ sơ

GET/api/v1/profile/list

Liệt kê hồ sơ

Trả danh sách hồ sơ, có phân trang và lọc theo tên/nhóm.

Tham sốVị tríBắt buộcMô tả
searchquery—Từ khoá lọc theo tên/ghi chú/tag.
groupquery—Lọc theo tên nhóm.
pagequery—Trang (mặc định 1).
page_sizequery—Số hồ sơ mỗi trang (1–500, mặc định 100).
Ví dụ
curl "http://127.0.0.1:19555/api/v1/profile/list?key=API_KEY"
GET/api/v1/profile/detail

Chi tiết hồ sơ

Lấy toàn bộ thông tin một hồ sơ: vân tay, proxy, trạng thái.

Tham sốVị tríBắt buộcMô tả
profile_idquerycóID hồ sơ cần xem.
Ví dụ
curl "http://127.0.0.1:19555/api/v1/profile/detail?key=API_KEY&profile_id=123"
POST/api/v1/profile/create

Tạo hồ sơ

Tạo hồ sơ mới, vân tay sinh tự động theo OS/trình duyệt.

Tham sốVị tríBắt buộcMô tả
namebodycóTên hồ sơ.
osbody—Windows / macOS / Linux / iOS / Android (mặc định Windows).
browserbody—Chrome / Safari / Edge… (mặc định Chrome).
groupbody—Nhóm gán vào.
notebody—Ghi chú.
tagsbody—Nhãn, phân cách dấu phẩy.
proxybody—Object {type,host,port,user,pass} hoặc chuỗi "ip:port:user:pass".
proxy_groupbody—Tên nhóm proxy — tự lấy lần lượt 1 IP trong nhóm.
browser_buildbody—Số hiệu lõi trình duyệt (vd 151).
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/profile/create" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Acc 01","os":"Windows","browser":"Chrome","proxy":"1.2.3.4:8000:user:pass"}'
POST/api/v1/profile/update

Cập nhật hồ sơ

Sửa thông tin hồ sơ (tên, ghi chú, tag, nhóm, proxy).

Tham sốVị tríBắt buộcMô tả
profile_idbodycóID hồ sơ.
namebody—Tên mới.
notebody—Ghi chú mới.
tagsbody—Nhãn mới.
groupbody—Nhóm mới.
proxybody—Proxy mới (object hoặc chuỗi).
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/profile/update" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{ ... }'
POST/api/v1/profile/delete

Xoá hồ sơ

Xoá một hoặc nhiều hồ sơ theo danh sách ID.

Tham sốVị tríBắt buộcMô tả
profile_idsbodycóMảng ID hồ sơ cần xoá (cũng nhận profile_id đơn).
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/profile/delete" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{"profile_ids":[123,124]}'
POST/api/v1/profile/duplicate

Nhân bản hồ sơ

Tạo bản sao hồ sơ — vân tay mới, giữ cấu hình.

Tham sốVị tríBắt buộcMô tả
profile_idbodycóID hồ sơ nguồn.
countbody—Số bản sao (mặc định 1).
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/profile/duplicate" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{ ... }'
POST/api/v1/profile/regenerate-fingerprint

Sinh lại vân tay

Thay vân tay mới, giữ nguyên proxy/cookie.

Tham sốVị tríBắt buộcMô tả
profile_idbodycóID hồ sơ.
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/profile/regenerate-fingerprint" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{ ... }'

Trình duyệt

GET/api/v1/browser/start 1 lệnh/giây

Mở trình duyệt

Khởi động trình duyệt của hồ sơ, trả cổng điều khiển CDP để tự động hoá.

Tham sốVị tríBắt buộcMô tả
profile_idquerycóID hồ sơ cần mở.
Ví dụ
curl "http://127.0.0.1:19555/api/v1/browser/start?key=API_KEY&profile_id=123"
GET/api/v1/browser/stop

Đóng trình duyệt

Đóng trình duyệt đang chạy của hồ sơ.

Tham sốVị tríBắt buộcMô tả
profile_idquerycóID hồ sơ cần đóng.
Ví dụ
curl "http://127.0.0.1:19555/api/v1/browser/stop?key=API_KEY&profile_id=123"
GET/api/v1/browser/active

Trình duyệt đang chạy

Danh sách hồ sơ đang mở kèm cổng CDP.

Không cần tham số (ngoài khoá API).

Ví dụ
curl "http://127.0.0.1:19555/api/v1/browser/active?key=API_KEY"
GET/api/v1/browser/list

Trạng thái trình duyệt

Trạng thái mở/đóng của các hồ sơ.

Không cần tham số (ngoài khoá API).

Ví dụ
curl "http://127.0.0.1:19555/api/v1/browser/list?key=API_KEY"
POST/api/v1/browser/clear-cache

Xoá cache

Xoá cache trình duyệt của hồ sơ (giữ cookie/đăng nhập).

Tham sốVị tríBắt buộcMô tả
profile_idbodycóID hồ sơ.
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/browser/clear-cache" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{ ... }'

Nhóm hồ sơ

GET/api/v1/group/list

Danh sách nhóm

Liệt kê các nhóm hồ sơ.

Không cần tham số (ngoài khoá API).

Ví dụ
curl "http://127.0.0.1:19555/api/v1/group/list?key=API_KEY"
POST/api/v1/group/assign

Gán nhóm

Gán hồ sơ vào một nhóm.

Tham sốVị tríBắt buộcMô tả
profile_idsbody—Mảng ID hồ sơ.
groupbody—Tên nhóm.
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/group/assign" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{ ... }'
POST/api/v1/group/rename

Đổi tên nhóm

Đổi tên một nhóm hồ sơ.

Tham sốVị tríBắt buộcMô tả
oldbody—Tên cũ.
newbody—Tên mới.
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/group/rename" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{ ... }'
POST/api/v1/group/delete

Xoá nhóm

Xoá nhóm — hồ sơ bên trong chuyển về không nhóm.

Tham sốVị tríBắt buộcMô tả
groupbodycóTên nhóm cần xoá.
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/group/delete" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{"group":"Farm A"}'

Proxy

GET/api/v1/proxy/list

Danh sách proxy

Liệt kê kho proxy đã lưu.

Không cần tham số (ngoài khoá API).

Ví dụ
curl "http://127.0.0.1:19555/api/v1/proxy/list?key=API_KEY"
POST/api/v1/proxy/import

Nhập proxy

Nhập proxy hàng loạt vào kho.

Tham sốVị tríBắt buộcMô tả
proxiesbodycóMảng, hoặc chuỗi nhiều dòng "ip:port:user:pass".
groupbody—Nhóm proxy để gán.
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/proxy/import" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{"proxies":["1.2.3.4:8000:u:p","5.6.7.8:8000:u:p"],"group":"US-Res"}'
POST/api/v1/proxy/assign

Gán proxy

Gán proxy cho các hồ sơ.

Tham sốVị tríBắt buộcMô tả
profile_idsbodycóMảng ID hồ sơ.
proxy_idsbodycóMảng ID proxy.
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/proxy/assign" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{"profile_ids":[123],"proxy_ids":[7]}'

Nhóm proxy

GET/api/v1/proxy/group/list

Nhóm proxy

Liệt kê các nhóm proxy.

Không cần tham số (ngoài khoá API).

Ví dụ
curl "http://127.0.0.1:19555/api/v1/proxy/group/list?key=API_KEY"
GET/api/v1/proxy/group/detail

Chi tiết nhóm proxy

Xem các proxy trong một nhóm.

Tham sốVị tríBắt buộcMô tả
namequerycóTên nhóm proxy.
Ví dụ
curl "http://127.0.0.1:19555/api/v1/proxy/group/detail?key=API_KEY&name=US-Res"
POST/api/v1/proxy/group/assign

Gán vào nhóm proxy

Đưa proxy vào một nhóm.

Tham sốVị tríBắt buộcMô tả
proxy_idsbodycóMảng ID proxy.
groupbody—Tên nhóm.
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/proxy/group/assign" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{ ... }'

DCOM / 4G

GET/api/v1/dcom/list

Danh sách DCOM

Liệt kê thiết bị DCOM/modem 4G để xoay IP.

Không cần tham số (ngoài khoá API).

Ví dụ
curl "http://127.0.0.1:19555/api/v1/dcom/list?key=API_KEY"
GET/api/v1/dcom/rotate 1 lệnh/giây

Xoay IP DCOM

Đổi IP của một DCOM theo tên.

Tham sốVị tríBắt buộcMô tả
namequerycóTên DCOM cần xoay IP.
Ví dụ
curl "http://127.0.0.1:19555/api/v1/dcom/rotate?key=API_KEY&name=DCOM-1"

Tiện ích

GET/api/v1/extension/list

Danh sách tiện ích

Liệt kê tiện ích (extension) trong kho.

Không cần tham số (ngoài khoá API).

Ví dụ
curl "http://127.0.0.1:19555/api/v1/extension/list?key=API_KEY"

Cấu hình

GET/api/v1/config/list

Danh sách cấu hình

Liệt kê cấu hình vân tay mẫu đã lưu.

Không cần tham số (ngoài khoá API).

Ví dụ
curl "http://127.0.0.1:19555/api/v1/config/list?key=API_KEY"
GET/api/v1/config/detail

Chi tiết cấu hình

Xem một cấu hình mẫu.

Tham sốVị tríBắt buộcMô tả
config_idquerycóID cấu hình.
Ví dụ
curl "http://127.0.0.1:19555/api/v1/config/detail?key=API_KEY&config_id=5"
POST/api/v1/config/apply

Áp cấu hình

Áp một cấu hình mẫu lên hồ sơ.

Tham sốVị tríBắt buộcMô tả
config_idbodycóID cấu hình.
profile_idsbody—Mảng ID hồ sơ áp vào.
Ví dụ
curl -X POST "http://127.0.0.1:19555/api/v1/config/apply" \
  -H "X-API-Key: API_KEY" -H "Content-Type: application/json" \
  -d '{"config_id":5,"profile_ids":[123,124]}'

© ADSSPEED — Antidetect Browser. Tài liệu API cục bộ v1. Khoá API chỉ dùng trên máy của bạn (127.0.0.1), không chia sẻ ra ngoài.