# FlashData so với Serper.dev: Google Tìm kiếm API so sánh

So sánh mức sử dụng gói Serper.dev với mức giá FlashData, duy trì đầu ra của công cụ tác nhân của bạn và xây dựng quy trình làm việc với Google Tìm kiếm, chú thích YouTube và phân phối phương tiện.

Serper.dev sự kiện được xem xét: 2026-11-10. FlashData mức giá và trợ cấp dùng thử sử dụng danh mục công khai hiện tại của nó.

- [Tính năng](#features)
- [Tại sao chuyển đổi?](#overview)
- [Gói & chi tiêu](#costs)
- [Công cụ hiện có của bạn](#compatibility)
- [Trao đổi cuộc gọi](#migration)
- [Ngoài tìm kiếm](#workflows)
- [Triển khai tác nhân](#agents)
- [Câu hỏi thường gặp](#faq)

<a id="features"></a>
## So sánh tính năng

Giữ các trường tìm kiếm quen thuộc, bắt đầu bằng việc mua tín dụng nhỏ hơn và thêm các công việc đã lưu hoặc bằng chứng YouTube khi quy trình làm việc của bạn cần chúng.

### Bắt đầu với một cam kết nhỏ hơn

| tính năng | FlashData | Serper.dev |
| --- | --- | --- |
| Mua tín dụng tối thiểu | $10 — $1.00 / 1,000 · thanh toán theo nhu cầu | $50.00 — $1.00 / 1,000 · Starter |
| Trợ cấp tìm kiếm tài khoản mới | Lên tới 2,000 tìm kiếm — Trợ cấp đăng ký một lần | 2,500 truy vấn miễn phí — Ưu đãi đăng ký |
| Dùng thử tác nhân trước khi đăng ký chủ sở hữu | Có — Lên tới 50 Google tìm kiếm · 72 giờ | Đăng ký và sử dụng khóa tài khoản API |

### Duy trì hoạt động của công cụ tìm kiếm của bạn

| tính năng | FlashData | Serper.dev |
| --- | --- | --- |
| Web, hình ảnh, tin tức, mua sắm, video và địa điểm | Có — Sáu nguồn Google | Có — Điểm cuối Google tương ứng |
| Nhắm mục tiêu theo quốc gia, ngôn ngữ và địa phương | gl, hl và vị trí — Thông số bên trong | gl, hl và vị trí — Các trường yêu cầu cấp cao nhất |
| Bộ lọc ngày cho tin tức và nghiên cứu | Có — params.tbs · ví dụ qdr:w | Có — tbs · ví dụ qdr:w |
| Trang tiếp theo và số kết quả được yêu cầu | params.page và params.num — Số trang bắt đầu từ 1 | trang và số — Số trang bắt đầu từ 1 |
| Tiêu đề, nguồn URLs và đoạn trích | Mảng kết quả không phải trả tiền — tiêu đề, liên kết, đoạn trích và vị trí | Mảng kết quả không phải trả tiền — tiêu đề, liên kết, đoạn trích và vị trí |
| Câu hỏi, câu trả lời và bối cảnh thực thể | Có — Mọi người cũng hỏi, hộp trả lời và biểu đồ kiến thức khi được trả về | Có — Mọi người cũng hỏi, hộp trả lời và biểu đồ kiến thức khi được trả về |

### Công cụ dành cho tác nhân và công việc nền

| tính năng | FlashData | Serper.dev |
| --- | --- | --- |
| Độc lập chính thức CLI | Có — Linux, macOS và Windows · không có thời gian chạy để cài đặt | Không được nêu — Trong danh mục sản phẩm công cộng |
| Markdown kết quả tìm kiếm từ API | Có — Chọn nội dung JSON hoặc Markdown | JSON kết quả tìm kiếm |
| async công việc liên tục mà bạn có thể tiếp tục trước ID | Có — Gửi, lưu ID, truy xuất sau | Không được nêu — Luồng tìm kiếm đã xuất bản trả về realtime kết quả |
| Google truy vấn trong một lần gửi JSON | kế hoạch 100 trả theo mức sử dụng — Persisted Batch · up to 500 by | Lên tới 100 truy vấn — Mini-batch trả về các câu trả lời cùng nhau |
| Lệnh gọi lại hoàn thành cho các công việc nền | Có — callback_url trên mỗi async hoặc Truy vấn hàng loạt | Không được nêu — Trong luồng tìm kiếm đã xuất bản |
| Liên kết chủ tài khoản và bàn giao thông tin xác thực | Có — Yêu cầu một lần; sử dụng lại hồ sơ CLI đã lưu | Định cấu hình khóa tài khoản API |

### Tiếp tục từ tìm kiếm vào YouTube

| tính năng | FlashData | Serper.dev |
| --- | --- | --- |
| Tra cứu siêu dữ liệu theo YouTube video ID | Có — Siêu dữ liệu chuyên dụng YouTube API | Không được nêu — Google tìm kiếm video có sẵn |
| Chú thích được gắn dấu thời gian YouTube | Có — Văn bản chú thích và thời gian cho bằng chứng video | Không được nêu — Trong danh mục sản phẩm công cộng |
| YouTube phân phối video / âm thanh tới bộ lưu trữ của bạn | Có — YouTube Tải xuống API | Không được nêu — Trong danh mục sản phẩm công cộng |

Giao dịch mua bắt đầu sử dụng FlashData thanh toán theo mức độ bạn sử dụng và Serper Starter. Gói Serper lớn hơn có đơn vị giá thấp hơn; so sánh chúng trong máy tính. Bản dùng thử tác nhân tách biệt với các ưu đãi đăng ký và phải đáp ứng đủ điều kiện. Không được liệt kê đề cập đến danh mục sản phẩm công cộng của Serper; sự tích hợp cộng đồng có thể tồn tại.

<a id="overview"></a>
## Điều gì sẽ làm cho việc chuyển đổi trở nên đáng giá?

Di chuyển phần khối lượng công việc cần thay đổi của bạn. Google tìm kiếm không phải trả tiền có thể di chuyển độc lập với các loại tìm kiếm chuyên biệt.

### Lượng tìm kiếm của bạn không đồng đều

Tỷ lệ gói thấp sẽ giúp ích khi bạn sử dụng truy vấn. So sánh giao dịch mua trả trước và mức sử dụng trong sáu tháng với tùy chọn trả theo mức sử dụng của FlashData.

[Kiểm tra việc sử dụng gói](#costs)

### Đại lý của bạn cần bằng chứng từ video

Kết quả video Google mang lại cho bạn URL. FlashData có ​​thể tiếp tục với siêu dữ liệu YouTube, chú thích được gắn dấu thời gian và gửi tới bộ lưu trữ của bạn.

[Xem nhiệm vụ hoàn chỉnh](#workflows)

### Công cụ tìm kiếm của bạn là một phần của hệ thống lớn hơn

Giữ nguyên định dạng trích dẫn và đầu vào công cụ của tổng đài viên trong khi di chuyển cuộc gọi của nhà cung cấp. Thêm các công việc liên tục khi công việc phải tiếp tục sau khi thoát khỏi quá trình.

[Kiểm tra sự tích hợp của bạn](#compatibility)

<a id="costs"></a>
## Đơn giá và mua trả trước

Gói Serper là các giao dịch mua trả trước, không phải đăng ký hoặc nạp lại truy vấn hàng tháng. Tất cả các gói được liệt kê đều có hiệu lực tín dụng sáu tháng. FlashData cung cấp các khoản tín dụng chia sẻ trả trước và các gói hàng tháng tùy chọn.

### FlashData Google Kế hoạch tìm kiếm

| kế hoạch | Mỗi 1,000 yêu cầu | Phí hằng tháng | Các khoản tín dụng bao gồm | Google Yêu cầu tìm kiếm |
| --- | --- | --- | --- | --- |
| Thanh toán theo mức sử dụng | $1.00 | $0 · không tính phí hàng tháng | không có | Nạp tiền khi cần thiết |
| Micro | $0.80 | $49.00 | 1,000 ($50.00 mức sử dụng) | ≈ 62,500 |
| Starter | $0.65 | $199.00 | 4,000 ($200.00 mức sử dụng) | ≈ 307,692 |
| Pro | $0.60 | $499.00 | 10,000 ($500.00 mức sử dụng) | ≈ 833,333 |
| Scale | $0.50 | $999.00 | 20,000 ($1,000.00 mức sử dụng) | ≈ 2,000,000 |
| Business | $0.40 | $1,999.00 | 40,000 ($2,000.00 mức sử dụng) | ≈ 5,000,000 |

Các khoản tín dụng được bao gồm sẽ gia hạn mỗi kỳ thanh toán. Yêu cầu phụ cấp giả định toàn bộ số dư được chia sẻ sẽ chuyển đến Google Tìm kiếm.

### Serper.dev gói trả trước

| Gói trả trước | Mỗi 1,000 truy vấn | Mua gói | Truy vấn mỗi gói | Phí hằng tháng | Truy vấn / giây |
| --- | --- | --- | --- | --- | --- |
| Starter | $1.00 | $50.00 | 50,000 | $0 | 50 |
| Tiêu chuẩn | $0.75 | $375.00 | 500,000 | $0 | 100 |
| Scale | $0.50 | $1,250.00 | 2,500,000 | $0 | 200 |
| Ultimate | $0.30 | $3,750.00 | 12,500,000 | $0 | 300 |

### Khối lượng công việc mẫu: FlashData thanh toán theo mức sử dụng và Serper Starter

Chọn từng nhà cung cấp một cách độc lập. Chi phí hàng tháng của FlashData là phí hàng tháng cộng với việc sử dụng tìm kiếm trên giá trị tín dụng đi kèm. Các yêu cầu được bao gồm giả sử tất cả các khoản tín dụng được chia sẻ đều chuyển đến Google Tìm kiếm. Chi phí hàng tháng theo mô hình thấp nhất sẽ chọn gói FlashData có ​​tổng chi phí nhỏ nhất theo số lượng của bạn. Chi phí hiệu quả hàng tháng cho mỗi 1,000 là tổng chi phí chia cho số lần tìm kiếm hàng tháng đã nhập, nhân với 1,000. Đơn giá của Serper là số lần mua gói chia cho số lượng truy vấn của nó, nhân với 1,000. Giá trị sử dụng hiển thị số tín dụng đã sử dụng; nó không phải là phí thuê bao hàng tháng. Bắt đầu không có tín dụng Serper, ước tính mua hàng sẽ làm tròn thành toàn bộ gói theo tỷ lệ đã chọn; các truy vấn không sử dụng vẫn còn trong các gói đã mua và sẽ hết hạn sau sáu tháng. Dự báo gói đầu tiên giả định một gói được mua ngay bây giờ và cùng số lượng hàng tháng trong sáu tháng: số truy vấn được sử dụng = phút(kích thước gói, số lượng hàng tháng × 6); chi phí hiệu quả trên mỗi 1,000 = giá gói ÷ truy vấn được sử dụng × 1,000. Việc mua gói sau này nằm ngoài dự báo đó. Ở mức không tìm kiếm, không cần mua gói và chi phí hiệu quả không được xác định. FlashData các lần nạp tiền tự phục vụ bắt đầu từ $10 và có thể để lại số dư tín dụng. Tín dụng dùng thử, số dư hiện có, thuế và việc sử dụng API khác không được bao gồm.

| Số lượt tìm kiếm/tháng | FlashData chi phí hàng tháng theo mô hình | Serper giá trị sử dụng | Serper mua trọn gói từ con số 0 | Truy vấn còn lại sau tháng |
| --- | --- | --- | --- | --- |
| 1,000 | $1.00 | $1.00 | $50.00 | 49,000 |
| 10,000 | $10.00 | $10.00 | $50.00 | 40,000 |
| 100,000 | $100.00 | $100.00 | $100.00 | 0 |
| 1,000,000 | $1,000.00 | $1,000.00 | $1,000.00 | 0 |

Những tình huống này sử dụng tỷ lệ của Serper Starter. Tỷ lệ thấp hơn từ gói lớn hơn yêu cầu mua gói lớn hơn. Sử dụng máy tính HTML để chọn từng gói một cách độc lập.

### Bạn sẽ sử dụng một gói trước khi nó hết hạn?

Giả sử một gói được mua ngay bây giờ và cùng một lượng tìm kiếm hàng tháng trong sáu tháng. Truy vấn giới hạn được sử dụng ở kích thước của gói đầu tiên đó; việc mua gói sau này nằm ngoài dự báo này. Chia giá của gói đầu tiên cho các truy vấn đã sử dụng để tìm chi phí hiệu quả cho mỗi 1,000.

| Gói đầu tiên | Số lượt tìm kiếm/tháng | Mua gói | Sử dụng trong vòng sáu tháng | Chưa sử dụng khi hết hạn | Chi phí hiệu quả / 1,000 đã sử dụng |
| --- | --- | --- | --- | --- | --- |
| Starter | 1,000 | $50.00 | 6,000 | 44,000 | $8.33 |
| Tiêu chuẩn | 1,000 | $375.00 | 6,000 | 494,000 | $62.50 |
| Starter | 10,000 | $50.00 | 50,000 | 0 | $1.00 |
| Tiêu chuẩn | 10,000 | $375.00 | 60,000 | 440,000 | $6.25 |

Ở mức không tìm kiếm, không cần gói và chi phí hiệu quả không được xác định. Nếu gói đầu tiên được sử dụng hết, chi phí hiệu quả của nó sẽ bằng với mức giá được quảng cáo. Đối với gói FlashData hàng tháng, hãy tính toán (phí hàng tháng + mức sử dụng trên các khoản tín dụng đã bao gồm) ` số lần tìm kiếm hàng tháng × 1,000; tỷ lệ được quảng cáo thấp không loại bỏ phí đăng ký ở mức âm lượng thấp.

[Giá FlashData](https://flashdata.dev/vi/pricing/google-search) · [So sánh chi phí tương tác](https://flashdata.dev/vi/compare/serper#costs)

### Đăng ký dùng thử

Các tài khoản FlashData mới đủ điều kiện có thể thử tới 2,000 Google tìm kiếm sau khi đăng ký và xác minh email, sử dụng toàn bộ số dư dùng thử được chia sẻ cho tìm kiếm. Không cần thẻ.
Serper cung cấp 2,500 truy vấn dùng thử miễn phí, không cần thẻ. Đây không phải là khoản trợ cấp hàng tháng định kỳ.

[Dùng thử khi đăng ký FlashData](https://flashdata.dev/vi/products/google-search#trial-faq)

<a id="compatibility"></a>
## Giữ hợp đồng mà tác nhân của bạn đã sử dụng

Tích hợp Serper có thể trả về một chuỗi, từ điển hoặc tài liệu có liên kết. Giữ tên công cụ và lược đồ đầu vào ổn định, đồng thời điều chỉnh phản hồi của FlashData bên trong công cụ.

| Tích hợp hiện có | Sản lượng hiện tại | Những gì cần bảo tồn |
| --- | --- | --- |
| LangChain · GoogleSerperAPIWrapper | results() trả về một từ điển; run() kết hợp các đoạn đã chọn thành một chuỗi. | Kiểm tra xem chuỗi của bạn gọi phương thức nào. Trả về một mảng trong đó bước tiếp theo dự kiến ​​văn bản sẽ thay đổi hợp đồng công cụ. |
| CrewAI · SerperDevTool | Chấp nhận search_query và trả về kết quả có cấu trúc, bao gồm các khối tùy chọn. | Giữ search_query làm đầu vào công cụ. Ánh xạ các trường mà nhân viên của bạn đọc; chỉ thay thế SERPER_API_KEY thì không thể chuyển đổi nhà cung cấp. |
| Haystack · SerperDevWebSearch | Trả về tài liệu và liên kết. Tài liệu chứa các đoạn tìm kiếm. | Bảo toàn cả đầu ra và nguồn URLs. Giữ lại thành phần tìm nạp nội dung riêng biệt khi quy trình của bạn cần các trang đầy đủ. |

[Xây dựng bộ chuyển đổi công cụ HTTP](https://flashdata.dev/vi/docs/guides/search-in-an-app/reference.md#tool)

### Những loại tìm kiếm có thể di chuyển?

| Nhiệm vụ hiện tại của bạn | Quyết định di cư | FlashData nguồn hoặc bước tiếp theo |
| --- | --- | --- |
| Google kết quả trên web | Di chuyển cuộc gọi tìm kiếm không phải trả tiền và bình thường hóa đầu ra của nó. | google_search |
| Hình ảnh, Tin tức, Mua sắm, Video, Địa điểm | Ánh xạ từng tác vụ tới nguồn và trình phân tích cú pháp chuyên dụng của nó. | google_images, google_news, google_shopping, google_videos, google_places |
| Học giả, Bằng sáng chế, Tự động hoàn thành | Giữ các cuộc gọi này với nhà cung cấp hiện tại của bạn; FlashData không có sản phẩm tương đương trực tiếp trong danh mục hiện tại của nó. | Không có tương đương trực tiếp |
| Toàn văn từ một trang web được liên kết | Giữ lại bước tìm nạp và trích xuất trang của bạn sau khi tìm kiếm. | Đoạn tìm kiếm không phải là toàn bộ bài viết |

### Ánh xạ yêu cầu và phản hồi chính xác

| Thay đổi | Serper.dev | FlashData | Ghi chú di chuyển |
| --- | --- | --- | --- |
| Yêu cầu tìm kiếm | POST /search | POST /v1/queries/realtime | Sử dụng máy chủ và nguồn dữ liệu FlashData=google_search. |
| phím API | tiêu đề X-API-KEY | tiêu đề X-API-Key | Vỏ tiêu đề không phải là sự khác biệt. Sử dụng phím FlashData với quyền google_search. |
| Truy vấn | q | query | Đổi tên trường yêu cầu. |
| Quốc gia, ngôn ngữ, số lượng | gl, hl, num | params.gl, params.hl, params.num | Tùy chọn lồng theo thông số; giữ giá trị của họ. |
| Bộ lọc vị trí và thời gian | vị trí, tbs | params.location, params.tbs | Giữ nguyên nhắm mục tiêu được sử dụng bởi nhiệm vụ hiện tại của bạn. |
| Kết quả không phải trả tiền | hữu cơ[] | kết quả[0].hữu cơ[] | Đọc trình bao bọc phản hồi FlashData sau trạng thái=done. |
| Trường nguồn | title, link, snippet, position | title, link, snippet, position | Giữ các trường trích dẫn của ứng dụng của bạn; bình thường hóa liên kết đến url nếu cần. |
| Truy vấn liên quan | relatedSearches[] | kết quả[0].relatedSearches[] | Hãy coi đây là tùy chọn; tiêu thụ từng trường truy vấn khi có mặt. |
| Câu hỏi liên quan | peopleAlsoAsk[] | kết quả[0].peopleAlsoAsk[] | Một câu hỏi có thể đến mà không có câu trả lời, đoạn trích hoặc URL. Đừng cho rằng mọi đồ vật đều chứa bằng chứng. |
| Khối trả lời và thực thể | answerBox, knowledgeGraph | Không có ánh xạ một-một được đảm bảo | Nếu công cụ của bạn yêu cầu các khối này, hãy giữ đường dẫn đó cho đến khi các trường bắt buộc của nó có ánh xạ được hỗ trợ. |
| Tin tức, Hình ảnh hoặc Địa điểm | Một điểm cuối khác, chẳng hạn như /news | Một nguồn chuyên dụng như google_news | Chọn nguồn và sử dụng các tham số cũng như lược đồ kết quả riêng của nó. |

Chỉ ánh xạ các tùy chọn và khối kết quả mà nhiệm vụ của bạn sử dụng. Một câu hỏi liên quan tùy chọn không tự động là một câu hỏi được trả lời kèm theo nguồn.

[Lược đồ Google Search của FlashData](https://flashdata.dev/vi/docs/sources/google_search/reference.md)

<a id="migration"></a>
## Di chuyển tìm kiếm

1. Đăng ký hoặc đăng nhập vào FlashData, hoàn tất thiết lập tài khoản và tạo khóa API với quyền google_search. Kiểm tra các khoản tín dụng có sẵn. Tổng đài viên có thể sử dụng lại quyền truy cập đã lưu của mình hoặc sử dụng quy trình dùng thử đủ điều kiện bên dưới.
2. Chọn Python hoặc Bash. Lưu tập lệnh Python hoàn chỉnh dưới tên tệp được hiển thị trong thư mục tác vụ của bạn trước running. Mỗi khối gửi một tìm kiếm; running cả hai phiên bản đều truy vấn cả hai nhà cung cấp.
3. Kiểm tra các hồ sơ chuẩn hóa. FlashData yêu cầu trạng thái=done trước khi đọc kết quả[0].organic. Kết quả không phải trả tiền có thể hợp lệ. Giữ tiêu đề, URL, đoạn trích và vị trí trích dẫn.

[Thiết lập tài khoản](https://flashdata.dev/signup) · [Khóa API](https://flashdata.dev/app/api-keys) · [Số dư tín dụng khả dụng](https://flashdata.dev/app/billing)

### Python

Python 3, chỉ thư viện tiêu chuẩn. Lưu tập lệnh hoàn chỉnh dưới tên tệp hiển thị trong thư mục tác vụ của bạn, sau đó chạy nó. Nó đọc biến môi trường hoặc nhắc nhở riêng về một khóa. Mỗi tập lệnh thực hiện một tìm kiếm.

#### Serper.dev: serper-search.py

```python
import getpass, json, os
from urllib.request import Request, urlopen
from urllib.error import HTTPError, URLError

key = os.environ.get("SERPER_API_KEY")
if not key:
    key = getpass.getpass("Serper key: ")
payload = {"q": "openai", "gl": "us", "hl": "en", "num": 10}
request = Request("https://google.serper.dev/search",
    data=json.dumps(payload).encode(),
    headers={"X-API-KEY": key, "Content-Type": "application/json"})
try:
    with urlopen(request, timeout=120) as response:
        body = json.load(response)
except HTTPError as error:
    raise SystemExit(f"HTTP {error.code}; check access and request input.") from None
except (URLError, TimeoutError):
    raise SystemExit("No response; check state before retrying.") from None
if body.get("error"):
    raise SystemExit("Search failed; inspect its error before retrying.")
items = body.get("organic", [])
print(json.dumps([{
    "position": item.get("position"), "title": item.get("title"),
    "url": item.get("link"), "snippet": item.get("snippet")
} for item in items], ensure_ascii=False, indent=2))
```

Chạy sau khi lưu: `python3 serper-search.py`

#### FlashData: flashdata-search.py

```python
import getpass, json, os
from urllib.request import Request, urlopen
from urllib.error import HTTPError, URLError

key = os.environ.get("FLASHDATA_API_KEY")
if not key:
    key = getpass.getpass("FlashData key: ")
payload = {"source": "google_search", "query": "openai",
           "params": {"gl": "us", "hl": "en", "num": 10}}
request = Request("https://data.flashdata.dev/v1/queries/realtime",
    data=json.dumps(payload).encode(),
    headers={"X-API-Key": key, "Content-Type": "application/json"})
try:
    with urlopen(request, timeout=120) as response:
        body = json.load(response)
except HTTPError as error:
    raise SystemExit(f"HTTP {error.code}: check input and access.") from None
except (URLError, TimeoutError):
    raise SystemExit("No response; check state before retrying.") from None
if body.get("status") != "done":
    raise SystemExit("Search is not complete; check its status.")
items = (body.get("results") or [{}])[0].get("organic", [])
print(json.dumps([
    {"position": item.get("position"), "title": item.get("title"),
     "url": item.get("link"), "snippet": item.get("snippet")}
    for item in items
], indent=2, ensure_ascii=False))
```

Chạy sau khi lưu: `python3 flashdata-search.py`

### cURL / Bash

Bash, cURL 7.76+ và jq. Chạy một trong hai khối hoàn chỉnh trong thư mục tác vụ của bạn. Nó chỉ nhắc khi thiếu biến môi trường của nhà cung cấp, lưu phản hồi thô và in kết quả chuẩn hóa. Mỗi khối gửi một tìm kiếm.

#### Serper.dev: Serper.dev · Bash

```bash
if [ -z "${SERPER_API_KEY:-}" ]; then
  read -r -s -p "Serper key: " SERPER_API_KEY
  printf '\n'
fi
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://google.serper.dev/search' \
  --header "X-API-KEY: $SERPER_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"q":"openai","gl":"us","hl":"en","num":10}' \
  --output serper-result.json &&
jq 'if .error then error("Search failed; check the response") else
  [(.organic // [])[] | {position, title, url: .link, snippet}]
  end' serper-result.json
```

#### FlashData: FlashData · Bash

```bash
if [ -z "${FLASHDATA_API_KEY:-}" ]; then
  read -r -s -p "FlashData key: " FLASHDATA_API_KEY
  printf '\n'
fi
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"openai",
           "params":{"gl":"us","hl":"en","num":10}}' \
  --output flashdata-result.json &&
jq 'if .status == "done" then
  [(.results[0].organic // [])[] | {position, title, url: .link, snippet}]
  else error("Search not complete; check status before retrying") end' flashdata-result.json
```

### Hình dạng đầu ra được chuẩn hóa

Kết quả minh họa; các ví dụ đổi tên liên kết thành url.

```json
[
  {
    "position": 1,
    "title": "OpenAI | Research & Deployment",
    "url": "https://openai.com/",
    "snippet": "..."
  }
]
```

### Trước khi thay đổi công cụ sản xuất của bạn

| trường hợp | Những gì cần kiểm tra |
| --- | --- |
| Tìm kiếm đại diện | Sử dụng quốc gia, ngôn ngữ và vị trí hiện tại của bạn. Kiểm tra các trường bắt buộc và trích dẫn có thể sử dụng được; không so sánh byte xếp hạng trực tiếp với byte. |
| Kết quả trống hoặc một phần | Danh sách không phải trả tiền trống là hợp lệ. Các khối tùy chọn bị thiếu không được trở thành câu trả lời bịa đặt hoặc bằng chứng không được trích dẫn. |
| Lỗi truy cập và tín dụng | Lỗi xác thực bề mặt, quyền và số dư. Một lỗi không được giống như một tìm kiếm thành công mà không có kết quả phù hợp. |
| Giới hạn tỷ lệ hoặc phản hồi bị mất | Sử dụng số lần thử có giới hạn để có giới hạn tốc độ rõ ràng. Kiểm tra trạng thái công việc đã lưu sau khi hết thời gian chờ; tránh tự động khởi chạy nhà cung cấp thứ hai khi có yêu cầu không chắc chắn. |

Bắt đầu với một quy trình công việc. Giữ cấu hình nhà cung cấp hiện tại có sẵn để khôi phục có chủ ý; gửi mọi yêu cầu đến cả hai nhà cung cấp sẽ thêm một tìm kiếm có thể tính phí khác.

### Công việc nền và phục hồi

Một trình bao bọc async Python xử lý đang chờ bên trong quy trình đó. Đối với công việc phải tiếp tục khởi động lại, hãy gửi công việc FlashData async được duy trì, lưu ID của nó và truy xuất công việc đó sau. Nhóm hàng loạt các truy vấn đã biết; Xử lý hàng loạt một tập tin.

[Yêu cầu thời gian thực và bất đồng bộ](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md) · [Yêu cầu Batch và xử lý Bulk](https://flashdata.dev/vi/docs/reference/batch-and-bulk/reference.md) · [Lỗi](https://flashdata.dev/vi/docs/errors/reference.md)

<a id="workflows"></a>
## Điều gì xảy ra sau khi tác nhân của bạn tìm thấy một liên kết?

Google Tìm kiếm, YouTube Dữ liệu và YouTube Tải xuống chia sẻ số dư tài khoản, với các mức giá và quyền riêng biệt.

### Xây dựng một bản tóm tắt nghiên cứu với bằng chứng video

Bắt đầu với: Câu hỏi về công ty, sản phẩm hoặc nghiên cứu.

1. Google Tìm kiếm: khám phá nguồn
2. YouTube Tìm kiếm: tìm video liên quan
3. Siêu dữ liệu + chú thích: thu thập bằng chứng được đánh dấu thời gian

Nhận: Tóm tắt với các liên kết nguồn và dấu thời gian video.

Giữ trích xuất trang web cho các bài viết đầy đủ. Nếu video không có chú thích, hãy ghi lại khoảng trống đó thay vì coi tiêu đề là bản ghi.

[Xây dựng quy trình nghiên cứu](https://flashdata.dev/vi/docs/guides/google-youtube-research/reference.md)

### Cung cấp video đã chọn vào bộ lưu trữ của bạn

Bắt đầu với: Một video YouTube được chọn bởi ứng dụng của bạn.

1. Siêu dữ liệu: xác nhận video đã chọn
2. Tải về: gửi công việc giao hàng
3. Lưu trữ: giữ chi tiết đối tượng được giao

Nhận: Video hoặc âm thanh trong bộ lưu trữ được định cấu hình của bạn, ready cho công việc tiếp theo.

Sử dụng quyền truy cập của chủ sở hữu với quyền youtube_download. Quyền truy cập dùng thử tác nhân tạm thời không bao gồm Tải xuống. Phân phối sử dụng giá dựa trên byte của riêng mình.

[Xây dựng đường ống phân phối](https://flashdata.dev/vi/docs/guides/media-delivery-pipeline/reference.md)

### Làm phong phú tập tin video đã biết IDs

Bắt đầu với: Danh sách hiện có của YouTube video IDs.

1. Chuẩn bị tệp văn bản có một video ID trên mỗi dòng
2. Hàng loạt: gửi một lần và lưu công việc ID
3. Kết quả: truy xuất đầu ra và kiểm tra failed mục

Nhận: Tập dữ liệu mà ứng dụng của bạn có thể kết hợp trở lại IDs ban đầu.

Bỏ qua Google Tìm kiếm khi bạn đã biết IDs. Tiếp tục công việc ID để quá trình được khởi động lại sẽ tiếp tục công việc hiện có.

[Xử lý tệp với số lượng lớn](https://flashdata.dev/vi/docs/guides/bulk/reference.md)

<a id="agents"></a>
## Di chuyển một công cụ trước khi di chuyển toàn bộ tác nhân

Sử dụng lại thông tin xác thực đã lưu trước. Sử dụng CLI cho các tác vụ đầu cuối hoặc máy chủ có khả năng MCP cho các lệnh gọi công cụ. Không có quyền truy cập hiện tại, hãy đọc auth.md và danh mục quyền trước khi bắt đầu một danh tính tạm thời đủ điều kiện.

Bản dùng thử tác nhân hiện tại: 1 tín dụng, lên tới 50 Google lượt tìm kiếm, 72 giờ. Đây là khoản trợ cấp ban đầu tùy thuộc vào giới hạn đăng ký và tính đủ điều kiện.

### Lời nhắc di chuyển

```text
Read https://flashdata.dev/compare/serper/reference.md and https://flashdata.dev/auth.md.
Inspect my Serper tool, including its input, country/language filters, output type and consumed fields.
Report unsupported search types or required answer/entity blocks before changing the integration.
Migrate one supported Google organic-search task; retain specialized calls and existing credentials.
Preserve the tool name, input schema, text-or-record output and source URLs.
Reuse existing FlashData access; otherwise check eligibility before starting one trial.
Keep keys in the host secret store, outside chat and source control.
Check normal, empty, missing-optional-field and error responses with local fixtures.
Run one search for "openai" with gl=us, hl=en and num=10; save the result and usage.
Do not automatically call both providers or retry an uncertain submission.
Do not buy credits. For recurring use, ask the owner to claim and approve access.
Reuse the same profile and state directory. Stop on revocation or insufficient credits.
```

### CLI: hồ sơ mặc định hiện có

Hoàn tất [Cài đặt và xác thực CLI](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md) trước. Các lệnh này kiểm tra quyền truy cập, xác thực yêu cầu rồi thực hiện một lượt tìm kiếm:

```bash
flashdata auth status --json --non-interactive &&
flashdata search "openai" --gl us --hl en --num 10 \
  --dry-run --json --non-interactive &&
flashdata search "openai" --gl us --hl en --num 10 \
  --run-id serper-migration-first --json --non-interactive
```

Để xác nhận quyền sở hữu, chủ sở hữu đăng nhập hoặc đăng ký, xác minh email và phê duyệt quyền nguồn cũng như việc sử dụng số dư chung. Giữ lại hồ sơ gốc để chuyển giao thông tin xác thực. Các khoản tín dụng tạm thời chưa sử dụng sẽ không được chuyển nhượng. Quyền truy cập được yêu cầu sử dụng số dư của chủ sở hữu; yêu cầu không mua tín dụng hoặc tạo giới hạn chi tiêu cho mỗi phím.

Đối với các tác vụ định kỳ, hãy giữ thông tin xác thực chủ sở hữu đã lưu và thư mục trạng thái liên tục. Sử dụng một lần chạy ID cho mỗi lần xuất hiện theo lịch trình và tương tự ID khi khôi phục lần xuất hiện đó. CLI chỉ có thể sử dụng lại kết quả completed khi trạng thái đã lưu của nó vẫn có sẵn. Công cụ HTTP cần có trạng thái bền vững của riêng nó; lần chạy CLI ID không phải là tiêu đề bình thường API. Dừng khi quyền truy cập bị thu hồi hoặc tín dụng không đủ. Không đăng ký dùng thử thay thế hoặc mua tín dụng tự động.

[Quyền truy cập của tác nhân](https://flashdata.dev/auth.md) · [Liên kết với tài khoản](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md) · [Codex](https://flashdata.dev/vi/docs/integrations/codex/reference.md) · [OpenClaw](https://flashdata.dev/vi/docs/integrations/openclaw/reference.md) · [Tác vụ định kỳ](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md)

<a id="faq"></a>
## Câu hỏi thường gặp

### Tôi đã mua một gói Serper. Tôi có phải di chuyển mọi thứ không?

Không. Trước tiên, hãy di chuyển một tác vụ được hỗ trợ và giữ lại các cuộc gọi khác trong khi bạn sử dụng gói hiện có của mình. Serper tín dụng không được chuyển sang FlashData. Giữ thông tin xác thực của nhà cung cấp riêng biệt và định tuyến từng nhiệm vụ một cách có chủ ý.

### Tôi nên so sánh mức giá nào: giá gói hay chi phí của các truy vấn tôi sử dụng?

Sử dụng cả hai. Tỷ lệ gói giả định bạn tiêu thụ toàn bộ gói; dự báo sử dụng cho biết điều gì sẽ xảy ra nếu bạn không làm như vậy. Đối với đăng ký FlashData, hãy so sánh phí hàng tháng và mức sử dụng đi kèm theo số lượng thực tế của bạn, chứ không chỉ đơn vị thấp hơn.

### Việc thay đổi SERPER_API_KEY có thay đổi công cụ tác nhân hiện tại của tôi không?

Không. Công cụ dành riêng cho Serper vẫn gọi điểm cuối của Serper và phân tích phản hồi của nó. Thay thế cuộc gọi của nhà cung cấp, sử dụng phím FlashData và điều chỉnh phản hồi cho cùng một đầu ra của công cụ. Kết nối MCP là một lựa chọn tích hợp riêng biệt, không phải là giá trị thay thế cho biến môi trường đó.

### Mọi kết quả và khối tìm kiếm phong phú có giống nhau không?

Kết quả trực tiếp có thể khác nhau về thứ tự và nội dung. Di chuyển các trường mà ứng dụng của bạn thực sự sử dụng. Tiêu đề tự nhiên, URL, đoạn mã và vị trí có bản đồ rõ ràng; các câu trả lời tùy chọn và các khối thực thể cần ánh xạ riêng trước khi bạn chuyển đường dẫn đó.

### Phương pháp async Python có mang lại cho tôi một công việc có thể tiếp tục không?

Phương thức máy khách async cho phép quy trình của bạn thực hiện công việc khác trong khi chờ phản hồi. Một công việc FlashData async được duy trì có một công việc ID bạn có thể lưu và truy xuất sau. Sử dụng cái sau khi công việc phải tồn tại sau khi khởi động lại quá trình và giữ nguyên ID đó trước khi lên lịch gửi một lần gửi khác.

### Một số dư có nghĩa là cùng một mức giá cho tìm kiếm, chú thích và tải xuống không?

Không. Các sản phẩm chia sẻ tín dụng nhưng có mức giá, đơn vị thanh toán và quyền riêng biệt. Tìm kiếm Google được tính phí dưới dạng yêu cầu tìm kiếm; phân phối phương tiện sử dụng giá dựa trên byte. Phê duyệt các quyền cần thiết của chủ sở hữu trước khi thêm sản phẩm mới vào quy trình làm việc định kỳ.

### Khi nào việc giữ Serper là sự lựa chọn đơn giản hơn?

Khi công cụ hiện tại của bạn đã thực hiện toàn bộ công việc, bạn sử dụng gói trả trước trong phạm vi hiệu lực của nó hoặc bạn dựa vào các trường Học giả, Bằng sáng chế, Tự động hoàn thành hoặc dành riêng cho nhà cung cấp mà không có FlashData tương đương. Bạn có thể giữ các cuộc gọi đó và sử dụng FlashData cho các quy trình công việc bổ sung mà bạn cần.

[Bản so sánh HTML](https://flashdata.dev/vi/compare/serper)
