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

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

Google Search API

รับคีย์ API

รับผลจากอินทรีย์ คําถามที่เกี่ยวข้องกัน และผลลัพธ์ที่มากมาย Google Search เป็นโครงสร้าง JSON. กรองโดยประเทศ ภาษาและสถานที่

สร้างคำขอ

พารามิเตอร์ขั้นสูง

เริ่มต้นที่ 1 แต่ละหน้าเป็นคําขอแยก

Google ตัวกรองเวลา เช่น Qdr: d สําหรับวันที่ผ่านมา

POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_search",
    "query": "openai",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
ผลในการตอบสนอง HTTPX-API-Key ยืนยัน

พารามิเตอร์

ส่ง 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 / ไม่บังคับ
หน้าผลการขอ ตั้งให้ตรง. แต่ละหน้าเป็นการร้องขอแยก API
1 ถึง 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ห้องสมุดมาตรฐาน และไม่มีการร้องขอใหม่

read-response.py
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. 1. บันทึกงาน IDs

    เก็บรายการที่ต้องการของแหล่งนี้เมื่อสลับไปยัง Async สําหรับ Batchใส่การร้องขอแต่ละในลําดับของ JSON วัตถุ บันทึกงานที่ส่งกลับทั้งหมด ID

    Async ร้องขอและใบเสร็จ · Batch ต้องการตัวบุคคล

  2. 2. ตรวจสอบสถานะ

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: โพลด้วยความล่าช้าและความเคารพ Retry-After เมื่อถึงวันนี้ completed: รับผล failed: สืบค้นเมื่อ job.error.

    อ่าน job.status ไม่ใช่สถานะใบเสร็จรับส่ง

    ตรวจสอบสถานะที่: Python ถึง cURL

    สถานะงาน API อ้างอิง
  3. 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 ส่วนหัว
idstringJoob ID.
sourcestringต้องการแหล่งข้อมูล
statusstringเสร็จสมบูรณ์หรือล้มเหลว
linksarrayสถานะและการเชื่อมโยงผลลัพธ์ การแจ้งให้ทราบไม่รวมเนื้อหาหรือรายการที่มีผล API กุญแจ
links[].relstringตัวตนหรือผลลัพธ์
links[].hrefstringการจัดการสัมบูรณ์ API URL2; ยืนยันตัวด้วย API กุญแจ
links[].methodstringGET.

สัญญาเว็บฮุคแบบเต็มและ URL จํากัด

การกู้คืนผิดพลาด

การค้นหาเสร็จสมบูรณ์ อาจมีตัวที่เข้าเงื่อนไขน้อยกว่าที่ต้องการ ตรวจสอบ gl, hl, สถานที่ที่และกรอง; เลือกพื้นที่อุดมไปด้วยอาจจะขาด

สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอunit-format และอัตราการสิ้นสุดของอัตรา - การอ้างอิงข้อผิดพลาดร่วมกัน เวลา ที่ ใช้ ไป แล้ว อาจ ยัง คง สร้าง งาน อยู่; ตรวจ สอบ งาน ที่ มี อยู่ ก่อน จะ ลอง ทํา ใหม่.

ข้อผิดพลาดและรหัสสถานะ · เมื่อต้องการลองใหม่ · ข้อจํากัดของอัตรา

ไกด์ทีละขั้น: เลือกและ ขัดมัน Google ค้นหา

ราคา

แผนอัตราการใช้ต่อ 1,000 คำขอสมาชิกรวมการให้เครดิตต่อช่วงเวลาเรียกเก็บเงิน
จ่ายตามการใช้งานUS$1.00ไม่มีค่าบริการรายเดือนเติมเครดิตเมื่อจำเป็น
MicroUS$0.80US$49.00 / เดือน1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม
StarterUS$0.65US$199.00 / เดือน4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม
ProUS$0.60US$499.00 / เดือน10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม
ScaleUS$0.50US$999.00 / เดือน20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม
BusinessUS$0.40US$1,999.00 / เดือน40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม

หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ

ราคาและแผนจํากัดในปัจจุบัน