เรียกดูเอกสาร
เอกสารอ้างอิง API
เลือก JSON แบบมีโครงสร้างสำหรับแอป หรือเนื้อหา Markdown สำหรับเอเจนต์ AI กำหนดรูปแบบคำตอบด้วยสองเฮดเดอร์
ในหน้านี้
เลือกรูปแบบ
JSON ช่องข้อมูลผลลัพธ์เดิมเป็นค่าปริยาย Accept เลือก JSON หรือข้อความธรรมดา X-Respond-Withแปรงทาสี Markdown. ร่างที่ร้องขอของคุณอยู่ JSON
| คำตอบ | Accept | X-Respond-With | ใช้สําหรับ |
|---|---|---|---|
| JSON | application/json | Omit | การจัดวางช่องข้อมูลในโค้ด 's' ปริยาย |
| JSON + Markdown | application/json | markdown | แก้ไขโครงการหลัก. |
| ข้อความธรรมดา | text/plain | Omit | กําลังอ่านช่องข้อมูลต้นฉบับในเทอร์มินัล |
| ข้อความ + Markdown | text/plain | markdown | กําลังอ่านข้อมูลกํากับภาพ Markdown ด้วยกัน |
ร้องขอและตัวอย่างการตอบกลับ
แท็บเหล่านี้แสดง Google Search แบบเดียวกันในแต่ละรูปแบบ ใช้ Bash ถึง cURL 7.76บวกด้วย FLASHDATA_API_KEY ตั้งเป็นกุญแจที่อนุญาตให้ใช้ google_search. ประมวลผลคําสั่ง จะส่งการค้นหาที่เชื่อถือได้หนึ่งรายการ
โดยปริยาย การ สืบ หา ผล ที่ จะ ได้ นั้น เป็น ลําดับ; ทุ่ง นา ภาย ใน ต้อง อาศัย แหล่ง กําเนิด.
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"
}อ่านเนื้อหาเป็น Markdown สตริง มันแทนที่ผลลัพธ์; แหล่ง, สถานะ และการใช้งานยังคงมีอยู่ 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: 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"
}อ่านคําตอบเป็นข้อความ บรรจุช่องข้อมูลต้นฉบับในการจัดวางแบบย่อ ไม่ใช่เอกสาร 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"
อ่านการตอบกลับเป็นข้อความ: ข้อมูลกํากับภาพก่อน, ตามด้วย 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\.
จุดสิ้นสุดที่รองรับ
กฎข้อเดียวกันนี้ใช้ได้กับ 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 อ่านผลที่มีอยู่แล้วโดยไม่ต้องส่งการสอบถามอีก
| รูปแบบที่ต้องการ | ตอบสนองผล |
|---|---|
| เดิม JSON | 302 กับที่เซ็นต์ชื่อ URL ในสถานที่. ดึงที่ URL แยกกันอยู่, ไม่มี X-API-Key. ผลที่เก็บไว้อาจเกิดจาก gzip-comp |
| ข้อความธรรมดาหรือทั้ง Markdown ตัวเลือก | 200 โดยมีการจัดรูปแบบร่างกายโดยตรงในการตอบสนอง |
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 จง พรรณนา ร่าง กาย ที่ ต้องการ ไม่ ใช่ การ ตอบ สนอง.
Accept: text/plain; charset=utf-8, application/json;q=0.8