Các điểm cuối của Google Search API
Chọn loại tìm kiếm Google và gửi yêu cầu tương ứng bằng Google Search API. Hướng dẫn này được phát triển dựa trên Hướng dẫn nhanh và bao gồm năm loại tìm kiếm với các mục riêng biệt trong tài liệu tham khảo API của Scrapeless.
Cả năm loại đều sử dụng cùng một điểm cuối HTTP và actor scraper.google.search. Giá trị input.tbm sẽ xác định loại tìm kiếm.
Yêu cầu và xác thực
POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/jsonThay thế YOUR_API_KEY bằng khóa API Scrapeless của bạn. Gửi một đối tượng JSON chứa actor và input.
Chọn loại tìm kiếm
| Loại tìm kiếm | input.tbm | Đầu vào yêu cầu |
|---|---|---|
| Google Search | Bỏ qua | Truy vấn tìm kiếm trong q |
| Google Images | isch | Truy vấn tìm kiếm hình ảnh trong q |
| Google Local | lcl | Truy vấn tìm kiếm địa phương trong q |
| Google Videos | vid | Truy vấn tìm kiếm video trong q |
| Google Shopping | shop | Truy vấn tìm kiếm mua sắm trong q |
| Google Web | web | Truy vấn tìm kiếm web trong q |
| Google Jobs | jobs | Truy vấn tìm kiếm việc làm trong q |
| Google News | nws | Truy vấn tìm kiếm tin tức trong q |
| Google Short Videos | svid | Truy vấn tìm kiếm video ngắn trong q |
Đây là các chế độ tìm kiếm của cùng một điểm cuối. Giữ nguyên URL HTTP, tiêu đề xác thực và actor khi chuyển đổi giữa các chế độ.
Google Search
Bỏ qua tbm để tìm kiếm web thông thường.
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.google.search",
"input": {
"q": "coffee",
"hl": "en",
"gl": "us"
}
}'Hướng dẫn nhanh bao gồm phản hồi tìm kiếm web với organic_results, pagination và các phần phụ thuộc vào truy vấn khác. Không giả định rằng mọi truy vấn đều trả về tất cả các phần.
Tài liệu tham khảo Google Search
Google Images
Đặt tbm thành isch để yêu cầu tìm kiếm hình ảnh. Yêu cầu bên dưới sử dụng tên miền Google mặc định.
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.google.search",
"input": {
"q": "Apple Iphone16",
"hl": "en",
"gl": "us",
"tbm": "isch"
}
}'Tài liệu tham khảo Google Images
Google Local
Đặt tbm thành lcl để yêu cầu tìm kiếm địa phương.
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.google.search",
"input": {
"q": "coffee shops",
"hl": "en",
"gl": "us",
"tbm": "lcl"
}
}'Để nhắm mục tiêu theo cấp thành phố, hãy thêm location bên trong input, ví dụ: "Austin, Texas, United States". Chỉ sử dụng location hoặc uule, không bao giờ dùng cả hai trong cùng một yêu cầu.
Đối với phân trang tìm kiếm Địa phương, start phải là bội số của 20: 0, 20, 40, v.v.
Tài liệu tham khảo Google Local
Google Videos
Đặt tbm thành vid. Ví dụ này giữ nguyên các trường yêu cầu được hiển thị trong tài liệu tham khảo API chuyên dụng.
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.google.search",
"input": {
"engine": "google.search",
"q": "Coffee",
"google_domain": "google.com",
"start": 0,
"tbm": "vid"
}
}'Tài liệu tham khảo Google Videos
Google Shopping
Đặt tbm thành shop. Ví dụ này giữ nguyên các trường yêu cầu được hiển thị trong tài liệu tham khảo API chuyên dụng.
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.google.search",
"input": {
"engine": "google.search",
"q": "Coffee",
"google_domain": "google.com",
"start": 0,
"tbm": "shop"
}
}'Tài liệu tham khảo Google Shopping
Các điều khiển tìm kiếm chung
Đặt các trường này bên trong input:
| Tham số | Mục đích |
|---|---|
q | Truy vấn tìm kiếm bắt buộc. |
gl | Quốc gia tìm kiếm, ví dụ: us. |
hl | Ngôn ngữ tìm kiếm, ví dụ: en. |
google_domain | Tên miền Google; mặc định là google.com. |
location | Vị trí tìm kiếm, ưu tiên chỉ định ở cấp thành phố. |
uule | Vị trí Google được mã hóa; loại trừ lẫn nhau với location. |
start | Độ lệch kết quả. Tìm kiếm web sử dụng 0, 10, 20, v.v. |
tbs | Bộ lọc tìm kiếm nâng cao. |
Xem Tham số Google Search để biết mô tả đầy đủ về các tham số. Thiết bị được hỗ trợ hiện tại được liệt kê ở đó là máy tính để bàn.
Đọc kết quả
- HTTP
200: đọc kết quả JSON. - HTTP
201: lưutaskIdvà truy xuất tác vụ hiện có bằng điểm cuối kết quả.
curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
--header 'x-api-token: YOUR_API_KEY'Thay thế YOUR_TASK_ID bằng ID được trả về. Xem Kết quả và Polling để biết quy trình làm việc đầy đủ.
Các phần phản hồi khác nhau tùy theo loại tìm kiếm và truy vấn. Các đặc tả API chuyên dụng hiện khai báo một đối tượng chung cho các phản hồi thành công; ví dụ Google Search thông thường không phải là lược đồ cho Images, Local, Videos hoặc Shopping.