Skip to main content
POST
البحث في أخبار الشركات

التفويضات

pubrio-api-key
string
header
مطلوب

رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات والعمليات المقابلة. يمكنك إنشاءه عبر قسم Settings.

الجسم

application/json
locations
string[]

الدول التي يتناولها الخبر نفسه، مستخرجة من نص المقال (ISO 3166-1 alpha-2). تكون فارغة إذا لم يذكر المقال أي مكان. للبحث حسب دولة المقر الرئيسي لشركة مذكورة، استخدم company_locations.

مثال:
company_locations
string[]

دولة المقر الرئيسي للشركات المذكورة في المقال (ISO 3166-1 alpha-2)، وليست مكان وقوع الحدث؛ لذلك استخدم locations.

مثال:
companies
string<uuid>[]

قائمة من معرّفات فريدة (domain_search_id) تُستخدَم لعمليات البحث عن شركات وأشخاص.

news_search_id
string<uuid>

أعِد هذا السجل الواحد فقط. مفيد لإعادة جلب صف خزّنته سابقًا دون ترقيم صفحات.

مثال:

"4110b929-17cd-42aa-a159-906ead0c9b56"

domains
string[]

قائمة نطاقات شركات تُستخدَم لعمليات البحث عن شركات وأشخاص. إن استلمنا رابطًا مثل www.pubrio.com أو https://docs.pubrio.com/، سيحوّله النظام إلى pubrio.com للمعالجة.

مثال:
linkedin_urls
string[]

الرابط الكامل لملف شركة على LinkedIn. يبدأ الرابط بـhttp ويحتوي linkedin.com/company/

مثال:
search_term
string

سلسلة من الكلمات نريد تصفية النتائج بها.

مثال:

"pubrio"

search_terms
string[]

مصفوفة من كلمات مفتاحية لتصفية المقالات الإخبارية. تُطابَق كل عبارة مقابل محتوى المقال. استخدم search_term لعبارة واحدة أو search_terms لعدة كلمات مفتاحية.

مثال:
exclude_search_terms
string[]

استبعاد المقالات التي تذكر أيًا من هذه الكلمات، بنفس طريقة مطابقة search_terms. يُقبل أيضًا الاسم exclude_keywords.

مثال:
sources
string[]

المقالات الصادرة عن هؤلاء الناشرين فقط. استخدم نطاق الناشر، مثل bbc.co.uk، وهي القيمة نفسها الموجودة في الحقل source لكل مقال. يمكن أيضًا استخدام عنوان URL كامل أو عنوان يبدأ بـ www..

مثال:
exclude_sources
string[]

استبعاد المقالات الصادرة عن هؤلاء الناشرين. التنسيق مثل sources. تبقى المقالات التي لا يُعرف ناشرها.

مثال:
categories
string[]

قائمة من category slugs للبحث عن فئات أخبار محددة. لإيجاد اسم قياسي، استدعِ نقطة news categories تحت تبويب Filters.

مثال:

قائمة من news_gallery_id تُستخدَم للبحث عن معارض أخبار محددة. لإيجاد المعرّف، استدعِ نقطة news galleries تحت تبويب Filters.

published_dates
string[]

نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك.

مثال:
published_at
string<date-time>

نُشر عند هذه اللحظة أو بعدها (UTC). تاريخ أو طابع زمني ISO. published_dates هي الصيغة المغلقة النطاق وتستخدم توقيت منطقة عمل حسابك.

مثال:

"2026-09-01T00:00:00Z"

per_page
integer
افتراضي:25

السجلات لكل صفحة. القيمة الافتراضية 25، وهي أيضًا السقف في معظم الخطط — الحد هو max_search_per_page الخاص باشتراكك، الذي تُعيده Profile. تجاوزه يُعيد HTTP 416 برمز 41676 (أو 41613 في بحث الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة.

النطاق المطلوب: x <= 25
مثال:

25

page
integer
افتراضي:1

رقم الصفحة، بدءًا من 1. السقف هو max_search_page الخاص باشتراكك (max_company_search_page لبحث الشركات)، الذي تُعيده Profile. تجاوزه يُعيد HTTP 416.

مثال:

1

is_ascending_order
boolean
افتراضي:false

اتجاه الترتيب. تُعاد النتائج بترتيب الأحدث أولًا افتراضيًا؛ اضبط true للأقدم أولًا. لا يوجد sort_by في هذه النقطة الطرفية — مفتاح الترتيب ثابت ومذكور في وصف النقطة الطرفية.

مثال:

false

news_galleries
string[]

قائمة من gallery slugs لتصفية الأخبار حسب المعرض. لإيجاد اسم قياسي، استدعِ نقطة news galleries تحت تبويب Filters.

مثال:
news_languages
string[]

قائمة من قيم locale_code لتصفية الأخبار حسب اللغة. لإيجاد الرموز المتاحة، استدعِ نقطة news languages تحت تبويب Filters.

مثال:
is_expansion_signal_available
boolean

عند true، يُلحِق إشارات التوسع المحلولة (expansion_signals) بكل عنصر إخباري ويفعّل مرشحي expansion_signal_types / expansion_signal_polarities. اتركه غير مضبوط لأسرع بحث — يُضاف ربط التوسع فقط عند تفعيل هذا العلَم.

expansion_signal_types
enum<string>[]

أعِد فقط الأخبار التي أنتجت إشارة توسع من أحد هذه الأنواع (أسماء قياسية بأحرف كبيرة). يتطلب is_expansion_signal_available: true. القائمة التي تحتوي فقط على أسماء قياسية غير معروفة لا تطابق شيئًا.

الخيارات المتاحة:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
مثال:
expansion_signal_polarities
enum<string>[]

أعِد فقط الأخبار التي تحمل إشارة توسعها إحدى هذه القطبيات. يتطلب is_expansion_signal_available: true. يُجمَع مع expansion_signal_types بعامل AND.

الخيارات المتاحة:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
مثال:

الاستجابة

استجابة ناجحة تحتوي على تفاصيل البحث في أخبار الشركات.

metadata
object

سياق الطلب.

data
object
آخر تعديل في ٤ سبتمبر ٢٠٢٦