Các endpoint của Google Search API

Chọn một loại tìm kiếm Google và gửi yêu cầu của nó bằng Google Search API. Hướng dẫn này dựa trên Bắt đầu nhanh và bao gồm năm loại tìm kiếm có các mục riêng 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 HTTP endpoint và actor scraper.google.search. Giá trị input.tbm chọn 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 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 một loại tìm kiếm

Đây là các chế độ tìm kiếm của một endpoint. Giữ nguyên URL HTTP, header xác thực và actor khi chuyển đổi 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"
  }
}'

Phần Bắt đầu nhanh bao gồm một phản hồi tìm kiếm web với organic_results, pagination và các phần khác phụ thuộc vào truy vấn. Đừng giả định rằng mọi truy vấn đều trả về mọi 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 dưới đây sử dụng 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 ở cấp thành phố, thêm location vào bên trong input, chẳng hạn như "Austin, Texas, United States". 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 Local, 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ữ lại 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,
    "num": 10,
    "tbm": "vid"
  }
}'

Tài liệu tham khảo Google Videos

Google Shopping

Đặt tbm thành shop. Ví dụ này giữ lại 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,
    "num": 10,
    "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:

Tài liệu tham khảo tham số cảnh báo rằng num có thể làm tăng độ trễ hoặc ảnh hưởng đến các loại kết quả chuyên biệt. Bỏ qua nó trừ khi cần; số lượng được yêu cầu không đảm bảo sẽ có đúng số lượng kết quả đó. Các ví dụ Videos và Shopping ở trên giữ lại giá trị được ghi tài liệu là 10.

Xem Tham số Google Search để biết mô tả tham số đầy đủ. Hỗ trợ thiết bị 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 endpoint 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 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 thay đổi 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à một schema cho Images, Local, Videos hoặc Shopping.

Tài liệu liên quan

• Giới thiệu
• Bắt đầu nhanh
• Tham số Google Search