ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

เอกสารอ้างอิง API

รูปแบบคำตอบ

เลือก JSON แบบมีโครงสร้างสำหรับแอป หรือเนื้อหา Markdown สำหรับเอเจนต์ AI กำหนดรูปแบบคำตอบด้วยสองเฮดเดอร์

ในหน้านี้

เลือกรูปแบบ

JSON ช่องข้อมูลผลลัพธ์เดิมเป็นค่าปริยาย Accept เลือก JSON หรือข้อความธรรมดา X-Respond-Withแปรงทาสี Markdown. ร่างที่ร้องขอของคุณอยู่ JSON

คำตอบAcceptX-Respond-Withใช้สําหรับ
JSONapplication/jsonOmitการจัดวางช่องข้อมูลในโค้ด 's' ปริยาย
JSON + Markdownapplication/jsonmarkdownแก้ไขโครงการหลัก.
ข้อความธรรมดาtext/plainOmitกําลังอ่านช่องข้อมูลต้นฉบับในเทอร์มินัล
ข้อความ + Markdowntext/plainmarkdownกําลังอ่านข้อมูลกํากับภาพ Markdown ด้วยกัน

ร้องขอและตัวอย่างการตอบกลับ

แท็บเหล่านี้แสดง Google Search แบบเดียวกันในแต่ละรูปแบบ ใช้ Bash ถึง cURL 7.76บวกด้วย FLASHDATA_API_KEY ตั้งเป็นกุญแจที่อนุญาตให้ใช้ google_search. ประมวลผลคําสั่ง จะส่งการค้นหาที่เชื่อถือได้หนึ่งรายการ

โดยปริยาย การ สืบ หา ผล ที่ จะ ได้ นั้น เป็น ลําดับ; ทุ่ง นา ภาย ใน ต้อง อาศัย แหล่ง กําเนิด.

ร้องขอ 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"}'
ตัวอย่างการตอบกลับ
{
  "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"
}

จุดสิ้นสุดที่รองรับ

กฎข้อเดียวกันนี้ใช้ได้กับ Google Search ถึง YouTube แหล่งข่าว. สําหรับ YouTube Download พวกเขาฟอร์แมตแผ่นเสียงส่ง ไม่ใช่วิดีโอหรือข้อมูลเสียง บัญชีเอพีไอ Bulk เปิดเผยและ NDJSON ชิ้นส่วน, การเรียกตัวและ MCP การตอบรับใช้รูปแบบของตนเอง

จุดสิ้นสุดJSON / ข้อความธรรมดาMarkdown เนื้อหา
POST /v1/queries/realtimeรับการรองรับรับการรองรับ
GET /v2/jobs/{id}/resultsรับการรองรับรับการรองรับ
POST /v1/queriesใบเสร็จการรับส่งไม่สนใจ — เลือกมันเมื่อผลของการอ่าน
POST /v1/queries/batchใบเสร็จการรับส่งไม่สนใจ — เลือกมันเมื่อผลของการอ่าน
GET /v2/jobs/{id}สถานะงานไม่สนใจ — ไม่มีเนื้อหาที่นี่

ฟอร์แมตผลลัพธ์ของงานพิมพ์ที่เสร็จสมบูรณ์

ตั้งค่าส่วนหัวเมื่ออ่านผลที่ออกมา แม้ว่าคุณจะตั้งมันให้เป็นยินยอมก็ตาม ตั้งค่า JOB_ID ไปยังงานที่เสร็จสมบูรณ์แล้ว คุณสามารถเข้าใช้งานได้ นี่ GET อ่านผลที่มีอยู่แล้วโดยไม่ต้องส่งการสอบถามอีก

รูปแบบที่ต้องการตอบสนองผล
เดิม JSON302 กับที่เซ็นต์ชื่อ URL ในสถานที่. ดึงที่ URL แยกกันอยู่, ไม่มี X-API-Key. ผลที่เก็บไว้อาจเกิดจาก gzip-comp
ข้อความธรรมดาหรือทั้ง Markdown ตัวเลือก200 โดยมีการจัดรูปแบบร่างกายโดยตรงในการตอบสนอง
เรียกข้อมูล Markdown ภายใน 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'

ฟอร์แมตข้อผิดพลาด

API ยังมีข้อผิดพลาดอยู่ JSON หรือ application/problem+Json แม้เมื่อคุณขอข้อความธรรมดา เช็คดูสิ HTTP สถานะก่อนจะจําแนกรูปแบบความสําเร็จ

สถานะ / รหัสแก้ไข
400 · unsupported_representationใช้ X-Respond-Withทําเครื่องหมายหรือข้ามส่วนหัว ไม่ มี การ สนับสนุน ค่า ต่าง ๆ เช่น เจ สัน หรือ ข้อ ความ.
406 · not_acceptableใช้ Accept: application/json หรือ text/plain. text/markdown ถึง application/xml ยังไม่รองรับ

Accept รายละเอียดหัวจดหมาย

Omit Accept หรือส่ง*/* ไปรับ JSON. การตอบโต้ใช้ UTF-8 รองรับช่วงของสื่อและน้ําหนักต่าง ๆ ของแฟ้มแบบ q; การพิมพ์กลับเป็นอักขระที่ไม่รองรับ 406 เว้นแต่ระยะที่ยอมรับได้อื่น ๆ ตรงกัน Content-Type: application/json จง พรรณนา ร่าง กาย ที่ ต้องการ ไม่ ใช่ การ ตอบ สนอง.

ข้อความทั่วไป, อนุญาตให้ใช้ JSON
Accept: text/plain; charset=utf-8, application/json;q=0.8