# FlashData Google Search API

Thu thập kết quả hữu cơ, câu hỏi liên quan và kết quả giàu có từ Google Search có cấu trúc JSON. Lọc theo quốc gia, ngôn ngữ và vị trí.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/sources/google_search
Xem lại: 2026-10-23

Điểm kết thúc: POST https://data.flashdata.dev/v1/queries/realtime
Xác thực: X-API-Key: YOUR_API_KEY
Chế độ: [Realtime](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/vi/docs/reference/batch-and-bulk/reference.md#batch)

Cần thiết quyền truy cập nguồn: google_search

Thay thế YOUR_API_KEY với một API Chìa khóa mà có quyền sử dụng nguồn này và tín dụng sẵn có. Chạy yêu cầu trên máy chủ hay máy phục vụ.

[Đang thiết lập xác thực](https://flashdata.dev/vi/docs/guides/headers-and-authentication/reference.md)

[Chọn và tinh luyện một tìm kiếm Google](https://flashdata.dev/vi/docs/guides/google-search-guide/reference.md)

<a id="quickstart"></a>

## Gửi một yêu cầu

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_search",
    "query": "openai",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "google_search",
  "query": "openai",
  "params": {
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Tham số

<a id="parameters-group-0"></a>

### Nội dung yêu cầu

| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Vâng | — | Thiết lập google_search.  |
| <a id="parameter-query"></a> query | string | Vâng | Chưa đặt | Truy vấn tìm kiếm. Hỗ trợ Google tìm kiếm các nhà điều hành như trang web: và trong danh sách: Chiều dài tối thiểu: 1. Chiều dài tối đa: 2000. |
| <a id="parameter-params"></a> params | object | Không | {} | Settings cho yêu cầu này.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Không | Chưa đặt | Async và chỉ một mẻ. Chung HTTPS hoàn tất URL trên cổng 443Đến 2,048 các nhân vật. Không có phân khúc người dùng hay URL. Omit, dùng null hoặc chuỗi rỗng không cho thông báo nào. Trong một mẻ, đặt nó trên mỗi câu hỏi, bên ngoài các tham số.  |

<a id="parameters-group-1"></a>

### Quốc gia, địa điểm và ngôn ngữ

| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Không | Chưa đặt | Mã quốc gia 2 chữ cái, như chúng ta, gb, de hoặc sg. Đặt dứt khoát để chọn một nước. Chiều dài tối thiểu: 2. Chiều dài tối đa: 2. Mẫu: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Không | Chưa đặt | Google Ngôn ngữ giao diện. Đặt một cách rõ ràng để chọn một ngôn ngữ. Chiều dài tối thiểu: 1. Chiều dài tối đa: 35. Mẫu: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Không | Chưa đặt | Đã yêu cầu địa điểm tìm kiếm, tốt hơn là một thành phố, như "London, England, United Kingdom". Tính khả thi phụ thuộc vào kiểu tìm kiếm. Chiều dài tối thiểu: 1. Chiều dài tối đa: 200. |

<a id="parameters-group-2"></a>

### Đăng ký

| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Không | Chưa đặt | Yêu cầu số lượng kết quả. FlashData không thêm giá trị mặc định cố định khi bỏ qua. Số đếm lại có thể khác nhau khi truy vấn và tìm kiếm kiểu. Tối thiểu: 1. Tối đa: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Không | Chưa đặt | Đã yêu cầu trang kết quả. Chuẩn bị rõ ràng. Mỗi trang là một yêu cầu khác nhau của API. Tối thiểu: 1. Tối đa: 100. |

<a id="parameters-group-3"></a>

### Bộ lọc tìm kiếm

| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Không | Chưa đặt | Đã yêu cầu Google lọc tìm kiếm, như qdr:d cho ngày qua hoặc qdr:w cho tuần vừa qua. Tính khả thi phụ thuộc vào kiểu tìm kiếm. Chiều dài tối thiểu: 1. Chiều dài tối đa: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Không | Chưa đặt | Yêu cầu sửa chính tả bằng true hoặc yêu cầu nó bị tắt false. Ứng xử ứng dụng phụ thuộc vào kiểu tìm kiếm; bỏ qua cần dùng GoogleHành vi.  |

<a id="response"></a>

## Đọc kết quả

Cứu người thành công JSON trả lời response.json. Lưu cái này vào read-response.py và chạy python read-response.py. Nó chỉ dùng thôi. PythonThư viện thông thường và không có yêu cầu mới.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"title": item.get("title"), "url": item.get("link"), "snippet": item.get("snippet")}
    for item in result.get("organic", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Phản hồi mẫu

Ví dụ được thu; trường và số phụ thuộc vào nguồn và yêu cầu nhập.
```json
{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "openai",
        "gl": "us",
        "hl": "en",
        "type": "search",
        "num": 10,
        "page": 1,
        "engine": "google"
      },
      "organic": [
        {
          "title": "OpenAI | Research & Deployment",
          "link": "https://openai.com/",
          "snippet": "We believe our research will eventually lead to artificial general intelligence, a system that can solve human-level problems.",
          "position": 1
        },
        {
          "title": "OpenAI",
          "link": "https://en.wikipedia.org/wiki/OpenAI",
          "snippet": "OpenAI is an American artificial intelligence (AI) public benefit corporation (PBC) headquartered in San Francisco. It develops proprietary generative AI models ...",
          "position": 2
        },
        {
          "title": "OpenAI",
          "link": "https://x.com/OpenAI",
          "snippet": "OpenAI's mission is to ensure that artificial general intelligence benefits all of humanity. can develop research, build financial models, and create ...",
          "position": 3
        },
        {
          "title": "OpenAI",
          "link": "https://www.linkedin.com/company/openai",
          "snippet": "OpenAI is an AI research and deployment company dedicated to ensuring that general-purpose artificial intelligence benefits all of humanity.",
          "position": 4
        },
        {
          "title": "r/OpenAI",
          "link": "https://www.reddit.com/r/OpenAI/",
          "snippet": "OpenAI is an AI research and deployment company. OpenAI&#39;s mission is to create safe and powerful AI that benefits all of humanity. OpenAI's ...",
          "position": 5
        }
      ],
      "peopleAlsoAsk": [
        {
          "question": "Is OpenAI created by Elon Musk?"
        },
        {
          "question": "Why are people leaving ChatGPT?"
        },
        {
          "question": "Is OpenAI the same as ChatGPT?"
        },
        {
          "question": "Why is OpenAI in trouble?"
        }
      ],
      "relatedSearches": [
        {
          "query": "OpenAI login"
        },
        {
          "query": "OpenAI chat"
        },
        {
          "query": "OpenAI ChatGPT"
        },
        {
          "query": "OpenAI - wikipedia"
        },
        {
          "query": "OpenAI API"
        },
        {
          "query": "OpenAI app"
        },
        {
          "query": "OpenAI download"
        },
        {
          "query": "OpenAI video"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:41:40.043Z"
}
```

## Trường đáp ứng

| Tìm kiếm | Kiểu | Mô tả |
| --- | --- | --- |
| source | string | Nguồn API đã yêu cầu. |
| status | string | hoàn thành khi yêu cầu thời gian thực thành công. |
| created_at | string | Thời gian tạo ra đáp ứng trong ISO 8601 Định dạng. |
| usage.credits | number | Các nguồn tin cho yêu cầu, dựa trên kế hoạch của anh. |
| results[0].searchParameters | object | Thiết lập tìm kiếm được báo cáo bởi GoogleVới yêu cầu được ghi lại là Q. Thiết lập trở lại có thể khác với các giá trị đã yêu cầu. |
| results[0].organic | array | Kết quả hữu cơ với tiêu đề, liên kết, đoạn cắt và vị trí, cộng thêm các lĩnh vực bổ sung khi có thể. |
| results[0].peopleAlsoAsk | array · optional | Các câu hỏi liên quan đến nhau, với câu trả lời và liên kết nguồn khi có thể. |
| results[0].relatedSearches | array · optional | Liên quan đến các từ tìm kiếm, mỗi từ với một trường truy vấn. |
| results[0].knowledgeGraph | object · optional | Thông tin từ bảng kiến thức. |
| results[0].answerBox | object · optional | Câu trả lời có tính cách đặc biệt. Các cánh đồng khác nhau với kiểu trả lời. |

- Các trường sẵn sàng phụ thuộc vào yêu cầu và kiểu tìm kiếm. Những cánh đồng tùy chọn có thể bị vắng mặt, và có thể trở lại những cánh đồng khác.
- Số mục đã trả lại và searchParameters.num có thể khác params.num. Dùng dãy số điện thoại trả lại để xác định kết quả thực tế.

## Định dạng phản hồi

Đáp ứng được dùng JSON theo mặc định. Chọn một định dạng khác với những đầu trang tùy chọn này.

- Accept: application/json (mặc định) hay text/plain. Văn bản thường trình bày cùng một lĩnh vực trong một bố trí có thể đọc được, được in lề.
- X-Respond-With: markdown. Hãy để lại chỗ trống cho những cánh đồng nguyên thủy. Markdown hoạt động với định dạng trả lời.

Markdown có sẵn cho các yêu cầu thời gian thực và kết quả hoàn tất.

Các trường bên dưới mô tả giá trị mặc định JSON Trả lời đi.

[Ví dụ định dạng đáp ứng yêu cầu](https://flashdata.dev/vi/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## Kiến thức cơ bản về API

Các yêu cầu xây dựng và ví dụ trên sử dụng các tham số của nguồn này. Sử dụng Python và cURL Những ví dụ bên dưới để được chia sẻ sự phục tùng, địa vị và kết quả là bước. A Batch Cơ thể là một JSON Đối tượng chứa các đồ thị; mỗi món đồ trả lại công việc của chính mình ID.

- [Async yêu cầu và biên lai](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [Kiểm tra tình trạng công việc](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [Lấy kết quả hoàn tất](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON yêu cầu](https://flashdata.dev/vi/docs/reference/batch-and-bulk/reference.md#batch)
- [Trình khách OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## Thông báo đầy đủ

- [Nhận và kiểm tra hoàn tất kết nối web](https://flashdata.dev/vi/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## Khắc phục sự cố

- [Lỗi và mã trạng thái](https://flashdata.dev/vi/docs/errors/reference.md#status-codes)
- [Khi nào cần thử lại](https://flashdata.dev/vi/docs/errors/reference.md#retries)

## API liên quan

- [Google Images API](https://flashdata.dev/vi/docs/sources/google_images/reference.md)
- [Google News API](https://flashdata.dev/vi/docs/sources/google_news/reference.md)
