Only present on LiveStream services that have preset minute tiers. It lists the minute values accepted by the
minute parameter of action=add.
Sending fewer minutes than the lowest tier returns an error; any other value is rounded DOWN to the nearest tier (above the highest tier it becomes the highest tier). You are charged for the rounded value.
Tên gốc của dịch vụ (trước khi dịch sang tiếng Việt).
description
Mô tả dịch vụ, đã bỏ thẻ HTML.
status
stable, beta, slow, many_errors, die
status_text
Ổn định / Thử nghiệm / Chậm / Nhiều lỗi / Ngừng hoạt động
stable
true chỉ khi trạng thái là stable
platform
Facebook, Tiktok, Youtube, Instagram…
Parameters
Description
key
API Key
action
"add"
service
Service ID
link
Url
quantity
Needed quantity
comments
Comment list separated by \n
minute
Needed minute —
use one of the tiers listed in the minutes
field of action=services.
Any other value is rounded DOWN to the nearest tier; below the lowest tier the order is rejected.
Read-only — lấy bảng giá proxy & báo giá theo loại / số lượng / số ngày TRƯỚC khi mua. Không tạo đơn, không trừ tiền.
Parameters
Description
key
API Key
action
"proxy_prices"
type
Optional — Proxy type: FPT, VNPT, Viettel, 4Gvinaphone, DatacenterA, DatacenterB, DatacenterC, US, V6, GoiViettel, GoiVNPT, GoiFPT, GoiDATACENTER, xoayngay, xoaytuan, xoaythang. Leave empty to get the full price list only.
quantity
Optional — Quantity (default 1)
days
Optional — Number of days (default 1)
Cách tính giá: mỗi prices[price_key] có KEY chính là ngưỡng bậc — chọn ngưỡng lớn nhất ≤ cơ sở
(cơ sở = days, riêng V6 = quantity; xoay* giá phẳng). total = unit_price × quantity × days — đúng bằng số tiền buy_proxy sẽ trừ.
Giá đã áp % theo cấp bậc của API key.
Mua một giấy phép. Tiền trừ vào ví của tài khoản gọi API. Trả về license_key — giao thẳng cho khách của bạn, khách dán vào mục “Đổi giấy phép” trong phần mềm là dùng được.
Parameters
Description
key
API Key
action
"buy_software"
slug
Mã phần mềm, lấy ở software_products. Ví dụ antidetect-browser
Lọc theo che_do_xac_minh để biết gói cần tham số gì:"ma" = gắn mã theo dõi vào web ·
"sdt" = không gắn mã, khai mã cố định ·
"faq" = không gắn mã, câu hỏi tự sinh ·
"map" = địa điểm Google Maps, không cần website.
Mỗi loại có mục riêng ở cột trái.
Parameters
Description
key
API Key
action
"traffic_widget"
domain
Không bắt buộc. Tên miền của chính bạn để phục vụ snippet (giấu nguồn). Xem lưu ý bên dưới.
Returns the tracking snippet to paste before the closing body tag on every landing page of your campaign. The code belongs to your account, so one snippet works for all campaigns.
Không bắt buộc. Nhãn bạn tự đặt cho khách này, để phân biệt các mã.
website
Không bắt buộc. Website sẽ gắn mã này (chỉ để ghi chú).
domain
Không bắt buộc. Tên miền của chính bạn để phục vụ snippet (giấu nguồn).
Tạo một mã tracking riêng cho một khách của bạn. Mọi mã vẫn thuộc tài khoản của bạn; lượt truy cập được quy về chiến dịch theo TÊN MIỀN website, nên mỗi khách chỉ cần mã riêng chứ không cần chiến dịch riêng. Giới hạn: 500 mã đang hoạt động.
Giấu nguồn: lưu ý quan trọng
Nếu bạn truyền "domain", tên miền của bạn phải chuyển tiếp CẢ HAI đường — /widget/service.js và /widget.js —
và phải GIỮ NGUYÊN header Origin. Chúng tôi dựa vào Origin để biết lượt truy cập đến từ website nào; nuốt mất Origin là không quy được về chiến dịch nào cả. Cấu hình nginx và Cloudflare Worker có sẵn trong phần trả về.
bắt buộcPackage ID —
chọn gói có che_do_xac_minh = "sdt" nếu website của bạn
không gắn được mã theo dõi. Loại đó cần thêm vài tham số riêng,
xem mục Traffic không gắn mã.
Gói che_do_xac_minh = "map" là traffic cho địa điểm Google Maps
— không cần website. Tham số riêng ở mục Traffic Google Maps.
url
bắt buộc
Website URL — nên truyền TÊN MIỀN (vd https://tenmien.com).
Chiến dịch phủ cả website, còn URL từng trang khai ở từng từ khoá qua
traffic_add_key. Gói Google Maps thì BỎ TRỐNG — hệ thống tự dựng địa chỉ từ chính địa điểm
bạn chọn. Gửi lên cũng bị ghi đè.
quantity
bắt buộcQuantity
image
không bắt buộc
Image URL. Bỏ trống thì hệ thống tự dựng ảnh thẻ kết quả Google của
trang đích, khách không phải tự lo ảnh nữa.
zone_1
bắt buộc% Quantity (00:00 - 05:59)
zone_2
bắt buộc% Quantity (06:00 - 11:59)
zone_3
bắt buộc% Quantity (12:00 - 17:59)
keywords
không bắt buộcNhập từ khoá NGAY trong lệnh tạo chiến dịch — khỏi phải gọi thêm
traffic_add_key cho từng từ khoá.
Nhận mảng hoặc chuỗi JSON. Mỗi phần tử:
keyword (bắt buộc), budget (bắt buộc, ≥ 1),
url_step2 và image (không bắt buộc).
Áp đúng các chốt như traffic_add_key:
tổng budget không vượt quantity, không trùng từ khoá,
không vượt trần số từ khoá/chiến dịch, và url_step2 phải
cùng tên miền với url chiến dịch.
Từ khoá nào sai chỉ bị bỏ qua và báo lý do —
chiến dịch vẫn được tạo, gọi traffic_add_key bù phần thiếu.
Chiến dịch tạo xong mà chưa chạy?
Hệ thống chỉ giao nhiệm vụ cho từ khoá đã có ảnh minh hoạ trang đích, mà ảnh này
được dựng nền nên mất một lúc. Muốn chạy ngay thì truyền image cho
chiến dịch — từ khoá chưa có ảnh riêng sẽ dùng ảnh chiến dịch. Chắc hơn nữa thì
truyền image cho từng từ khoá.
Tương thích ngược:keywords là tuỳ chọn. Không truyền thì lệnh
chạy y như trước và traffic_add_key vẫn dùng bình thường.
Loại này khác gì loại thường: website của bạn không phải gắn mã theo dõi.
Có hai gói, khác nhau ở cách xác minh và luật lặp lại — chọn đúng gói mới ra
đúng thứ bạn cần.
Hai gói khác nhau ở đâu
Tiêu chí
Gói unique user
Gói kết hợp
Xác minh bằng
Mã cố định bạn tự khai
Câu hỏi hệ thống tự sinh từ nội dung trang, mỗi lượt một câu khác
Lặp lại
Mỗi người 1 lượt duy nhất cho mỗi tên miền, trọn đời
Lặp lại được sau 24 giờ, như traffic nhiệm vụ thường
Tốc độ giao
Chậm — phụ thuộc số người mới vào hệ thống mỗi ngày
Nhanh hơn hẳn
Bạn phải chuẩn bị
ma_xac_minh và 2 ảnh
Chỉ anh_serp — phần câu hỏi hệ thống tự lo
Điều kiện trang đích
Có một đoạn chữ cố định để làm mã
Đủ nội dung chữ để sinh ít nhất 4 câu hỏi
Nhận biết qua API
che_do_xac_minh = "sdt"
che_do_xac_minh = "faq"
Cả hai gói đều không cam kết thời gian ở lại và thao tác trên trang. Không có mã
theo dõi thì hệ thống không đo được hai chỉ số đó, nên không hứa. Cần cam kết hành vi
thì dùng loại có gắn mã.
Tham số riêng của loại không gắn mã
Parameters
Description
ma_xac_minh
bắt buộc — gói unique user
Đoạn chữ người làm phải gõ lại. Tối thiểu 4 ký tự, tối đa 60.
Hệ thống tự mở trang đích và kiểm tra chuỗi này có thật trước khi trừ tiền.
anh_serp
bắt buộc
Đường dẫn ảnh chụp kết quả của bạn trên Google.
Phải bôi che tên miền trong ảnh, chỉ chừa tiêu đề và mô tả — thấy tên miền
là người làm gõ thẳng vào trình duyệt, không qua Google, lượt đó mất giá trị.
anh_vi_tri_ma
bắt buộc — gói unique user
Đường dẫn ảnh chụp chỗ mã hiển thị trên trang.
Phải che bớt vài ký tự của mã — người làm nhìn ra mã nằm chỗ nào nhưng
vẫn phải mở trang mới đọc đủ.
goi_y_vi_tri
gói unique userCâu chỉ đường, tối đa 120 ký tự. Ví dụ: Ở chân trang, mục thông tin doanh nghiệp.
Bỏ trống thì hệ thống dùng câu mặc định.
tang_toc
1 = bỏ giới hạn theo khung giờ, giao hết công suất tới khi hết số lượng
của ngày. Mặc định 0. Số lượng mỗi ngày vẫn giữ nguyên, không vượt.
Ví dụ
POST /api/v2
{
"key": "API_KEY_CUA_BAN",
"action": "traffic_create",
"name": "Chiến dịch không gắn mã",
"traffic_key": "abc123",
"package_id": 9,
"url": "https://tenmien.com",
"quantity": 500,
"zone_1": 25, "zone_2": 25, "zone_3": 25, "zone_4": 25,
"ma_xac_minh": "0123456789",
"goi_y_vi_tri": "Ở chân trang, mục thông tin doanh nghiệp",
"anh_serp": "https://cdn-cua-ban.com/anh-ket-qua-google.png",
"anh_vi_tri_ma": "https://cdn-cua-ban.com/anh-vi-tri-ma.png",
"tang_toc": 1
}
Lỗi thường gặp
Thông báo
Nguyên nhân và cách sửa
Không tìm thấy mã này trên trang
Chuỗi bạn khai không có trong nội dung chữ của trang. Có thể nó đang nằm trong
ảnh, hoặc chỉ hiện sau khi trang chạy mã phía trình duyệt. Thêm nó vào chân
trang dưới dạng chữ rồi gọi lại.
Mã này đang nằm trong tiêu đề hoặc mô tả trang
Google hiển thị sẵn tiêu đề và mô tả ở trang kết quả, nên người làm trả lời
được mà không cần mở web. Chọn chuỗi nằm trong phần nội dung.
Mã quá ngắn
Dưới 4 ký tự thì đoán bừa quá dễ. Dùng chuỗi dài hơn.
Bạn chưa tải Ảnh 1 / Ảnh 2
Thiếu anh_serp hoặc anh_vi_tri_ma. Hai ảnh này bắt buộc:
tên miền bị giấu có chủ ý nên ảnh kết quả Google là thứ duy nhất chỉ đúng trang
cần bấm.
Trang này chỉ cho ra N câu hỏi dùng được
gói kết hợp
Trang đích quá ít nội dung chữ, hoặc thông tin nằm trong ảnh nên máy không
đọc được. Dùng trang nhiều nội dung hơn, hoặc chuyển sang gói unique user.
Không tải được trang này
Máy chủ không mở được url bạn khai. Kiểm tra đường dẫn, hoặc trang
đang chặn truy cập tự động.
Người làm có công cụ thì không phải gõ lại mã. Ai dùng ứng dụng Android hoặc tiện ích
Chrome của hệ thống sẽ được ghi nhận tự động bằng hành vi thật (vào từ Google, thời gian ở
lại, độ cuộn trang). Bạn không phải khai báo gì thêm — cùng một chiến dịch phục vụ được cả
hai nhóm.
Dành cho địa điểm trên Google Maps — không cần website. Người làm mở Google Maps,
gõ đúng từ khoá bạn mua, kéo danh sách rồi bấm vào địa điểm của bạn. Để chứng minh đã bấm
vào thật, họ phải đọc lại số điện thoại hoặc số nhà + tên đường đang hiển thị
trên hồ sơ địa điểm.
Luồng gọi — hai bước
Không tra được địa điểm bằng tên riêng. Nguồn dữ liệu Google Maps tìm theo
loại hình: "nha khoa" ra 20 kết quả, còn gõ thẳng
"Nha Khoa Đà Nẵng Center" trả về 0 kết quả. Vì vậy phải tra danh sách
trước rồi chọn địa điểm của bạn trong đó, chứ không khai tên.
Bước 1 — tra danh sách địa điểm bằng action = "serp_map"
(xem mục Map places lookup ở cột trái).
Lấy place_id của địa điểm bạn muốn chạy.
Bước 2 — tạo chiến dịch bằng traffic_create, truyền
place_id vừa lấy kèm đúng từ khoá và khu vực đã dùng ở bước 1.
Tham số riêng của gói Google Maps
Parameters
Description
map_tu_khoa
bắt buộc
Từ khoá dùng để tra danh sách địa điểm, tối đa 160 ký tự. Gõ theo
loại hình (nha khoa, quán cà phê,
sửa xe máy), không phải tên riêng.
map_khu_vuc
nên có
Tỉnh/thành, tối đa 120 ký tự. Bỏ trống thì kết quả trải toàn quốc và rất dễ
không có địa điểm của bạn. Nếu map_tu_khoa đã chứa tên khu vực thì
hệ thống tự bỏ, không ghép lặp.
map_place_id
bắt buộcplace_id của địa điểm, lấy từ serp_map.
Hệ thống tra lại đúng cặp từ khoá + khu vực và phải thấy
place_id này trong kết quả thì mới cho tạo.
map_kieu
"sdt" (mặc định) — người làm điền 3 số cuối bị che của số
điện thoại. "diachi" — điền số nhà + tên đường. Nên dùng sdt: số điện thoại chỉ hiện khi bấm mở hồ sơ, còn
địa chỉ đôi khi Google in sẵn ngoài danh sách. Chỉ chọn diachi khi
địa điểm chưa khai số điện thoại.
anh_serp
không bắt buộc
Ảnh minh hoạ địa điểm. Bỏ trống thì hệ thống tự lấy ảnh của chính địa điểm
trên Google Maps. Chỉ bắt buộc khi địa điểm không có ảnh nào.
tang_toc
1 = bỏ giới hạn theo khung giờ, giao hết công suất tới khi hết số
lượng của ngày. Mặc định 0.
Số điện thoại và địa chỉ do hệ thống tự đọc lại từ Google Maps lúc tạo chiến dịch,
không nhận chữ bạn gửi lên. Đó là đáp án của nhiệm vụ — để phía gọi API đặt được thì
khai sai một ký tự là mọi người làm đọc đúng trên Maps đều bị chấm trượt.
Mỗi giờ hệ thống tra lại 20 kết quả Maps của từng từ khoá. Từ khoá không thấy địa
điểm của bạn sẽ bị cảnh báo, và trượt hai lần liên tiếp thì tạm dừng — người làm
cuộn cả ngày cũng không tìm ra thì nhận việc rồi bỏ, tiền nằm chết trong chiến dịch.
Từ khoá tự chạy lại khi địa điểm lên hạng. Xem trạng thái qua
traffic_detail.
Lỗi thường gặp
Thông báo
Nguyên nhân và cách sửa
Google Maps không trả về địa điểm nào cho từ khoá …
Bạn đang tra bằng tên riêng của địa điểm. Đổi sang từ khoá theo loại
hình rồi tra lại.
Địa điểm bạn chọn không còn trong kết quả của từ khoá này
map_place_id không khớp cặp map_tu_khoa +
map_khu_vuc bạn gửi. Gọi lại serp_map với đúng cặp đó
rồi lấy place_id mới.
… chưa khai số điện thoại trên Google Maps
Địa điểm không có số nên không làm đề bài sdt được. Bổ sung số vào
hồ sơ địa điểm, hoặc chuyển map_kieu = "diachi".
Địa chỉ … không có số nhà
Đề bài diachi cần số nhà; địa chỉ chỉ có tên đường thì người làm
đọc ngoài danh sách kết quả là trả lời được, không chứng minh được đã bấm vào.
Chưa tra được địa điểm ngay lúc này
Nguồn tra cứu đang lỗi hoặc quá tải. Chưa trừ tiền — gọi lại sau ít phút.
Mỗi người chỉ làm 1 lượt cho mỗi địa điểm, trọn đời. Số điện thoại và địa chỉ là
thông tin cố định, biết một lần là mọi lượt sau không còn giá trị. Vì vậy tốc độ giao phụ
thuộc số người mới vào hệ thống mỗi ngày, và không cam kết thời gian ở lại hay thao
tác trong hồ sơ địa điểm — trên Google Maps không gắn được mã đo.
Parameters
Description
key
API Key
action
"traffic_update"
id
Campaign ID
name
Campaign Name
image
Image URL
zone_1
% Quantity (00:00 - 05:59)
zone_2
% Quantity (06:00 - 11:59)
zone_3
% Quantity (12:00 - 17:59)
Example response
{
"status": "success",
"message": "Success"
}
Parameters
Description
key
API Key
action
"traffic_buymore"
id
Campaign ID
quantity
Quantity to buy more
Example response
{
"status": "success",
"message": "Success"
}
Parameters
Description
key
API Key
action
"traffic_refund"
id
Campaign ID
Example response
{
"status": "success",
"message": "Success"
}
Muốn tạo chiến dịch và từ khoá trong một lệnh duy nhất? Dùng tham số
keywords của Create Traffic. Lệnh này vẫn giữ nguyên để thêm
từ khoá cho chiến dịch đã có.
Parameters
Description
key
API Key
action
"traffic_add_key"
campaign_id
Campaign ID
keyword
Keyword (if creating new)
budget
Budget (traffic/day) — số lượt mỗi ngày cho RIÊNG từ khoá này.
Tổng budget các từ khoá không được vượt quantity của chiến dịch.
url_step2
Gói 2 bước:bắt buộc URL trang thứ hai. Gói 1 bước:không bắt buộc
URL trang riêng của từ khoá này. Phải cùng tên miền với chiến dịch.
Dùng để chỉ đường cho người làm và để dựng ảnh kết quả Google của từ khoá —
không ràng buộc: người làm vào từ Google nên có thể rơi vào trang khác cùng
website, trường hợp đó vẫn được cấp mã bình thường.
image
không bắt buộc
Ảnh hiển thị trên Google của riêng từ khoá này. Bỏ trống thì hệ thống
tự dựng ảnh thẻ kết quả Google của đúng cặp (từ khoá, URL) ở trên;
dựng không được thì dùng ảnh chiến dịch.
key_id
Keyword ID (if updating)
status
Status (active/paused) (if updating)
Example response
{
"status": "success",
"message": "Success"
}
Cách dùng khuyến nghị: tạo một chiến dịch cho cả tên miền
(traffic_create với url = tên miền, bỏ trống image),
rồi gọi traffic_add_key nhiều lần — mỗi từ khoá kèm
url_step2 (trang riêng) và budget (lượt/ngày).
Không cần tạo mỗi URL một chiến dịch.
Earn money — Account must be verified (KYC) to receive tasks. type: review_map | report | seeding | traffic. traffic requires Vietnam IP & no proxy/VPN; the pass code is generated only by a real browser visit.
Tùy chọn — sub-filter, meaning depends on type: • type=seeding → facebook, tiktok, youtube… • type=traffic → earn (paid tasks — DEFAULT if omitted), free (free-buff tasks), proxy, wheel Leaving it empty on a traffic call returns PAID tasks. To get the free-buff tasks you see on the website, send platform=free.
user_ip
traffic: REQUIRED — the worker's real public IP (the one their browser will open the website with)
user_agent
traffic: REQUIRED — the worker's browser User-Agent, copied verbatim
Traffic tasks are bound to the worker's IP and browser. The widget on the target website only shows the "LẤY MÃ" button when it finds a pending task whose ip and user_agent match the visit exactly. You call this API from your server, so we cannot detect them — send user_ip and user_agent of the worker, otherwise the button never appears and the task simply expires.
The data object differs by type (review_map/report/seeding/traffic). Read money for the pay of this task.
Ví dụ phản hồi — type=traffic
{
"status": "success",
"message": "Nhận nhiệm vụ thành công",
"data": {
"id": 204107,
"keyword": "sửa máy lạnh thủ đức",
"url_keyword": "https://tenmien.com/dich-vu/sua-may-lanh-thu-duc",
"image": "https://drive.google.com/thumbnail?id=...&sz=w600",
"name": "Chiến dịch điện lạnh",
"pay": 680,
"time": 60,
"status": "pending"
}
}
Mới:url_keyword là trang nên vào cho từ khoá này — hãy hiển thị cho người làm
để họ bấm đúng kết quả. Không bắt buộc: người làm vào từ Google nên có thể rơi vào trang khác,
miễn cùng tên miền là vẫn được cấp mã. Rỗng nghĩa là không có trang gợi ý. image là ảnh thẻ kết quả Google của đúng từ khoá đó — cho người làm xem để biết
phải bấm vào kết quả nào trên trang tìm kiếm.
traffic only — when no task is returned, chan_doan tells you which gate blocked it. chien_dich_con_luot: 0 means you are calling a domain that has no running campaign.
Different endpoint — this is NOT /api/v2 and has no action. POST https://rslike.com/api/v1/get-free
Auth by header: Authorization: Bearer {api_key}
Where does traffic_code come from? It is the pass code produced by the LẤY MÃ button after a real browser visit on the campaign website — the same value you send as proof to earn_submit_task with type=traffic. Each code can be redeemed once.
Parameters
Description
object_id
Required — link to the post / profile / video to boost
service_id
Required — id NHÓM DỊCH VỤ (không phải id máy chủ của action=services). Tra bằng /api/v1/free-services ở khối bên dưới. Link phải đúng nền tảng của nhóm: dán link TikTok vào nhóm Instagram sẽ bị từ chối.
traffic_code
Required — the traffic mission pass code
server_id
Tùy chọn — pick one server; it must belong to the free-eligible group. Omit it and the system chooses for you
{
"status": "success",
"message": "Order created successfully",
"order": 1997856
}
Common errors: Vui lòng nhập mã hoàn thành nhiệm vụ traffic · Không có server nào đủ điều kiện nhận miễn phí · Máy chủ bạn chọn không nằm trong nhóm được nhận miễn phí · Link bạn dán không thuộc {nền tảng}
Tra danh mục dịch vụ miễn phí
Trả về cây nền tảng → dịch vụ → máy chủ đang mở miễn phí, kèm đúng service_id và server_id để gửi sang get-free. Danh mục này giống hệt trang /service-free nên không bao giờ lệch.
The admin can switch this programme off; while closed the endpoint returns Chương trình nhận proxy miễn phí đang tạm đóng.
Your users do real Facebook interactions (comment / reaction / share) on customers' posts and get paid per job. The system reads the post itself to verify — no screenshots, no manual approval.
Same flow as the /nhiem-vu-facebook page, exposed for partners who want to build their own interface. The key belongs to the worker, and the money goes into that worker's wallet on your site.
Flow
cross_accounts ──► no verified account? ──► cross_account_code ──► post the code publicly
└──► cross_account_verify
cross_jobs ──► cross_claim ──► worker does it on Facebook ──► cross_submit
│
the system reads the post ──┴──► ok: held 24h, then paid
missed: cross_appeal
A worker with no verified Facebook account can browse jobs but cannot claim any. The number of jobs they may hold at the same time equals their number of verified accounts (max 3) — that is the lever to push in your interface.
🔒 This channel needs approval before use.
Log in, then send the request below.
Request access
curl -X POST "https://rslike.com/api/v2" \
-d "key=YOUR_API_KEY" \
-d "action=cross_request_access" \
-d "ten=Tên đối tác" \
-d "lien_he=zalo/telegram/email" \
-d "ghi_chu=Bạn định dùng để làm gì, dự kiến bao nhiêu người làm"
The full specification appears here once approved.
Look up the real Google results page for a keyword: position, title, link, description, domain, favicon. Charged per lookup from your balance.
Parameters
Description
key
API Key
action
"serp"
query
Keyword to look up. Max 200 characters.
gl
Optional — country, default vn
hl
Optional — language, default vi
limit
Optional — number of results, 1–10, default 10
page
Optional — result page, 1–10, default 1
Giá: 75đ / lookup.
The exact amount charged is returned in charged,
and your remaining balance in balance. Repeated lookups are free:
the same query + gl + hl + limit + page within 5 minutes is served from cache with cached: true and charged: 0. Safe to retry after a timeout — you will not be billed twice. Rate limit: 30 requests per minute per account.
Track your usage:
every lookup is logged — what was charged, what came from cache, what failed.
Open usage history ↗
Missing or invalid parameter (empty keyword, limit out of range...)
402
Not enough balance
403
Account is locked
429
Too many requests — wait for the next minute
503
Source is busy or temporarily out of quota — safe to retry later. Nothing is charged.
Nothing is charged when a lookup fails. If you get a 503, retry after a short pause instead of looping — repeated calls only consume your rate limit.
Look up businesses on the map for a keyword and area: map position, rating, review count, phone, website, opening hours and coordinates. Charged per lookup, not per place.
Parameters
Description
key
API Key
action
"serp_map"
query
What to look for: "coffee shop", "dentist"… Max 160 characters.
location
Strongly recommended — the area, e.g. Quận 1 TP.HCM. Appended to the keyword; see the note below.
ll
Optional — map centre @latitude,longitude,zoomz, e.g. @10.7769,106.7009,13z. Plain 10.7769,106.7009 is accepted too.
gl
Optional — country, default vn
hl
Optional — language, default vi
limit
Optional — number of places, 1–20, default 20
Use location, do not rely on ll alone:
results for a keyword are cached upstream by keyword text only. Sending the same query with different coordinates returns the first area's places. Putting the area in location makes each area a distinct keyword, so it always returns the right city.
Giá: 150đ / lookup —
the same price whether 1 or 20 places come back.
The exact amount charged is returned in charged,
and your remaining balance in balance. Repeated lookups are free:
the same query + location + limit within 5 minutes returns cached: true and charged: 0. Rate limit: 30 requests per minute per account
— shared with action=serp. No paging:
20 places per lookup is the ceiling. To get more, change the keyword or the area — there is no page parameter.
Prefer clicking over coding?
The same lookup runs on-screen, with CSV export.
Open the map places tool ↗
Field notes:website, phone, price and thumbnail can be empty — not every business publishes them. rating is 0 when a place has no reviews yet; treat that as "no data", not "bad".
Errors
HTTP
Meaning
400
Missing or invalid parameter (empty keyword, limit out of range...)
402
Not enough balance
403
Account is locked
429
Too many requests — wait for the next minute
503
Source is busy or temporarily out of quota — safe to retry later. Nothing is charged.
Nothing is charged when a lookup fails. An empty places array is a successful lookup that found nothing — it is billed, so send a realistic keyword and area.
Four Google search types share one request shape. Set action to serp_news, serp_videos, serp_images or serp_shopping. Charged per lookup; cached results (5 min) are free.
Source busy or out of quota — retry later. Nothing is charged.
Check whether an email address is real and reachable before you send to it. Charged per lookup; repeated checks of the same address within 5 minutes are free.
Field notes:result is valid, invalid or unknown. Use unknown as "cannot confirm", not "bad".
Each successful lookup is charged the price below, deducted from your account balance. Repeats of the same request within 5 minutes are served from cache and not charged; failed lookups are not charged.
action
Description
Price / call
serp
Google web search
75 đ
serp_map
Google Maps places
150 đ
serp_news
Google News
26 đ
serp_videos
Google Videos
26 đ
serp_images
Google Images
26 đ
serp_shopping
Google Shopping
26 đ
verify_email
Email verification
130 đ
Get prices via API
Fetch the current price list programmatically with action=prices — free, not charged. Use it to show live prices in your own app.
curl -X POST "https://rslike.com/api/v2" \
-d "key=YOUR_API_KEY" \
-d "action=prices"