> ## 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/developer-guides/search/news-search). ## OpenAPI ````yaml ar-openapi POST /companies/news/search openapi: 3.0.0 info: description: >- تقدّم واجهة Pubrio API معلومات استخباراتية عن توسع السوق — إشارات في الوقت الفعلي تُعلِم عندما تدخل شركة سوقًا جديدة — إلى جانب بيانات الشركات والأشخاص التي تستند إليها. ابحث، وتحقق، وأثرِ الحسابات وجهات التواصل، واشترك في إشارات تحرك مصنَّفة ومؤرَّخة عبر أكثر من 200 سوق. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ar/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ar/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: معلومات ملف مساحة العمل وإحصاءات الاستخدام - name: Enrichment description: إثراء سجلات الأشخاص والشركات ببيانات B2B مفصّلة - name: Lookalike description: إيجاد شركات مشابهة لشركة معينة - name: Search description: البحث عن أشخاص وشركات ووظائف وأخبار وإعلانات بمرشحات - name: Lookup description: البحث عن معلومات مفصّلة لأشخاص وشركات ووظائف وأخبار وإعلانات وتقنيات محددة - name: LinkedIn description: البحث عن بيانات أشخاص وشركات عبر روابط ملفات LinkedIn - name: Redeem description: استبدال أرصدة لفتح بيانات تواصل الأشخاص (فردي ودفعي) - name: Channels description: إدارة قوالب قنوات التواصل (إنشاء، تحديث، حذف، سرد) - name: Monitor description: إنشاء وإدارة Monitors للبيانات بواجهات webhook، وإحصاءات، ومعالجة - name: Filters description: >- استرجاع قيم المرشحات المتاحة لمعاملات البحث (التقنيات، المواقع، القطاعات، إلخ) - name: API Keys description: سرد وفحص سجلات طلبات API وتحليلات الاستخدام لمفاتيح API - name: Insights description: رؤى إشارات مجمَّعة للشركات (الوظائف، الأخبار، الإعلانات). - name: Export description: تصدير بيانات دفعي (مقيَّد بالأرصدة). - name: Expansion description: >- معلومات استخباراتية عن توسع الشركات في السوق: الإشارات، المراحل، الأسواق، والتصدير. externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /companies/news/search: post: tags: - Search summary: البحث في أخبار الشركات description: >- ابحث في الأخبار المتعلقة بالشركات. راجع [دليل البحث في الأخبار](/ar/developer-guides/search/news-search). operationId: companies_search_news parameters: [] requestBody: required: true content: application/json: schema: type: object properties: locations: $ref: '#/components/schemas/locations' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' news_search_id: allOf: - $ref: '#/components/schemas/news_search_id' description: >- أعِد هذا السجل الواحد فقط. مفيد لإعادة جلب صف خزّنته سابقًا دون ترقيم صفحات. domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' search_term: $ref: '#/components/schemas/search_term' search_terms: type: array items: type: string example: - Trump description: >- مصفوفة من كلمات مفتاحية لتصفية المقالات الإخبارية. تُطابَق كل عبارة مقابل محتوى المقال. استخدم `search_term` لعبارة واحدة أو `search_terms` لعدة كلمات مفتاحية. categories: $ref: '#/components/schemas/news_categories' news_gallery_ids: $ref: '#/components/schemas/news_gallery_ids' published_dates: $ref: '#/components/schemas/published_dates' published_at: $ref: '#/components/schemas/news_published_at_from' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' news_galleries: type: array items: type: string example: - electronic-commerce description: >- قائمة من `gallery slugs` لتصفية الأخبار حسب المعرض. لإيجاد اسم قياسي، استدعِ نقطة `news galleries` تحت تبويب Filters. news_languages: type: array items: type: string example: - en description: >- قائمة من قيم `locale_code` لتصفية الأخبار حسب اللغة. لإيجاد الرموز المتاحة، استدعِ نقطة `news languages` تحت تبويب Filters. is_expansion_signal_available: $ref: '#/components/schemas/is_expansion_signal_available' expansion_signal_types: $ref: '#/components/schemas/expansion_signal_types' expansion_signal_polarities: $ref: '#/components/schemas/expansion_signal_polarities' responses: '200': description: استجابة ناجحة تحتوي على تفاصيل البحث في أخبار الشركات. content: application/json: schema: type: object properties: metadata: $ref: '#/components/schemas/search_metadata' data: type: object properties: pagination: $ref: '#/components/schemas/search_pagination' news: type: array items: $ref: '#/components/schemas/news_search_result' example: metadata: profile: null filters: domains: - stripe.com per_page: 25 language: en ignored_fields: [] data: pagination: page: 1 per_page: 25 total_entries: 351800 total_pages: 14072 is_timeout: false total_display_pages: 250 news: - news_id: 0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd news_search_id: 4110b929-17cd-42aa-a159-906ead0c9b56 country_codes: - CN - SG company_country_codes: - CN - FR domains: - insead.edu - digitalchina.com companies: - logo_url: >- https://buckets.pubrio.com/company-logo/MjY5OTY5NDJpbnNlYWQuZWR1bGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: dfbe6797-5311-46f9-9518-bf1a7c3d09bc country_code: FR company_name: Insead linkedin_name: insead domain: insead.edu - logo_url: >- https://buckets.pubrio.com/company-logo/NDA2NTQ5NTFkaWdpdGFsY2hpbmEuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: e13a9e24-a07d-4630-9b47-fceb778df74e country_code: CN company_name: Digital China linkedin_name: digital-china domain: digitalchina.com news_galleries: - slug: banking-financial-service news_gallery_id: 7c8ec9cc-66c5-4153-82da-9c8f356c6c99 name: Banking/Financial Service locations: - Singapore - China last_modified: '2025-06-01T08:15:23.945Z' image_url: null url: http://enold.prnasia.com/p/asia-story-125304015-0.shtml published_at: '2025-06-01T08:00:00.000Z' language: id source: prnasia.com category: launches title: >- Digital China's AI-driven transformation showcased at INSEAD summary: >- Guo Wei, Chairman of Digital China, presented on AI-era corporate management at INSEAD 2025 Asia AI Conference, launching a case study on Digital China's AI transformation journey. news_category_name: Launches - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: locations: type: array items: type: string example: - US - SG - CN description: >- يُستخدَم ISO 3166-1 alpha-2 (cca2) لتصفية المواقع. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. company_locations: type: array items: type: string example: - US - SG - CN description: >- موقع مقر الشركة. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. companies: type: array items: type: string format: uuid description: >- قائمة من معرّفات فريدة (domain_search_id) تُستخدَم لعمليات البحث عن شركات وأشخاص. news_search_id: type: string format: uuid example: 4110b929-17cd-42aa-a159-906ead0c9b56 description: معرّف فريد لعملية البحث عن أخبار الشركة. domains: type: array items: type: string example: - pubrio.com description: >- قائمة نطاقات شركات تُستخدَم لعمليات البحث عن شركات وأشخاص. إن استلمنا رابطًا مثل `www.pubrio.com` أو `https://docs.pubrio.com/`، سيحوّله النظام إلى `pubrio.com` للمعالجة. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- الرابط الكامل لملف شركة على LinkedIn. يبدأ الرابط بـ`http` ويحتوي `linkedin.com/company/` search_term: type: string example: pubrio description: سلسلة من الكلمات نريد تصفية النتائج بها. news_categories: type: array items: type: string example: - launches description: >- قائمة من `category slugs` للبحث عن فئات أخبار محددة. لإيجاد اسم قياسي، استدعِ نقطة `news categories` تحت تبويب Filters. news_gallery_ids: type: array items: type: string format: uuid description: >- قائمة من `news_gallery_id` تُستخدَم للبحث عن معارض أخبار محددة. لإيجاد المعرّف، استدعِ نقطة `news galleries` تحت تبويب Filters. published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك. news_published_at_from: type: string format: date-time example: '2026-09-01T00:00:00Z' description: >- نُشر عند هذه اللحظة أو بعدها (UTC). تاريخ أو طابع زمني ISO. `published_dates` هي الصيغة المغلقة النطاق وتستخدم توقيت منطقة عمل حسابك. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- السجلات لكل صفحة. القيمة الافتراضية 25، وهي أيضًا السقف في معظم الخطط — الحد هو `max_search_per_page` الخاص باشتراكك، الذي تُعيده [Profile](/ar/api-reference/endpoint/profile/profile). تجاوزه يُعيد **HTTP 416** برمز `41676` (أو `41613` في بحث الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة. page: type: integer example: 1 default: 1 description: >- رقم الصفحة، بدءًا من 1. السقف هو `max_search_page` الخاص باشتراكك (`max_company_search_page` لبحث الشركات)، الذي تُعيده [Profile](/ar/api-reference/endpoint/profile/profile). تجاوزه يُعيد **HTTP 416**. is_ascending_order: type: boolean default: false example: false description: >- اتجاه الترتيب. تُعاد النتائج بترتيب الأحدث أولًا افتراضيًا؛ اضبط `true` للأقدم أولًا. لا يوجد `sort_by` في هذه النقطة الطرفية — مفتاح الترتيب ثابت ومذكور في وصف النقطة الطرفية. is_expansion_signal_available: type: boolean description: >- عند `true`، يُلحِق إشارات التوسع المحلولة (`expansion_signals`) بكل عنصر إخباري ويفعّل مرشحي `expansion_signal_types` / `expansion_signal_polarities`. اتركه غير مضبوط لأسرع بحث — يُضاف ربط التوسع فقط عند تفعيل هذا العلَم. expansion_signal_types: type: array items: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: - HIRE - PARTNER description: >- أعِد فقط الأخبار التي أنتجت إشارة توسع من أحد هذه الأنواع (أسماء قياسية بأحرف كبيرة). يتطلب `is_expansion_signal_available: true`. تُتجاهَل الأسماء القياسية غير المعروفة. expansion_signal_polarities: type: array items: type: string enum: - expansion - contraction_leading - contraction_confirming - contraction_lagging example: - expansion description: >- أعِد فقط الأخبار التي تحمل إشارة توسعها إحدى هذه القطبيات. يتطلب `is_expansion_signal_available: true`. يُجمَع مع `expansion_signal_types` بعامل AND. search_metadata: type: object description: سياق الطلب. properties: profile: type: object nullable: true description: >- كتلة الأرصدة (`credit`، `topup_credit`، `total_credit_cost`) عند طلب محاسبة الأرصدة؛ `null` في حركة مرور مفتاح API العادية. filters: type: object description: >- عرض لجسم الطلب كما طبّقته النقطة الطرفية، بما يشمل قيمًا افتراضية مثل `per_page` و`language`. ignored_fields: type: array items: type: string description: >- مفاتيح جسم الطلب التي لم تتعرّف عليها النقطة الطرفية وتجاهلتها. تعني الفارغة أن كل مفتاح طُبِّق — المرشح ذو الخطأ الإملائي يوسّع البحث بدلًا من الفشل. search_pagination: type: object description: الترقيم الصفحي لمجموعة النتائج. properties: page: type: integer description: رقم الصفحة الحالية. per_page: type: integer description: السجلات لكل صفحة. total_entries: type: integer description: >- إجمالي السجلات المطابقة. في عمليات البحث الواسعة غير المحدَّدة بشركة، هذا تقدير. total_pages: type: integer description: '`total_entries` مقسومة على `per_page`.' total_display_pages: type: integer description: >- الصفحات التي يمكنك طلبها فعليًا، محدودة بـ`max_search_page` الخاص بخطتك. is_timeout: type: boolean description: >- `true` عندما انتهت مهلة استعلام العدّ وتكون `total_entries` تقديرًا جزئيًا. news_search_result: type: object description: مقال إخباري واحد. properties: news_id: type: string format: uuid description: معرّف المقال. news_search_id: type: string format: uuid description: معرّف سجل البحث. مرّره إلى News Lookup. title: type: string description: العنوان الرئيسي. summary: type: string description: ملخص موجز للمقال. nullable: true url: type: string description: رابط إلى المقال. source: type: string description: نطاق الناشر. nullable: true image_url: type: string description: الصورة الرئيسية، عندما يكون للمقال واحدة. nullable: true language: type: string description: رمز لغة ISO 639-1 للمقال. نفس مفردات مرشح `news_languages`. nullable: true published_at: type: string format: date-time description: >- وقت النشر. هذا هو مفتاح الترتيب الافتراضي (تُرتَّب المقالات غير المؤرَّخة أخيرًا). nullable: true last_modified: type: string format: date-time description: متى حُدِّث السجل آخر مرة. category: type: string description: >- الاسم القياسي لفئة الأخبار. نفس مفردات مرشح `categories` ونقطة News Categories. nullable: true news_category_name: type: string description: اسم الفئة القابل للقراءة، مُترجَم بحسب `language`. nullable: true news_galleries: type: array nullable: true items: type: object properties: news_gallery_id: type: string format: uuid slug: type: string name: type: string description: المعارض التي ينتمي إليها المقال؛ `null` عند عدم وجود أي منها. country_codes: type: array nullable: true items: type: string description: >- الدول التي يتناولها المقال (ISO 3166-1 alpha-2)؛ `null` عند عدم الاكتشاف. نفس مفردات مرشح `locations`. company_country_codes: type: array nullable: true items: type: string description: دول مقر الشركات المذكورة. نفس مفردات مرشح `company_locations`. locations: type: array nullable: true items: type: string description: أسماء الأماكن المذكورة في المقال؛ `null` عند عدم وجود أي منها. domains: type: array items: type: string description: نطاقات كل شركة يذكرها المقال. companies: type: array items: $ref: '#/components/schemas/search_result_company' description: كل شركة يذكرها المقال، بنفس ترتيب `domains`. expansion_signals: type: array items: type: object properties: signal_type_slug: type: string description: نوع الإشارة، مثل `HIRE`، `PARTNER`، `PRODUCT`. signal_subtype_slug: type: string description: النوع الفرعي للإشارة، عندما يكون للنوع واحد. nullable: true signal_strength_slug: type: string description: 'قوة الإشارة: `low`، `medium`، `high`، `very_high`.' polarity: type: string description: >- `expansion`، `contraction_leading`، `contraction_confirming` أو `contraction_lagging`. country_code: type: string description: السوق التي تشير إليها الإشارة. nullable: true domain_search_id: type: string format: uuid description: الشركة التي تنتمي إليها الإشارة. event_date: type: string format: date-time description: متى حدثت الإشارة. description: >- فقط عند `is_expansion_signal_available: true`: إشارات التوسع التي أنتجها هذا المقال. مصفوفة فارغة عند عدم وجود أي منها. search_result_company: type: object description: الشركة التي يرتبط بها السجل. properties: domain_search_id: type: string format: uuid description: >- معرّف شركة في Pubrio. مرّره إلى `companies` في أي بحث، أو إلى Company Lookup. company_name: type: string description: اسم الشركة. linkedin_name: type: string nullable: true description: >- الاسم القياسي للشركة على LinkedIn (الجزء بعد `linkedin.com/company/`). country_code: type: string nullable: true description: رمز ISO 3166-1 alpha-2 لمقر الشركة. company_url: type: string nullable: true description: رابط موقع الشركة الإلكتروني. domain: type: string description: نطاق الشركة، بعد التطبيع (`stripe.com`). logo_url: type: string nullable: true description: رابط شعار الشركة. responses: general_error: description: >- طلب غير صحيح. كان الطلب مُصاغًا بشكل خاطئ أو يحتوي معاملات غير صالحة. تحقق من رمز الخطأ والرسالة للتفاصيل. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- تم تجاوز حد المعدل. نُفِّذت طلبات كثيرة جدًا خلال فترة زمنية معينة. أعِد المحاولة بعد إعادة ضبط نافذة حد المعدل. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- خطأ خادم داخلي. حدث خطأ غير متوقع في الخادم. تواصل مع الدعم إن استمر الخطأ. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات والعمليات المقابلة. يمكنك إنشاءه عبر قسم [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````