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

التفويضات

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

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

الجسم

application/json
locations
string[]

يُستخدَم ISO 3166-1 alpha-2 (cca2) لتصفية المواقع. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
company_locations
string[]

موقع مقر الشركة. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
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 لعدة كلمات مفتاحية.

مثال:
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
آخر تعديل في ٤ سبتمبر ٢٠٢٦