เรียกดูเอกสาร
เอกสารอ้างอิง API
Google Search API
รับผลจากอินทรีย์ คําถามที่เกี่ยวข้องกัน และผลลัพธ์ที่มากมาย Google Search เป็นโครงสร้าง JSON. กรองโดยประเทศ ภาษาและสถานที่
สร้างคำขอ
พารามิเตอร์ขั้นสูง
เริ่มต้นที่ 1 แต่ละหน้าเป็นคําขอแยก
Google ตัวกรองเวลา เช่น Qdr: d สําหรับวันที่ผ่านมา
https://data.flashdata.dev/v1/queries/realtimeพารามิเตอร์
ส่ง source ถึง query ที่ระดับบนสุด ตัวเลือกของแหล่งอยู่ใน params. ช่องข้อมูลทางเลือกสามารถยกเลิกได้
เนื้อหาคำขอ
sourcestring / จำเป็น- กําหนดเป็น google_search
querystring / จำเป็น- สืบค้น การรองรับ Google ผู้ดําเนินการการค้นหาเช่นเว็บไซต์: และเนื้อหา:1 ถึง 2,000 ตัวอักษรค่าปริยาย:
ยังไม่ได้ตั้งค่า paramsobject / ไม่บังคับ- Settings สําหรับการร้องขอนี้ค่าปริยาย:
{} callback_urlstring · nullable / ไม่บังคับ- Async และชุดเท่านั้น สาธารณะ HTTPS เสร็จสมบูรณ์แล้ว URL บนพอร์ต 443ถึง 2,048 ตัวละคร ไม่มีเอกสารรับรองผู้ใช้หรือส่วน URL Omit, ใช้ null หรือข้อความเปล่าสําหรับไม่ให้แจ้งเตือน ในชุดนี้ กําหนดให้แต่ละคําถาม ภายนอกพม่าค่าปริยาย:
ยังไม่ได้ตั้งค่า
ประเทศ, ตําแหน่งภาษา
params.glstring / ไม่บังคับ- รหัสประจําประเทศ 2 ตัว เช่นเรา จีบี หรือ เอสจี ตั้งค่าโดยตรงเพื่อเลือกประเทศตรงกับ 2 ตัวอักษรค่าปริยาย:
ยังไม่ได้ตั้งค่ารูปแบบที่ยอมรับได้
^[A-Za-z]{2}$ params.hlstring / ไม่บังคับ- Google ภาษาอินเตอร์เฟส ตั้งค่าโดยตรงเพื่อเลือกภาษา1 ถึง 35 ตัวอักษรค่าปริยาย:
ยังไม่ได้ตั้งค่ารูปแบบที่ยอมรับได้
^[A-Za-z0-9-]+$ params.locationstring / ไม่บังคับ- ร้องขอสถานที่ค้นหา โดยเฉพาะอย่างยิ่งเป็นเมือง เช่น "London, England, United Kingdom" ความสามารถขึ้นอยู่กับชนิดของการค้นหา1 ถึง 200 ตัวอักษรค่าปริยาย:
ยังไม่ได้ตั้งค่า
การวางพาเนล
params.numinteger / ไม่บังคับ- ร้องขอผลนับ FlashData ไม่ได้ทําการเพิ่มค่าค่าปริยายที่คงที่เมื่อลบทิ้ง จํานวน ที่ กลับ มา อาจ ต่าง กัน ได้ โดย การ สอบ ถาม และ ชนิด การ ค้นคว้า.1 ถึง 100, จํานวนเต็มค่าปริยาย:
ยังไม่ได้ตั้งค่า params.pageinteger / ไม่บังคับ- หน้าผลการขอ ตั้งให้ตรง. แต่ละหน้าเป็นการร้องขอแยก API1 ถึง 100, จํานวนเต็มค่าปริยาย:
ยังไม่ได้ตั้งค่า
ตัวกรองการค้นหา
params.tbsstring / ไม่บังคับ- ต้องการ Google ตัวกรองสําหรับค้นหา เช่น Qdr: d สําหรับวันที่ผ่านมา หรือ qdr: w สําหรับสัปดาห์ที่ผ่านมา ความสามารถขึ้นอยู่กับชนิดของการค้นหา1 ถึง 200 ตัวอักษรค่าปริยาย:
ยังไม่ได้ตั้งค่า params.autocorrectboolean / ไม่บังคับ- ต้องการแก้ไขคําสะกดด้วย true หรือร้องขอให้ปิดการทํางาน false. พฤติกรรมประยุกต์ขึ้นอยู่กับชนิดของการค้นหา; การแทนที่ที่จะใช้ Googleพฤติกรรม
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า
คำตอบ
Realtime กลับค่า status: done ด้วยการแสดงผลการค้นหาใน results[0]. ตรงกันใน results[0].organic. usage.credits บันทึกค่าใช้จ่าย.
ตรงกันกับอวัยวะ รวมถึงหัวข้อ ลิงก์ และชิ้นส่วน คํา ถาม ที่ เกี่ยว ข้อง และ ผล ที่ เกิด ขึ้น มาก มาย เป็น สิ่ง ที่ ยอม รับ ได้.
อ่านผลที่ออกมา
บันทึกความสําเร็จ JSON ตอบกลับเป็น response.json. บันทึกนี้เป็น read-response.py และเรียกไพธอน read-response.py. มันใช้เฉพาะ Pythonห้องสมุดมาตรฐาน และไม่มีการร้องขอใหม่
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = [
{"title": item.get("title"), "url": item.get("link"), "snippet": item.get("snippet")}
for item in result.get("organic", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))ช่องข้อมูลที่มีอยู่จะขึ้นอยู่กับการค้นหาและชนิดการค้นหา อาจ ไม่ มี ทุ่ง นา แห่ง อื่น และ อาจ ได้ รับ การ กลับ มา อีก.
จํานวนรายการที่ส่งคืนและ searchParameters.num แตกต่างจาก params.num. ใช้อาร์เรย์ที่ส่งกลับเพื่อตรวจจํานวนผลลัพธ์ที่มีผลจริง
ช่องข้อมูลทั้งหมด
| ช่องข้อมูล | คําอธิบาย |
|---|---|
sourcestring | สิ่งที่ร้องขอมา API แหล่งข่าว |
statusstring | เสร็จสิ้นเมื่อการร้องขอจริง สําเร็จ |
created_atstring | ช่วงเวลาการสร้างแบบ ISO 8601 |
usage.creditsnumber | บัตรเครดิตตามที่ขอ จากแผนของคุณ |
results[0].searchParametersobject | ตั้งค่าการค้นหาโดย Google โดยมีการสืบค้นเป็น Q การตั้งค่าที่ส่งกลับอาจจะแตกต่างจากค่าที่ต้องการ |
results[0].organicarray | ผลของออร์แกนิกคือ ชื่อ, ลิงก์, ชิ้นส่วน และตําแหน่ง รวมไปถึงสาขาอื่นๆ เมื่อมี |
results[0].peopleAlsoAskarray · optional | คํา ถาม ที่ เกี่ยว ข้อง กับ คํา ตอบ และ แหล่ง ที่ มา เชื่อม โยง เมื่อ มี. |
results[0].relatedSearchesarray · optional | เชื่อมโยงคําค้น, แต่ละคํามีสนามค้นหา |
results[0].knowledgeGraphobject · optional | ข้อมูลความสมบูรณ์จากแผงความรู้ |
results[0].answerBoxobject · optional | คําตอบที่โดดเด่น สนาม มี ชนิด คํา ตอบ แตก ต่าง กัน ไป. |
ช่องข้อมูลด้านบน จะใช้อธิบายค่าปริยาย JSON ตอบสนอง JSONข้อความธรรมดาและ Markdown รูปแบบ.
Async วงจรชีวิตแบบชุด
การรับช่วงนําใบเสร็จกลับมา ไม่ใช่ผลลัพธ์ Async สร้างงานหนึ่งงาน; กลุ่มต่าง ๆ จะคืนค่ากลับมาเป็นงานที่แยกไว้ queries[] สําหรับทุก ๆ คนที่สอบถามเจ้า ติดตามและรับงานแต่ละงานเป็นอิสระ
ส่งข้อมูลไปยัง data.flashdata.dev; สืบค้นสถานะงานและผลลัพธ์จาก api.flashdata.dev กับ X-API-Key แบบเดียวกัน ความ เกี่ยว พัน API ตัวอย่างพื้นฐานที่ใช้ Python ถึง cURL.
1. บันทึกงาน IDs
เก็บรายการที่ต้องการของแหล่งนี้เมื่อสลับไปยัง Async สําหรับ Batchใส่การร้องขอแต่ละในลําดับของ JSON วัตถุ บันทึกงานที่ส่งกลับทั้งหมด ID
2. ตรวจสอบสถานะ
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: โพลด้วยความล่าช้าและความเคารพRetry-Afterเมื่อถึงวันนี้completed: รับผลfailed: สืบค้นเมื่อjob.error.อ่าน job.status ไม่ใช่สถานะใบเสร็จรับส่ง
ตรวจสอบสถานะที่: Python ถึง cURL
สถานะงาน API อ้างอิง3. ดึงข้อมูลผลลัพธ์
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsหลังจากเติมให้สมบูรณ์แล้ว ให้ยืนยันการอ่านผลที่อ่านแล้ว 302 คลังสื่อ URL # หากไม่มีเธอ # API กุญแจ บันทึก JSON ภายใน 24 ชั่วโมงของการเติมให้สมบูรณ์
ดึงข้อมูลผลลัพธ์ที่ออกมา Python ถึง cURL · รูปแบบคำตอบ
ดาวน์โหลดผลลัพธ์ API อ้างอิง
การ สํารวจ และ ได้ ผล ที่ มี อยู่ แล้ว ไม่ ได้ ใช้ เงิน เครดิต ที่ สอบ ถาม. จับเวลาแบบสํารวจไม่ได้ยกเลิกงาน: ให้ ID แทนการส่งงานที่ซ้ํากัน % 1 ไม่ถูกต้อง!.
Webhook เมื่อเสร็จสิ้น
บอกรับต่อคําค้น
ตั้งค่า callback_url ที่ระดับบนสุดของการร้องขอ Asinc หรือ ภายในแต่ละคําถาม ในชุดที่อยู่นอก params. ไม่มีความต้องการการแยกเว็บฮุค- regressing Realtime ร้องขอไม่ให้ส่งการเรียกกลับ
ใช้สาธารณะชน HTTPS URL บนพอร์ต 443. FlashDataPOSTS แจ้งเตือนสําหรับแต่ละงานพิมพ์ที่ไปถึง completed หรือ failed; เหตุการณ์ที่บรรจุลิงก์ ไม่ใช่ผลลัพธ์เอง
การยอมรับและตรวจสอบ
กลับค่า 2xx หลังจากยอมรับเหตุการณ์นั้น บิดเบี้ยวโดย delivery_id, ยังถูกส่งมาเป็น X-Delivery-Id. ไม่ ปฏิบัติ ตาม การ ชี้ นํา.
การส่งล้มเหลว การลองใหม่ด้วยการกลับแบบเอกซ์โปเนนเชียลขึ้นไป 8 พยายามรวมทั้งหมด และที่มากที่สุด 24 ชั่วโมงหลังจากเติมให้สมบูรณ์แล้ว. ให้การวินิจฉัยเป็น การผิดพลาด
การเรียกตัวยังไม่แน่ชัด ยืนยันงาน IDแหล่งที่มาและสถานะปลายทางผ่าน สถานะที่ยืนยันแล้ว ก่อนที่จะประมวลผลการแจ้งเตือน การส่งมอบ ID สําหรับ deduction, ไม่ใช่ข้อพิสูจน์ของความเป็นจริง
ตัวอย่าง Hook เหตุการณ์และช่องข้อมูล
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "google_search",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| ช่องข้อมูล | คําอธิบาย |
|---|---|
delivery_idstring | เครื่องระบุการจัดส่งที่ทนทาน การแจ้งให้ทราบแบบย่อโดยใช้ค่านี้; มันถูกส่งมาใน X-Delivery-Id ส่วนหัว |
idstring | Joob ID. |
sourcestring | ต้องการแหล่งข้อมูล |
statusstring | เสร็จสมบูรณ์หรือล้มเหลว |
linksarray | สถานะและการเชื่อมโยงผลลัพธ์ การแจ้งให้ทราบไม่รวมเนื้อหาหรือรายการที่มีผล API กุญแจ |
links[].relstring | ตัวตนหรือผลลัพธ์ |
links[].hrefstring | การจัดการสัมบูรณ์ API URL2; ยืนยันตัวด้วย API กุญแจ |
links[].methodstring | GET. |
การกู้คืนผิดพลาด
การค้นหาเสร็จสมบูรณ์ อาจมีตัวที่เข้าเงื่อนไขน้อยกว่าที่ต้องการ ตรวจสอบ gl, hl, สถานที่ที่และกรอง; เลือกพื้นที่อุดมไปด้วยอาจจะขาด
สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอunit-format และอัตราการสิ้นสุดของอัตรา - การอ้างอิงข้อผิดพลาดร่วมกัน เวลา ที่ ใช้ ไป แล้ว อาจ ยัง คง สร้าง งาน อยู่; ตรวจ สอบ งาน ที่ มี อยู่ ก่อน จะ ลอง ทํา ใหม่.
ข้อผิดพลาดและรหัสสถานะ · เมื่อต้องการลองใหม่ · ข้อจํากัดของอัตรา
ไกด์ทีละขั้น: เลือกและ ขัดมัน Google ค้นหา
ราคา
| แผน | อัตราการใช้ต่อ 1,000 คำขอ | สมาชิก | รวมการให้เครดิตต่อช่วงเวลาเรียกเก็บเงิน |
|---|---|---|---|
| จ่ายตามการใช้งาน | US$1.00 | ไม่มีค่าบริการรายเดือน | เติมเครดิตเมื่อจำเป็น |
| Micro | US$0.80 | US$49.00 / เดือน | 1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม |
| Starter | US$0.65 | US$199.00 / เดือน | 4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม |
| Pro | US$0.60 | US$499.00 / เดือน | 10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม |
| Scale | US$0.50 | US$999.00 / เดือน | 20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม |
| Business | US$0.40 | US$1,999.00 / เดือน | 40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม |
หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ
ราคาและแผนจํากัดในปัจจุบัน