Підготувати навколишнє середовище
Ви будете використовувати Python 3 і його стандартну бібліотеку. Створіть API ключ і переконайтеся, що ваш обліковий запис має доступні кредити. Якщо це ваш перший запит, див. API швидкийстарт.
# Replace YOUR_API_KEY near the top of the code below.Сцена нижче пошуків openai Використовуючи результати США та англійський інтерфейс, потім напишіть повернуті органічні посилання на файл CSV.
Захоплення та збереження результатів пошуку
Заощаджуйте скрипт як search.py. Подає одноразовий запит source: "google_search" і читати organic масив з першого результату.
import csv
import json
import os
import urllib.request
base_url = "https://data.flashdata.dev"
api_key = "YOUR_API_KEY"
request = urllib.request.Request(
base_url + "/v1/queries/realtime",
data=json.dumps({
"source": "google_search",
"query": "openai",
"params": {"gl": "us", "hl": "en", "num": 10},
}).encode("utf-8"),
headers={
"X-API-Key": api_key,
"Content-Type": "application/json",
},
method="POST",
)
with urllib.request.urlopen(request, timeout=60) as response:
payload = json.load(response)
if payload.get("status") != "done":
raise RuntimeError(payload.get("message", "Search did not complete"))
results = payload["results"][0].get("organic", [])
with open("google-results.csv", "w", newline="", encoding="utf-8") as output:
writer = csv.DictWriter(output, fieldnames=["position", "title", "url", "snippet"])
writer.writeheader()
for result in results:
writer.writerow({
"position": result.get("position", ""),
"title": result.get("title", ""),
"url": result.get("link", ""),
"snippet": result.get("snippet", ""),
})
print(f"Saved {len(results)} results to google-results.csv")
python3 search.pyВідкрито google-results.csv в таблиці або навантажте його в додаток. Експортовані стовпці позиціонують, заголовок, URL і snippet. Python CSV письменниця ручить котирування для комами та розривами рядків у тексті результату.
Підтримати відповідь API
Ця записна відповідь показує структуру, що повертається для пошуку OpenAI. Скрипт експортує органічні посилання; інші доступні розділи залишаються в відповіді API, якщо їх потребує програма.
{
"source": "google_search",
"status": "done",
"results": [
{
"searchParameters": {
"q": "openai",
"gl": "us",
"hl": "en",
"type": "search",
"num": 10,
"page": 1,
"engine": "google"
},
"organic": [
{
"title": "OpenAI | Research & Deployment",
"link": "https://openai.com/",
"snippet": "We believe our research will eventually lead to artificial general intelligence, a system that can solve human-level problems.",
"position": 1
},
{
"title": "OpenAI",
"link": "https://en.wikipedia.org/wiki/OpenAI",
"snippet": "OpenAI is an American artificial intelligence (AI) public benefit corporation (PBC) headquartered in San Francisco. It develops proprietary generative AI models ...",
"position": 2
},
{
"title": "OpenAI",
"link": "https://x.com/OpenAI",
"snippet": "OpenAI's mission is to ensure that artificial general intelligence benefits all of humanity. can develop research, build financial models, and create ...",
"position": 3
},
{
"title": "OpenAI",
"link": "https://www.linkedin.com/company/openai",
"snippet": "OpenAI is an AI research and deployment company dedicated to ensuring that general-purpose artificial intelligence benefits all of humanity.",
"position": 4
},
{
"title": "r/OpenAI",
"link": "https://www.reddit.com/r/OpenAI/",
"snippet": "OpenAI is an AI research and deployment company. OpenAI's mission is to create safe and powerful AI that benefits all of humanity. OpenAI's ...",
"position": 5
}
],
"peopleAlsoAsk": [
{
"question": "Is OpenAI created by Elon Musk?"
},
{
"question": "Why are people leaving ChatGPT?"
},
{
"question": "Is OpenAI the same as ChatGPT?"
},
{
"question": "Why is OpenAI in trouble?"
}
],
"relatedSearches": [
{
"query": "OpenAI login"
},
{
"query": "OpenAI chat"
},
{
"query": "OpenAI ChatGPT"
},
{
"query": "OpenAI - wikipedia"
},
{
"query": "OpenAI API"
},
{
"query": "OpenAI app"
},
{
"query": "OpenAI download"
},
{
"query": "OpenAI video"
}
]
}
],
"usage": {
"credits": 0.02
},
"created_at": "2026-09-16T07:41:40.043Z"
}Про нас num параметр запитує кількість результатів. Це не гарантує, що Google повернеться до багатьох органічних посилань. Скрипт зберігає всі результати.
Зміна пошуку
Зменшення query для вашої теми, params.gl для країни і params.hl для мови інтерфейсу. Зареєструватися params.page за запитом іншої сторінки; кожна сторінка є окремим викликом API.
Для порівняння результатів за часом зберігайте біржу, область та час збору разом з кожним рядом. API повертає знімок пошуку; історичні порівняння надходять від знімків, які ви економите.