Duyệt tài liệu
Tham chiếu API
Chọn cấu trúc JSON cho ứng dụng của bạn hay Markdown Thỏa mãn cho một tác nhân AI. Kiểm soát phản ứng bằng hai đầu đạn.
Trên trang này
Chọn một định dạng
JSON với trường kết quả ban đầu là mặc định. Accept lựa chọn JSON hoặc chỉ đơn giản văn bản; X-Respond-With: Đánh dấu sẽ chuyển đổi nội dung kết quả thành Markdown. Yêu cầu của bạn cơ thể ở lại JSON.
| Phản hồi | Accept | X-Respond-With | Dùng cho |
|---|---|---|---|
| JSON | application/json | Omit | Phân tích trường trong mã· default |
| JSON + Markdown | application/json | markdown | Comment |
| Văn bản thường | text/plain | Omit | Đọc trường gốc trong thiết bị cuối |
| Văn bản + Markdown | text/plain | markdown | Đang đọc siêu dữ liệu và Markdown cùng nhau |
Ví dụ về việc yêu cầu và đáp ứng
Những thẻ tab này cũng hiển thị như vậy Google Search trong mỗi hình thức. Dùng Bash và cURL 7.76+ với FLASHDATA_API_KEY đặt thành một khóa cho phép google_search. Đang chạy một lệnh đệ trình tìm kiếm có thể tính được.
Mặc định. Phân tích các kết quả; các lĩnh vực bên trong nó phụ thuộc vào nguồn.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{"source":"google_search","query":"vector databases"}'{
"source": "google_search",
"status": "done",
"results": [
{
"organic": [
{
"title": "Example page",
"link": "https://example.com/article",
"snippet": "A short source snippet."
}
]
}
],
"usage": {
"credits": 0.01
},
"created_at": "2026-10-22T12:00:00.000Z"
}Đọc nội dung như một chuỗi Markdown. Nó thay thế kết quả; nguồn, trạng thái và sử dụng vẫn còn sẵn có như JSON Cánh đồng.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'{
"source": "google_search",
"status": "done",
"usage": {
"credits": 0.01
},
"created_at": "2026-10-22T12:00:00.000Z",
"content": "# Google search\n\n## Organic\n\n### 1. Example page\n\n**Link:** <https://example.com/article>\n\n**Snippet:** A short source snippet\\.\n"
}Hãy đọc câu trả lời trong phần Kinh Thánh. Nó chứa các trường gốc trong một bố trí đã nhận diện, không phải tài liệu JSON.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Results:
1:
Organic:
1:
Title: "Example page"
Link: "https://example.com/article"
Snippet: "A short source snippet."
Usage:
Credits: 0.01
Created at: "2026-10-22T12:00:00.000Z"
Đọc câu trả lời là văn bản: Siêu dữ liệu trước, tiếp theo là nội dung của Markdown.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Usage: {"credits":0.01}
Created at: "2026-10-22T12:00:00.000Z"
Markdown Content:
# Google search
## Organic
### 1. Example page
**Link:** <https://example.com/article>
**Snippet:** A short source snippet\.
Đã hỗ trợ điểm kết thúc
Luật tương tự cũng áp dụng cho Google Search và YouTube Nguồn truy vấn. Đối với YouTube Download, họ định dạng kỷ lục giao hàng, không phải video hoặc âm thanh byte. Tài khoản APIs, Bulk Bản kê khai và NDJSON phần, cuộc gọi lại và MCP Phản hồi sử dụng định dạng riêng của họ.
| Điểm kết thúc | JSON / plain text | Markdown Nội dung |
|---|---|---|
| POST /v1/queries/realtime | Đã hỗ trợ | Đã hỗ trợ |
| GET /v2/jobs/{id}/results | Đã hỗ trợ | Đã hỗ trợ |
| POST /v1/queries | Hóa đơn phục tùng | Bỏ qua — chọn khi đọc kết quả |
| POST /v1/queries/batch | Hóa đơn phục tùng | Bỏ qua — chọn khi đọc kết quả |
| GET /v2/jobs/{id} | Trạng thái công việc | Bỏ qua — không có nội dung ở đây |
Định dạng kết quả công việc hoàn tất
Khi đọc kết quả, hãy chọn người dẫn đầu, ngay cả khi bạn quy định họ phải vâng phục. Đặt JOB_ID thành một công việc hoàn tất bạn có thể truy cập. Cái này GET đọc kết quả đã có mà không gửi một yêu cầu khác.
| Định dạng đã yêu cầu | Phản ứng kết quả |
|---|---|
| gốc JSON | 302 với một kho lưu trữ có chữ ký URL ở địa điểm. Hãy phân chia URL, mà không cần X-API-Key. Kết quả đã lưu có thể bị gzip-compress. |
| Văn bản thường hoặc không Markdown tùy chọn | 200 với thông tin cơ thể trực tiếp trả lời. |
curl --fail-with-body --silent --show-error \
"https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}/results" \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Accept: application/json' \
--header 'X-Respond-With: markdown'Lỗi định dạng
API lỗi còn lại JSON hay application/problem+json, ngay cả khi bạn yêu cầu văn bản đơn giản. Kiểm tra trạng thái HTTP trước khi phân tích định dạng thành công.
| Trạng thái / mã | Sửa |
|---|---|
| 400 · unsupported_representation | Dùng X-Respond-With: đánh dấu xuống hoặc loại bỏ đầu trang. Không hỗ trợ giá trị như json hoặc văn bản. |
| 406 · not_acceptable | Dùng Accept: application/json hay text/plain. text/markdown và application/xml không được hỗ trợ. |
Accept chi tiết đầu trang
Omit Accept hoặc gửi ** để nhận JSON. Đáp ứng được dùng UTF-8. Phạm vi phương tiện và cân Q được hỗ trợ; một bộ ký tự không được hỗ trợ 406 Trừ khi có một phạm vi có thể chấp nhận được. Content-Type: application/json miêu tả cơ thể yêu cầu, chứ không phải phản ứng.
Accept: text/plain; charset=utf-8, application/json;q=0.8