# FlashData Google News API

استرجع مقالات Google News مع العناوين والجهات الناشرة والروابط وتواريخ النشر. رشّح حسب البلد واللغة والنطاق الزمني.

مرجع كانوني: https://flashdata.dev/ar/docs/sources/google_news
جرى استعراضها: 2026-10-23

نقطة النهاية: POST https://data.flashdata.dev/v1/queries/realtime
المصادقة: X-API-Key: YOUR_API_KEY
Modes: [Realtime](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ar/docs/reference/batch-and-bulk/reference.md#batch)

إذن المصدر المطلوب: google_news

يستعاض عن YOUR_API_KEY بمفتاح API الذي يملك هذا المصدر من الأذن والائتمانات المتاحة. أجري طلبات على خادمك أو وكيل مضيف.

[إقامة المصادقة](https://flashdata.dev/ar/docs/guides/headers-and-authentication/reference.md)

[اختر وتنقيح بحث Google](https://flashdata.dev/ar/docs/guides/google-search-guide/reference.md)

<a id="quickstart"></a>

## أرسل طلبًا

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_news",
    "query": "renewable energy",
    "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},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "google_news",
  "query": "renewable energy",
  "params": {
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## البارامترات

<a id="parameters-group-0"></a>

### نص الطلب

| البارامترات | النوع | مطلوب | الافتراضي | الوصف |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | نعم | — | جاهزون إلى google_news.  |
| <a id="parameter-query"></a> query | string | نعم | غير محدد | باحث. يدعم مشغلي البحث في موقع Google مثل الموقع: وترجمة: صغر المدة: 1. أقصى مدة: 2000. |
| <a id="parameter-params"></a> params | object | لا | {} | Settings for this request.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | لا | غير محدد | لـ async وbatch فقط. رابط HTTPS عام للإشعار بالاكتمال على المنفذ 443، بطول يصل إلى 2,048 حرفًا، دون بيانات اعتماد مستخدم أو جزء رابط. احذف القيمة أو استخدم null أو سلسلة فارغة لعدم إرسال إشعار. في batch، ضعه في كل استعلام خارج params.  |

<a id="parameters-group-1"></a>

### البلد، اللغة، الموقع

| البارامترات | النوع | مطلوب | الافتراضي | الوصف |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | لا | غير محدد | رمز قطري من حرفين، مثلنا، جب، دي أو غرق. حدد صراحة لاختيار بلد ما. صغر المدة: 2. أقصى مدة: 2. Pattern: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | لا | غير محدد | لغة الوصل بينية من طراز Google. جهزوا صراحة لاختيار لغة. صغر المدة: 1. أقصى مدة: 35. Pattern: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | لا | غير محدد | طلب موقع بحث، ويفضل أن تكون مدينة، مثل "London, England, United Kingdom". التوافر يعتمد على نوع البحث صغر المدة: 1. أقصى مدة: 200. |

<a id="parameters-group-2"></a>

### الهجرات

| البارامترات | النوع | مطلوب | الافتراضي | الوصف |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | لا | غير محدد | عدد النتائج المطلوب. لا تضيف FlashData قيمة افتراضية ثابتة عند حذفه. قد يختلف العدد العائد حسب الاستعلام ونوع البحث. الحد الأدنى: 1. الحد الأقصى: 100. |
| <a id="parameter-params-page"></a> params.page | integer | لا | غير محدد | صفحة النتائج المطلوبة جهز بشكل صريح. وكل صفحة هي طلب منفصل من شركة API. الحد الأدنى: 1. الحد الأقصى: 100. |

<a id="parameters-group-3"></a>

### تصفية البحث

| البارامترات | النوع | مطلوب | الافتراضي | الوصف |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | لا | غير محدد | طلب مرشحات بحث من طراز Google، مثل qdr:d لليوم الماضي أو qdr:w للأسبوع الماضي. التوافر يعتمد على نوع البحث صغر المدة: 1. أقصى مدة: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | لا | غير محدد | طلب تصحيح التهجئة مع شركة true أو طلب إعاقتها مع شركة false. ويتوقف السلوك التطبيقي على نوع البحث؛ ويغفل استخدامه Googleسلوك  |

<a id="response"></a>

## اقرأ النتيجة

وفّر ردّ شركة JSON الناجح على أنها response.json. احفظ هذا read-response.py و اركضوا بيثون read-response.py. إنها تستخدم فقط Pythonمكتبة عادية ولا تقدم طلباً جديداً

### 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"), "publisher": item.get("source"), "date": item.get("date")}
    for item in result.get("news", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## مثال للاستجابة

مثال مسجل؛ فالميادين والعدوى تعتمد على المصدر وتطلب مدخلات.
```json
{
  "source": "google_news",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "renewable energy",
        "gl": "us",
        "hl": "en",
        "type": "news",
        "num": 10,
        "page": 1,
        "allowSuggested": true,
        "engine": "google"
      },
      "news": [
        {
          "title": "Molder and Hatcher discuss positions on renewable energy, nuclear power ahead of November election",
          "link": "https://tennesseelookout.com/2026/09/14/molder-and-hatcher-discuss-positions-on-renewable-energy-nuclear-power-ahead-of-november-election/",
          "snippet": "District 5 candidates Charlie Hatcher, a Republican farmer and former Tennessee agriculture commissioner, and Chaz Molder, the Democratic...",
          "date": "1 day ago",
          "source": "Tennessee Lookout",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSyHCzprpdTHLlK8zYoWi3-Xyuoj_YpfKHcxb3VhP2GPBH5xvFAhl0fRQA&usqp=CAI&s"
        },
        {
          "title": "Climate Collaborative: Heat pumps key to hitting renewable energy goal",
          "link": "https://www.steamboatpilot.com/news/climate-collaborative-heat-pumps-key-to-hitting-renewable-energy-goal/",
          "snippet": "The Routt County Climate Action Plan Collaborative hosted an open house on Sept. 9 to address various sectors in which it is trying to...",
          "date": "1 day ago",
          "source": "Steamboat Pilot",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRHF-XD_fkuYVqCDDwoZezjCneA7C5ysheQyzjqkRXdormLaLj5qR9jvQo&usqp=CAI&s"
        },
        {
          "title": "Iowa scientists push for more renewable energy to meet growing demands",
          "link": "https://iowacapitaldispatch.com/2026/09/15/iowa-scientists-push-for-more-renewable-energy-to-meet-growing-demands/",
          "snippet": "Iowa scientists have asked Iowans to advocate for the deployment of renewable energy systems to meet growing electricity demand.",
          "date": "12 hours ago",
          "source": "Iowa Capital Dispatch",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQZx80m4v67vKDZTGd1NZ-lTkt-5XQm9WUqp6Up0HShJaH3JuOEsItNjgU&usqp=CAI&s"
        },
        {
          "title": "Juniper Green Energy Commissions New Wind Farms Across India",
          "link": "https://www.powermag.com/juniper-green-energy-commissions-new-wind-farms-across-india/",
          "snippet": "Juniper Green Energy, an independent renewable energy power producer in India, said it has expanded its portfolio with a series of projects...",
          "date": "17 hours ago",
          "source": "POWER Magazine",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQLmOuMsiCedjJNR3jjzRAyDxBay7VUAHaG8UZObtGY9vgnOUayFpuwsrI&usqp=CAI&s"
        },
        {
          "title": "Cameco vs. USA Rare Earth: Which Renewable Energy Stock Is a Better Buy in 2026?",
          "link": "https://www.fool.com/coverage/better-buy/2026/09/15/cameco-vs-usa-rare-earth-which-renewable-energy-stock-is-a-better-buy-in-2026/",
          "snippet": "Cameco generates $775M in free cash flow with a 17% net margin, while USA Rare Earth burns cash as it scales. The valuation gap tells a...",
          "date": "9 hours ago",
          "source": "The Motley Fool",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYBudJa-unYwDH3DCNtPpTMwB1cdsXPWHjYQW2joDghld74kpOZduLcZA&usqp=CAI&s"
        },
        {
          "title": "China may have a green energy overcapacity problem. Experts think AI can help solve it",
          "link": "https://fortune.com/2026/09/15/china-green-energy-ai/",
          "snippet": "Production in China's clean energy sector has grown so much that there's more energy infrastructure than the market needs.",
          "date": "1 day ago",
          "source": "Fortune",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRW6eTu-3FM7KsoZ5q9f82RxxhcWMa29Tt6Dt8ou4p34tRp2slTyR8T5Ac&usqp=CAI&s"
        },
        {
          "title": "The Energy Transition Is Here: Why Renewable Energy Is One of the Most Compelling Investment Opportunities of Our Time",
          "link": "https://www.morningstar.com/news/accesswire/1220508msn/the-energy-transition-is-here-why-renewable-energy-is-one-of-the-most-compelling-investment-opportunities-of-our-time",
          "snippet": "by Kristin Hull, CEO of Nia Impact Capital. NORTHAMPTON, MA / ACCESS Newswire / September 14, 2026 / There is a moment in every major...",
          "date": "1 day ago",
          "source": "Morningstar",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcROeSoUWZNvlGbcsMzYS5NQsEAXL3zePMGFzIuGwy7NHECmjznDKjdobP0&usqp=CAI&s"
        },
        {
          "title": "India's data center boom creates new engine for renewable energy",
          "link": "https://asia.nikkei.com/business/energy/india-s-data-center-boom-creates-new-engine-for-renewable-energy",
          "snippet": "BENGALURU -- India's push to become a major hub for artificial intelligence is creating a massive opportunity for the country's renewable...",
          "date": "2 days ago",
          "source": "Nikkei Asia",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTtvz9DfrdplKh5Td53Yq079nZkvZFB7xCxLHKhhdnPQtWkUS4KuR3JeQg&usqp=CAI&s"
        },
        {
          "title": "2026 Iowa climate statement calls for renewable energy generation",
          "link": "https://cbs2iowa.com/news/local/gallery/2026-iowa-climate-statement-calls-for-renewable-energy-generation",
          "snippet": "KGAN CBS 2 and KFXA Fox 28 provide local news, weather forecasts, notices of events and items of interest in the community, sports and entertainment...",
          "date": "8 hours ago",
          "source": "KGAN",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTnew7UX8YHNNaVBJcRcH-xbPitO4Z04Q0_5dbp6QvGdkwa42lst11tVEtV&usqp=CAI&s"
        },
        {
          "title": "Energy supply concerns push Europe, Asia toward renewable energy",
          "link": "https://www.dailysabah.com/business/energy/energy-supply-concerns-push-europe-asia-toward-renewable-energy",
          "snippet": "The supply and price shock following the start of the U.S.-Iran war has reshaped energy security policies in Europe and Asia, increasing the...",
          "date": "2 days ago",
          "source": "Daily Sabah",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSULmlmX1DQpYr8tnbQvQO353x2S5Gsyr2YQyK9GHIGXNT9PG_5KeA_04U&usqp=CAI&s"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:38:04.737Z"
}
```

## حقول الاستجابة

| الميدان | النوع | الوصف |
| --- | --- | --- |
| source | string | المصدر المطلوب من شركة API. |
| status | string | تم عندما يتكلل الطلب بالنجاح. |
| created_at | string | وقت إنشاء الاستجابة في شكل ISO 8601. |
| usage.credits | number | إئتمانات مُقيدة على الطلب، بناءً على خطتك. |
| results[0].searchParameters | object | (ج) حالات البحث التي أبلغت عنها شركة Google، مع تسجيل الاستفسارات على أنها q. وقد تختلف البيئات العائدة عن القيم المطلوبة. |
| results[0].news | array | نتائج البحث عن الأخبار |
| results[0].news[].title | string | عنوان المادة. |
| results[0].news[].link | string | Article URL. |
| results[0].news[].snippet | string · optional | المادة مقتطفة |
| results[0].news[].source | string · optional | اسم النشر |
| results[0].news[].date | string · optional | (ب) تاريخ النشر الذي أعادته شركة Google؛ وقد يكون نسبياً. |
| results[0].news[].imageUrl | string · optional | المادة الإبهام |
| results[0].news[].position | integer · optional | -الوضع الرجعي، عند إدراجه . |

- وتعتمد المجالات المتاحة على نوع الاستفسار والبحث. وقد تكون الحقول الاختيارية غائبة، ويمكن إعادة حقول إضافية.
- ويمكن أن يختلف عدد الأصناف المعادة والزكية الزكية (searchParameters.num) عن params.num. استخدموا المجموعة المعادية لتحديد عدد النتائج الفعلي.

## تنسيقات الاستجابة

وتستخدم الردود JSON حسب التقصير. اختر شكلاً آخر مع هؤلاء المرشدين الاختياريين

- Accept: application/json (التقصير) أو text/plain. ويعرض النص الشاذ نفس الحقول في مخطط قابل للقراءة ومستقطب.
- X-Respond-With: markdown. إتركوا الحقول الأصلية وتعمل شركة Markdown بأي من شكلي الاستجابة.

يتوفر Markdown للاستعلامات الفورية والنتائج المكتملة.

وتصف المجالات الواردة أدناه رد شركة JSON.

[أمثلة صيغ الطلب والاستجابة](https://flashdata.dev/ar/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## أساسيات API

يستخدم منشئ الطلبات والأمثلة أعلاه معاملات هذا المصدر. استخدم أمثلة Python وcURL أدناه لخطوات الإرسال والحالة والنتائج المشتركة. جسم Batch هو كائن JSON يحتوي queries؛ ويعيد كل عنصر معرّف مهمة خاصًا به.

- [Async Request and receipt](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [التحقق من حالة العمل](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [استرجاع النتائج المنجزة](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON](https://flashdata.dev/ar/docs/reference/batch-and-bulk/reference.md#batch)
- [العملاء المفتوحون](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## الإخطارات المتعلقة بالإنجاز

- [استلام وثائق الإنجاز على شبكة الإنترنت والتحقق منها](https://flashdata.dev/ar/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## اضطرابات

- [الأخطاء ورموز الحالة](https://flashdata.dev/ar/docs/errors/reference.md#status-codes)
- [متى يُعيدُ النظر](https://flashdata.dev/ar/docs/errors/reference.md#retries)

## APIs ذات الصلة

- [Google Search API](https://flashdata.dev/ar/docs/sources/google_search/reference.md)
- [Google Videos API](https://flashdata.dev/ar/docs/sources/google_videos/reference.md)
