API cục bộ (Local API) của AdsPower là gì? Dùng để làm gì?

Nếu bạn từng thắc mắc AdsPower có API không, câu trả lời là có — nhưng gọi chính xác là “Local API” (API cục bộ), khác về bản chất với API của các dịch vụ đám mây thông thường. Hiểu đúng khái niệm này là bước đầu tiên trước khi kết nối AdsPower với Selenium, Puppeteer hay Playwright.

Local API của AdsPower là gì?

AdsPower là phần mềm chạy trên máy tính của bạn (desktop app), và các hồ sơ trình duyệt cũng được vận hành ngay trên máy đó — không phải trên máy chủ của AdsPower. Local API là một máy chủ HTTP nhỏ mà ứng dụng AdsPower tự khởi động trên máy bạn mỗi khi đang mở và đăng nhập. Máy chủ này lắng nghe trên một địa chỉ nội bộ (localhost) để các chương trình khác trên cùng máy — hoặc trên mạng nội bộ nếu cấu hình cho phép — gọi vào.

Vì chạy cục bộ, Local API không phải là dịch vụ công khai trên Internet mà ai cũng gọi được. Chỉ chương trình chạy trên đúng máy (hoặc được cấp quyền truy cập mạng nội bộ tới máy đó) mới gọi được, đây cũng là lý do cơ chế này an toàn hơn so với việc lộ API key ra ngoài Internet.

Local API dùng để làm gì?

Về bản chất, Local API cho phép một chương trình khác điều khiển AdsPower một cách tự động thay vì bạn phải bấm chuột thủ công. Các nhóm thao tác phổ biến mà API cho phép gồm:

• Truy vấn danh sách hồ sơ đang có trong tài khoản, kèm thông tin cơ bản của từng hồ sơ.
• Mở và đóng hồ sơ bằng lệnh gọi thay vì bấm nút trên giao diện — đây là thao tác quan trọng nhất cho tự động hoá.
• Lấy thông tin kết nối trình duyệt của một hồ sơ vừa mở, để một công cụ điều khiển trình duyệt bên ngoài (Selenium, Puppeteer, Playwright) có thể bám vào đúng phiên trình duyệt đó và điều khiển tiếp.
• Tạo, sửa, xoá hồ sơ theo lô, thay vì tạo tay từng hồ sơ một qua giao diện.
• Quản lý proxy, nhóm hồ sơ gắn với các hồ sơ hiện có.

Tên gọi chính xác, đường dẫn (endpoint) và cấu trúc dữ liệu trả về của từng nhóm thao tác trên được AdsPower công bố đầy đủ trong tài liệu Postman chính thức tại documenter.getpostman.com/view/45822952/2sB34hEzQH. Bài này không liệt kê lại các tên đó vì tài liệu gốc là nguồn chính xác nhất và có thể cập nhật theo phiên bản — chép lại sai một tham số ở đây có thể khiến script của bạn chạy sai mà không rõ vì sao.

Cần bậc giá nào để dùng API?

Đây là điều cần biết trước khi bạn dành thời gian viết script, vì không phải bậc giá nào cũng mở tính năng này. Theo bảng tính năng trên trang giá chính hãng (kiểm tra trực tiếp ngày 25/07/2026):

Bậc giá	Có Local API?	Giới hạn tốc độ gọi
Free	Không	—
Professional	Có	120 lần/phút
Business	Có	300 lần/phút
Enterprise	Có	600 lần/phút

Nguồn: adspower.com/vn/pricing (bảng tính năng, dòng “API cục bộ”) và adspower.com/pricing (dòng “Local API”). Nếu bạn đang dùng gói Free và định viết script tự động hoá, bạn sẽ cần nâng lên tối thiểu bậc Professional trước — giá niêm yết 200.000đ/tháng, hoặc 160.000đ/tháng nếu trả theo năm, xem chi tiết tại trang AdsPower và bảng giá.

Giới hạn tốc độ gọi (rate limit) quan trọng với người viết script vòng lặp: nếu bạn tạo hàng loạt hồ sơ hoặc mở nhiều hồ sơ liên tiếp mà không có độ trễ giữa các lần gọi, bạn sẽ chạm trần rất nhanh ở bậc Professional. Xem cách xử lý cụ thể tại bài xử lý khi chạm trần giới hạn tốc độ gọi API AdsPower.

Cách bật Local API

Local API đi kèm sẵn trong ứng dụng AdsPower, không phải tính năng phải cài thêm hay đăng ký riêng. Về nguyên tắc chung, việc bật/tắt và cấu hình (địa chỉ, cổng, khoá xác thực nếu có) nằm ở một mục cấu hình chung của ứng dụng — tên mục và vị trí chính xác trong giao diện có thể thay đổi giữa các bản cập nhật, nên bài này không mô tả từng bước bấm chuột cụ thể để tránh sai lệch khi AdsPower cập nhật giao diện. Cách xác nhận nhanh nhất là mở ứng dụng đang chạy và tìm mục liên quan đến “API” trong phần cài đặt, đối chiếu với hướng dẫn bật API mới nhất trong tài liệu chính hãng.

Sau khi bật, ứng dụng AdsPower phải luôn đang mở và đăng nhập thì Local API mới hoạt động — đây khác với API đám mây, không có API nào chạy được nếu AdsPower đang tắt trên máy đó.

Luồng hoạt động chung khi kết nối với công cụ tự động hoá

Dù bạn dùng Selenium, Puppeteer hay Playwright, luồng làm việc tổng quát đều giống nhau:

1. Đảm bảo AdsPower đang mở, đã đăng nhập, và tài khoản ở bậc Professional trở lên.
2. Gọi Local API để yêu cầu mở một hồ sơ cụ thể. Phản hồi trả về thông tin kết nối của trình duyệt vừa mở (thường là địa chỉ/cổng gỡ lỗi mà trình duyệt đang lắng nghe).
3. Dùng thông tin kết nối đó để “gắn” công cụ điều khiển trình duyệt (Selenium/Puppeteer/Playwright) vào đúng phiên trình duyệt đang chạy, thay vì để công cụ tự mở một trình duyệt mới không có dấu vân tay của AdsPower.
4. Điều khiển trình duyệt như bình thường: điều hướng, click, nhập liệu, đọc dữ liệu trang.
5. Gọi Local API để đóng hồ sơ khi xong việc, giải phóng tài nguyên máy.

Cơ chế “gắn vào trình duyệt đang chạy” ở bước 3 là kỹ thuật tiêu chuẩn của các framework tự động hoá trình duyệt (không riêng gì AdsPower), thường gọi là kết nối qua giao thức gỡ lỗi từ xa (remote debugging). Xem cách áp dụng cụ thể cho từng framework tại các bài:

• Kết nối Selenium Python với AdsPower
• Kết nối Puppeteer Node.js với AdsPower
• Kết nối Playwright với AdsPower

API có phải lựa chọn duy nhất để tự động hoá không?

Không. Nếu bạn không biết lập trình, AdsPower có công cụ RPA dựng sẵn (kéo thả, không cần viết mã) và có ở mọi bậc giá, kể cả gói Free. API chỉ cần thiết khi bạn muốn tích hợp AdsPower vào một hệ thống riêng của mình (ví dụ tự động tạo hồ sơ khi có đơn hàng mới trong CRM), hoặc cần logic phức tạp mà công cụ kéo thả không đáp ứng được. So sánh hai hướng đi tại bài chọn giữa RPA dựng sẵn và tự viết script cho AdsPower, hoặc tìm hiểu riêng về RPA tại bài RPA dựng sẵn của AdsPower cho người không biết code.

Khi nào nên xem tài liệu chính hãng thay vì bài này?

Ngay khi bạn cần một tên endpoint, tên tham số, hoặc cấu trúc JSON phản hồi cụ thể để đưa vào code thật. Tài liệu Postman tại documenter.getpostman.com/view/45822952/2sB34hEzQH là nguồn duy nhất đáng tin cho các chi tiết này, vì được chính đội ngũ AdsPower cập nhật theo từng phiên bản phần mềm.