Tham số API
Google Search API được điều khiển bởi các tham số bên dưới. Chúng được truyền vào trong đối tượng input của yêu cầu (xem Bắt đầu). Chỉ q là bắt buộc; mọi tham số khác đều tùy chọn và dùng để tinh chỉnh vị trí, ngôn ngữ, phân trang hoặc loại kết quả.
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
url | false | Liên kết truy cập đầy đủ của Google Search. Loại trừ lẫn nhau với tất cả các tham số khác. Nếu tham số này được điền, tất cả các tham số yêu cầu khác không cần truyền và sẽ tự động bị bỏ qua nếu có truyền. |
q | true | Xác định truy vấn bạn muốn tìm kiếm. Bạn có thể sử dụng bất kỳ cú pháp nào dùng trong tìm kiếm Google thông thường, ví dụ: inurl:, site:, intitle:. Các tham số truy vấn tìm kiếm nâng cao như as_dt và as_eq cũng được hỗ trợ. |
location | false | Xác định vị trí bạn muốn tìm kiếm bắt nguồn từ đó. Nếu có nhiều vị trí khớp, vị trí phổ biến nhất sẽ được sử dụng. location và uule không thể dùng cùng lúc. Nên chỉ định location ở cấp thành phố để mô phỏng tìm kiếm của người dùng thực. Nếu bỏ qua, tìm kiếm có thể lấy vị trí của proxy. |
uule | false | Vị trí đã được mã hóa bởi Google mà bạn muốn sử dụng cho tìm kiếm. uule và location không thể dùng cùng lúc. |
ludocid | false | Xác định id (CID) của danh sách Google My Business mà bạn muốn thu thập dữ liệu. Còn được gọi là Google Place ID. |
lsig | false | Một id bạn có thể cần dùng để buộc chế độ xem bản đồ Knowledge Graph hiển thị. ID lsig có sẵn thông qua Local Pack API hoặc Google Local API, và cũng thông qua chuyển hướng mà Google sử dụng trong Google My Business. |
kgmid | false | Xác định id (KGMID) của danh sách Google Knowledge Graph mà bạn muốn thu thập dữ liệu. Các tìm kiếm với kgmid trả về kết quả cho các tham số tìm kiếm đã được mã hóa ban đầu. Đối với một số tìm kiếm, kgmid có thể ghi đè tất cả các tham số khác ngoại trừ start và num. |
si | false | Xác định các tham số tìm kiếm đã lưu trong bộ nhớ đệm của Google Search mà bạn muốn thu thập dữ liệu. Các tìm kiếm với si trả về kết quả cho các tham số tìm kiếm đã được mã hóa ban đầu. Đối với một số tìm kiếm, si có thể ghi đè tất cả các tham số khác ngoại trừ start và num. si có thể được dùng để thu thập dữ liệu các Tab Google Knowledge Graph. |
ibp | false | Chịu trách nhiệm hiển thị bố cục và mở rộng cho một số phần tử (ví dụ: gwp;0,7 để mở rộng tìm kiếm với ludocid cho Knowledge Graph mở rộng). |
uds | false | Cho phép lọc kết quả tìm kiếm. Đây là chuỗi do Google cung cấp dưới dạng bộ lọc. Các giá trị uds được cung cấp trong phần: filters, với các giá trị uds, q và serpapi_link được cung cấp cho mỗi bộ lọc. |
google_domain | false | Xác định tên miền Google sẽ sử dụng. Mặc định là google.com. Xem trang tên miền Google để biết danh sách đầy đủ các tên miền được hỗ trợ. |
gl | false | Xác định quốc gia sẽ sử dụng cho tìm kiếm Google. Đây là mã quốc gia hai chữ cái (ví dụ: us cho Hoa Kỳ, uk cho Vương quốc Anh, fr cho Pháp). |
hl | false | Xác định ngôn ngữ sẽ sử dụng cho tìm kiếm Google. Đây là mã ngôn ngữ hai chữ cái (ví dụ: en cho tiếng Anh, es cho tiếng Tây Ban Nha, fr cho tiếng Pháp). |
cr | false | Xác định một hoặc nhiều quốc gia để giới hạn tìm kiếm. Sử dụng country{mã quốc gia hai chữ cái viết hoa} và | làm dấu phân cách (ví dụ: countryFR|countryDE chỉ tìm kiếm các trang tiếng Pháp và tiếng Đức). |
lr | false | Xác định một hoặc nhiều ngôn ngữ để giới hạn tìm kiếm. Sử dụng lang_{mã ngôn ngữ hai chữ cái} và | làm dấu phân cách (ví dụ: lang_fr|lang_de chỉ tìm kiếm các trang tiếng Pháp và tiếng Đức). |
tbs | false | (cần tìm kiếm) Xác định các tham số tìm kiếm nâng cao không thể thực hiện trong trường truy vấn thông thường (ví dụ: tìm kiếm nâng cao cho bằng sáng chế, ngày tháng, tin tức, video, hình ảnh, ứng dụng hoặc nội dung văn bản). |
safe | false | Xác định mức độ lọc nội dung người lớn. Có thể đặt thành active hoặc off. Theo mặc định, Google sẽ làm mờ nội dung nhạy cảm. |
nfpr | false | Loại trừ kết quả từ truy vấn đã được tự động sửa lỗi chính tả khi truy vấn gốc bị sai chính tả. Đặt thành 1 để loại trừ các kết quả này, hoặc 0 để bao gồm chúng (mặc định). Có thể không luôn ngăn được kết quả tự động sửa lỗi khi không có kết quả nào khác. |
filter | false | Xác định xem bộ lọc cho ‘Kết quả tương tự’ và ‘Kết quả bị bỏ qua’ có bật hay tắt. Đặt thành 1 (mặc định) để bật, hoặc 0 để tắt. |
tbm | false | (cần khớp) Xác định loại tìm kiếm. Có thể đặt thành: (không có tbm) Tìm kiếm Google thông thường, isch: Google Images API, lcl: Google Local API, vid: Google Videos API, nws: Google News API, shop: Google Shopping API, pts: Google Patents API, hoặc bất kỳ dịch vụ Google nào khác. |
start | false | Xác định độ lệch kết quả cho phân trang (ví dụ: 0 (mặc định) là trang đầu tiên, 10 là trang thứ 2, 20 là trang thứ 3). Kết quả Google Local chỉ chấp nhận bội số của 20. |
device | false | Xác định thiết bị được sử dụng để lấy kết quả. Hiện tại chỉ hỗ trợ phiên bản máy tính để bàn. |
Tham khảo đầy đủ: Tham số API trên tài liệu Scrapeless API.