البحث في الأخبار - Pubrio Documentation

يُعيد البحث في الأخبار مقالات إخبارية صنّفها Pubrio، صفًا واحدًا لكل مقال. يرتبط كل صف بـكل شركة يذكرها المقال، ويحمل اسم فئة قياسيًا (acquires، partners_with، receives_financing، …)، وعند الطلب، إشارات التوسع التي أنتجها المقال.

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، اطّلع على المقالات التي أنتجت إشارات التوسع.

للحصول على الأعداد والتقسيمات حسب الفئة استخدم رؤى الأخبار. ولتلقّي إشعار عند وصول المقالات، أنشئ 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[]`	أسماء الفئات القياسية من فئات الأخبار. أي اسم مذكور.
`news_galleries`	`string[]`	أسماء المعارض القياسية من معارض الأخبار.
`news_gallery_ids`	`uuid[]`	نفس المعارض بمعرّفاتها.
`news_languages`	`string[]`	رموز ISO 639-1 من لغات الأخبار.

النص

المفتاح	النوع	يطابق
`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` الترتيب إلى الأقدم أولًا.

شكل الصف

{
  "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"]، وليس خطأً.

وصفات جاهزة

أخبار تمويل باللغة اليابانية
دليل توسع لحساب واحد
ملخص يومي

cURL

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
  }'

cURL

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
  }'

يشرح كل صف الآن إشارة كنت لتراها لولا ذلك فقط كمرحلة في تفاصيل توسع الشركة.

Python

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 ساعة أكثر أمانًا من تاريخ تقويمي ثابت.

صفحات ذات صلة

مرجع البحث في الأخبار

كل معامل وحقل استجابة.

رؤى الأخبار

الذِكر، المواضيع، والمصادر لشركة واحدة عبر فترة زمنية.

فئات الأخبار

أسماء الفئات القياسية التي يمكنك التصفية عليها.

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

معنى نوع الإشارة وقطبيتها.

​متى تستخدمه

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

​المرشحات

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

​النص

​التواريخ

​الموقع

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

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

​شكل الصف

​metadata.ignored_fields

​وصفات جاهزة

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

مرجع البحث في الأخبار

رؤى الأخبار

فئات الأخبار

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

متى تستخدمه

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

المرشحات

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

النص

التواريخ

الموقع

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

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

شكل الصف

`metadata.ignored_fields`

وصفات جاهزة

صفحات ذات صلة