Подготовьте свою окружающую среду
Вы будете использовать 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 и фрагмент. Автор 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"
}The num параметр требует подсчета результата. Это не гарантирует, что Google вернет столько органических ссылок. Сценарий сохраняет, однако многие результаты возвращаются.
Изменить поиск
Изменения query Для вашей темы, params.gl Для страны и params.hl Для языка интерфейса. Использовать params.page запросить другую страницу; каждая страница представляет собой отдельный вызов API.
Чтобы сравнить результаты с течением времени, храните запрос, регион и время сбора вместе с каждой строкой. API возвращает снимок поиска; исторические сравнения исходят из сохраненных вами снимков.