Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Tham chiếu API

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

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ồiAcceptX-Respond-WithDùng cho
JSONapplication/jsonOmitPhân tích trường trong mã· default
JSON + Markdownapplication/jsonmarkdownComment
Văn bản thườngtext/plainOmitĐọc trường gốc trong thiết bị cuối
Văn bản + Markdowntext/plainmarkdownĐ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.

Yêu cầu · cURL / Bash
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"}'
Name
{
  "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"
}

Đã 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úcJSON / plain textMarkdown Nội dung
POST /v1/queries/realtimeĐã hỗ trợĐã hỗ trợ
GET /v2/jobs/{id}/resultsĐã hỗ trợĐã hỗ trợ
POST /v1/queriesHóa đơn phục tùngBỏ qua — chọn khi đọc kết quả
POST /v1/queries/batchHóa đơn phục tùngBỏ qua — chọn khi đọc kết quả
GET /v2/jobs/{id}Trạng thái công việcBỏ 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ầuPhản ứng kết quả
gốc JSON302 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ọn200 với thông tin cơ thể trực tiếp trả lời.
Lấy lại Markdown bên trong JSON · cURL / Bash
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_representationDù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_acceptableDù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.

Thích văn bản, cho phép JSON
Accept: text/plain; charset=utf-8, application/json;q=0.8