> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# البحث في الأخبار

> اعثر على الأخبار المتعلقة بالشركات حسب الفئة والدولة واللغة والتاريخ، مع ربط كل مقال بالشركات التي يذكرها — واختياريًا بإشارات التوسع التي أنتجها.

يُعيد [البحث في الأخبار](/ar/api-reference/endpoint/companies/news_search) مقالات إخبارية صنّفها Pubrio، صفًا واحدًا لكل مقال. يرتبط كل صف بـ**كل** شركة يذكرها المقال، ويحمل اسم فئة قياسيًا (`acquires`، `partners_with`، `receives_financing`، …)، وعند الطلب، إشارات التوسع التي أنتجها المقال.

```bash theme={null}
curl -X POST https://api.pubrio.com/companies/news/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["stripe.com"],
    "categories": ["partners_with", "launches"],
    "published_dates": ["2026-08-01", "2026-09-04"],
    "per_page": 25
  }'
```

## متى تستخدمه

* **معلومات استخباراتية عن الحساب** — ما الذي حدث لشركة ما هذا الشهر، مصنّفًا.
* **التنقيب القائم على المحفزات** — كل شركة أعلنت عن تمويل أو استحواذ في دولة ولغة تبيع فيهما.
* **دليل الإشارة** — مع `is_expansion_signal_available: true`، اطّلع على المقالات التي أنتجت [إشارات التوسع](/ar/knowledge-base/concepts/expansion-signals).

للحصول على الأعداد والتقسيمات حسب الفئة استخدم [رؤى الأخبار](/ar/api-reference/endpoint/companies/news_insights). ولتلقّي إشعار عند وصول المقالات، أنشئ Monitor بضبط `signal_types: ["news"]`.

## التحديد بشركة

| المفتاح         | القيمة                                        | ملاحظات                                                          |
| --------------- | --------------------------------------------- | ---------------------------------------------------------------- |
| `domains`       | `["stripe.com"]`                              | يطابق المقالات التي تذكر الشركة، وليس فقط المقالات التي تتناولها |
| `linkedin_urls` | `["https://www.linkedin.com/company/stripe"]` | صفحات الشركات فقط                                                |
| `companies`     | `["5378845d-…"]`                              | قيم `domain_search_id`                                           |

يعمل البحث دون تحديد شركة — `{"categories": ["acquires"], "locations": ["SG"]}` — ويُعيد الفهرس بأكمله لتلك الفئة، الأحدث أولًا.

## المرشحات

### الفئة والمعرض

| المفتاح            | النوع      | يطابق                                                                                              |
| ------------------ | ---------- | -------------------------------------------------------------------------------------------------- |
| `categories`       | `string[]` | أسماء الفئات القياسية من [فئات الأخبار](/ar/api-reference/endpoint/news/categories). أي اسم مذكور. |
| `news_galleries`   | `string[]` | أسماء المعارض القياسية من [معارض الأخبار](/ar/api-reference/endpoint/news/galleries).              |
| `news_gallery_ids` | `uuid[]`   | نفس المعارض بمعرّفاتها.                                                                            |
| `news_languages`   | `string[]` | رموز ISO 639-1 من [لغات الأخبار](/ar/api-reference/endpoint/news/languages).                       |

### النص

| المفتاح        | النوع      | يطابق                                        |
| -------------- | ---------- | -------------------------------------------- |
| `search_term`  | `string`   | نص حر مقابل العنوان والملخص، بأي لغة مدعومة. |
| `search_terms` | `string[]` | عدة عبارات، تطابق أي منها.                   |

### التواريخ

| المفتاح           | النوع                  | يطابق                                                                    |
| ----------------- | ---------------------- | ------------------------------------------------------------------------ |
| `published_dates` | `[from, to]`           | نافذة تاريخ النشر، شاملة للطرفين. تتبع حدود اليوم توقيت منطقة عمل حسابك. |
| `published_at`    | تاريخ أو طابع زمني ISO | نُشر عند هذه اللحظة أو بعدها، بالمقارنة بتوقيت UTC.                      |

### الموقع

| المفتاح             | النوع      | يطابق                                                     |
| ------------------- | ---------- | --------------------------------------------------------- |
| `locations`         | `string[]` | الدول التي **يتناولها** المقال (`country_codes` في الصف). |
| `company_locations` | `string[]` | دولة مقر شركة مذكورة.                                     |

### إشارات التوسع

| المفتاح                         | النوع      | يطابق                                                                                |
| ------------------------------- | ---------- | ------------------------------------------------------------------------------------ |
| `is_expansion_signal_available` | `boolean`  | أضِف `expansion_signals` إلى كل صف وفعّل المرشحين أدناه. اتركه معطّلًا لأسرع بحث.    |
| `expansion_signal_types`        | `string[]` | `HIRE`، `PARTNER`، `PRODUCT`، `SCALE`، … يتطلب العلَم أعلاه.                         |
| `expansion_signal_polarities`   | `string[]` | `expansion`، `contraction_leading`، `contraction_confirming`، `contraction_lagging`. |

### التصفح والترتيب

| المفتاح              | الافتراضي | ملاحظات                                                                                                                |
| -------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------- |
| `per_page` / `page`  | 25 / 1    | محدود حسب الخطة؛ انظر `total_display_pages`.                                                                           |
| `is_ascending_order` | `false`   | تُرتَّب الصفوف حسب `published_at`، الأحدث أولًا، والمقالات غير المؤرَّخة أخيرًا. تقلب `true` الترتيب إلى الأقدم أولًا. |

## شكل الصف

```json theme={null}
{
  "news_id": "76886b56-3418-476a-a531-fff18deb29db",
  "news_search_id": "4d950aea-e2bb-4367-869b-c34e834a82ec",
  "title": "PayPal Rejects Takeover, Rated Buy",
  "summary": "…",
  "url": "https://seekingalpha.com/article/4942660-…",
  "source": "seekingalpha.com",
  "image_url": "https://static.seekingalpha.com/…",
  "language": "en",
  "published_at": "2026-09-03T08:54:21.000000Z",
  "last_modified": "2026-09-03T09:20:55.189Z",
  "category": "receives_financing",
  "news_category_name": "Funding Announcements",
  "news_galleries": [{ "news_gallery_id": "342f2eb1-…", "slug": "general-business", "name": "General Business" }],
  "country_codes": null,
  "company_country_codes": ["US"],
  "locations": null,
  "domains": ["paypal.com", "stripe.com"],
  "companies": [
    { "domain_search_id": "5378845d-…", "company_name": "Stripe", "domain": "stripe.com", "country_code": "US", "…": "…" },
    { "domain_search_id": "b03b312a-…", "company_name": "PayPal", "domain": "paypal.com", "country_code": "US", "…": "…" }
  ]
}
```

* `companies` و`domains` مصفوفتان متوازيتان وتسردان **كل** شركة مذكورة، لذا قد يُعيد بحث محدَّد بـ`stripe.com` مقالًا موضوعه الرئيسي PayPal. صفِّ على `domains` من جهة العميل إن احتجت مقالات تكون فيها شركتك هي الموضوع.
* `country_codes` يمثّل ما يتناوله المقال؛ أما `company_country_codes` فهو مقر الشركات المذكورة. يصفّي `locations` الأول.
* `news_category_name` مُترجَم بحسب `language` في الطلب؛ أما `category` فهو الاسم القياسي الثابت.
* مع `is_expansion_signal_available: true` يكتسب كل صف `expansion_signals: [{ signal_type_slug, signal_strength_slug, polarity, country_code, domain_search_id, event_date }]`.

### `metadata.ignored_fields`

يُحذف أي مفتاح في جسم الطلب لا تتعرّف عليه النقطة الطرفية ويُسرد هنا. تُعيد `"categorys"` الفهرس بأكمله مع `ignored_fields: ["categorys"]`، وليس خطأً.

## وصفات جاهزة

<Tabs>
  <Tab title="أخبار تمويل باللغة اليابانية">
    ```bash cURL theme={null}
    curl -X POST https://api.pubrio.com/companies/news/search \
      -H "pubrio-api-key: $PUBRIO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "categories": ["receives_financing"],
        "news_languages": ["ja"],
        "published_dates": ["2026-08-01", "2026-09-04"],
        "per_page": 25
      }'
    ```
  </Tab>

  <Tab title="دليل توسع لحساب واحد">
    ```bash cURL theme={null}
    curl -X POST https://api.pubrio.com/companies/news/search \
      -H "pubrio-api-key: $PUBRIO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "domains": ["stripe.com"],
        "is_expansion_signal_available": true,
        "expansion_signal_types": ["HIRE", "PARTNER", "PRODUCT", "OFFICE"],
        "expansion_signal_polarities": ["expansion"],
        "per_page": 25
      }'
    ```

    يشرح كل صف الآن إشارة كنت لتراها لولا ذلك فقط كمرحلة في [تفاصيل توسع الشركة](/ar/api-reference/endpoint/expansions/company_lookup).
  </Tab>

  <Tab title="ملخص يومي">
    ```python Python theme={null}
    import os, requests
    from datetime import datetime, timedelta, timezone

    since = (datetime.now(timezone.utc) - timedelta(days=1)).strftime("%Y-%m-%dT%H:%M:%SZ")
    body = requests.post(
        "https://api.pubrio.com/companies/news/search",
        headers={"pubrio-api-key": os.environ["PUBRIO_API_KEY"]},
        json={"domains": ["stripe.com", "adyen.com"], "published_at": since, "per_page": 25},
    ).json()

    for a in body["data"]["news"]:
        subjects = ", ".join(c["company_name"] for c in a["companies"])
        print(f'[{a["category"]}] {a["title"]} — {subjects}')
    ```

    تتم مقارنة `published_at` بتوقيت UTC، لذا فإن طابعًا زمنيًا متحركًا على مدى 24 ساعة أكثر أمانًا من تاريخ تقويمي ثابت.
  </Tab>
</Tabs>

## صفحات ذات صلة

<CardGroup cols={2}>
  <Card title="مرجع البحث في الأخبار" icon="code" href="/ar/api-reference/endpoint/companies/news_search">
    كل معامل وحقل استجابة.
  </Card>

  <Card title="رؤى الأخبار" icon="chart-column" href="/ar/api-reference/endpoint/companies/news_insights">
    الذِكر، المواضيع، والمصادر لشركة واحدة عبر فترة زمنية.
  </Card>

  <Card title="فئات الأخبار" icon="tags" href="/ar/api-reference/endpoint/news/categories">
    أسماء الفئات القياسية التي يمكنك التصفية عليها.
  </Card>

  <Card title="إشارات التوسع" icon="globe" href="/ar/knowledge-base/concepts/expansion-signals">
    معنى نوع الإشارة وقطبيتها.
  </Card>
</CardGroup>