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/json

Thay 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ếminput.tbmĐầu vào yêu cầu
Google SearchBỏ quaTruy vấn tìm kiếm trong q
Google ImagesischTruy vấn tìm kiếm hình ảnh trong q
Google LocallclTruy vấn tìm kiếm địa phương trong q
Google VideosvidTruy vấn tìm kiếm video trong q
Google ShoppingshopTruy vấn tìm kiếm mua sắm trong q
Google WebwebTruy vấn tìm kiếm web trong q
Google JobsjobsTruy vấn tìm kiếm việc làm trong q
Google NewsnwsTruy vấn tìm kiếm tin tức trong q
Google Short VideossvidTruy 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ế độ.

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
qTruy vấn tìm kiếm bắt buộc.
glQuốc gia tìm kiếm, ví dụ: us.
hlNgôn ngữ tìm kiếm, ví dụ: en.
google_domainTên miền Google; mặc định là google.com.
locationVị trí tìm kiếm, ưu tiên chỉ định ở cấp thành phố.
uuleVị 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.
tbsBộ 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ưu taskId và 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.

Tài liệu liên quan