> ## 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.

# سجل التغييرات

> أحدث التحديثات وسجل الإصدارات لمنصة Pubrio.

تتبّع تطور طبقة بيانات Pubrio.

## إصدارات 2026

<AccordionGroup>
  <Accordion title="v2.3.2 - مراجعة مرجع مرشحات البحث (سبتمبر 2026)" defaultOpen>
    * **جديد:** [التعدادات والثوابت](/ar/api-reference/enums) — كل قيمة ثابتة تقبلها الواجهة أو تُعيدها في صفحة واحدة: درجات الأقدمية، الوظائف الأساسية، مصادر الإعلانات وصيغها، فئات الانتشار، منصات الناشرين، أنواع الإشارات، المستويات الإدارية.
    * **جديد:** أدلة بحث لـ[البحث عن الوظائف](/ar/developer-guides/search/job-search)، و[البحث في الأخبار](/ar/developer-guides/search/news-search)، و[البحث في الإعلانات](/ar/developer-guides/search/advertisement-search) — جداول مرشحات، وشروحات للاستجابة، ووصفات جاهزة للنسخ واللصق.
    * **API:** توثّق نقطة البحث عن الوظائف الحقول `functions` و`seniority_ranks` و`launch_dates` و`location_ids` و`created_at` و`is_ascending_order`. تعلن صفوف الاستجابة الآن `functions` و`seniority_rank` و`source_type` و`base_salary` و`experience_requirement` و`education_requirement` و`employment_type`.
    * **API:** توثّق نقطة البحث في الإعلانات الحقول `active_dates` و`reach_tiers` و`exclude_source_types` و`created_at` و`advertisement_search_id` و`is_ascending_order`. تم تصحيح `source_types` — فهي تصفّي النتائج (لا الإثراء فقط) وتقبل `tiktok` و`apple`. تعلن الصفوف الآن `advertisement_format_normalized` و`advertiser` و`advertisement_url` و`is_company_matched` والثلاثية الخاصة بـ`total_impressions`؛ وتوثّق `metadata` الحقول `applied_source_types` و`unsupported_source_types` و`coverage_notes` و`skipped_source_types`.
    * **API:** توثّق نقطة البحث في الأخبار الحقول `published_at` و`news_search_id` و`is_ascending_order`، وتعلن كل حقل صف بما فيه `expansion_signals` (يُعاد عند ضبط `is_expansion_signal_available` — هذا يعكس إزالة الإصدار v2.3.1، التي تمت قبل شحن هذا العلَم).
    * **API:** توثّق نقطة البحث عن الأشخاص الحقول `exclude_people_titles` و`exclude_people_locations` و`exclude_departments` و`exclude_department_functions` و`company_exclude_locations`.
    * **API:** توثّق نقطة البحث عن الشركات الحقلين `social_media` و`advertisement_status`.
    * **API:** توثّق كل نقطة بحث الآن `metadata.ignored_fields` — تُحذف مفاتيح جسم الطلب غير المعروفة، لا تُرفَض، وتُسرَد هناك. تعلن نقاط البحث عن الوظائف والأخبار والإعلانات أيضًا `pagination` وكتلة `metadata` مصنَّفة النوع بدلًا من كائن حر الصيغة.
    * **التوثيق:** أربعة مخططات (`job_exclude_locations`، و`advertisement_target_locations`، و`advertisement_exclude_target_locations`، و`domain_search_ids` في تصنيفات التوسع) كانت تكتب وصفًا بجانب `$ref`، الذي يتجاهله OpenAPI 3.0 بصمت. تُعرَض هذه الأوصاف الآن.
  </Accordion>

  <Accordion title="v2.3.1 - مراجعة مرجع Expansion API (أغسطس 2026)">
    * **API:** **البحث في إشارات التوسع** (`POST /expansions/signals/search`) موثَّقة الآن — استعلم عن صفوف الإشارات الخام المؤرَّخة وراء مرحلة شركة بدلًا من الشركات التي تتجمّع فيها.
    * **API:** **البحث المحدَّد في التوسع** (`POST /expansions/lookup`) موثَّقة الآن — الشقيقة الحتمية للبحث في التوسع التي لا تُرخي مرشحاتك تلقائيًا أبدًا، للوحات التحكم والمهام المجدولة التي تحتاج نتائج قابلة للتكرار.
    * **API:** أصبح لدى الـ Monitors التي تراقب `expansions` الآن مفردات مرشحات وحمولة webhook موثَّقة. [راجع إعداد Webhooks](/ar/developer-guides/setting-up-webhooks).
    * **API:** `is_include_metadata` موثَّق في تفاصيل توسع الشركة، والمقارنة، والملخصات، والتصنيفات. حركة مرور مفتاح API مختصرة افتراضيًا — اضبطها على `true` لتلقي `confidence_score` وتفاصيل النموذج الكاملة.
    * **API:** أُضيفت رموز أخطاء التوسع (`40043`، `40360`، `40435`، `40436`) إلى [رموز الحالة](/ar/api-reference/status-codes).
    * **أُزيل:** صفحات مرجع `/companies/{jobs,news,advertisements}/export`. يُعيد التصدير مرفق CSV مقابل رصيد `data_export_credit` منفصل ولا يُعيد شيئًا لا تُعيده نقطة البحث المقابلة بالفعل كـ JSON — استخدم البحث مع الترقيم الصفحي بدلًا من ذلك.
    * **أُزيل:** صفحة مرجع `/people/enrichment`، التي كانت توثّق نقطة طرفية لم تُطلَق قط. لإثراء شخص، استدعِ [People Lookup](/ar/api-reference/endpoint/people/lookup) مع `is_enrichment_available: true`.
    * **التوثيق:** أُزيلت `profile_id` من كل جسم طلب. مفتاح API الخاص بك يحدد مساحة عملك بالفعل، وكان المعامل يُتجاهَل في طلبات مفتاح API.
    * **API:** توثّق بحث الشركات المماثلة والأشخاص المماثلين الآن المعرّف المرجعي المطلوب. سابقًا كانت `/companies/search/similar` تُعيد `41847 Missing parameter` لكل مجموعة معاملات موثَّقة.
    * **API:** توثّق [إثراء الشركة](/ar/api-reference/endpoint/companies/enrichment) مصفوفات `jobs` و`news` و`advertisements` و`similar_companies` التي تُعيدها إلى جانب سجل الشركة، وتحذّر من أن الاستدعاء يستغرق عادةً 30-60 ثانية.
    * **API:** تعلن ثماني نقاط طرفية الآن `metadata` في المستوى الأعلى التي تُعيدها، بما يشمل كتلة `profile` بـ`credit` و`topup_credit` و`total_credit_cost`.
    * **API:** توثّق نقاط معرّفات الشركة الآن كل المعرّفات التسعة المقبولة، مضيفةً `tiktok_url` و`wantedly_url` و`tw104_url` و`rocketpunch_url` و`remember_url` و`youtrust_url`.
    * **التوثيق:** أُضيف `41847 Missing parameter` — أكثر أخطاء الواجهة شيوعًا — إلى [رموز الحالة](/ar/api-reference/status-codes).
    * **التوثيق:** يغطي [المصادقة](/ar/api-reference/authentication) الآن متطلب `User-Agent`. تُحظَر العملاء ذوو user agent عام عند الحافة برمز `HTTP 403` و`error code: 1010`، وهو ما يُخلَط بسهولة مع مفتاح API غير صحيح.
    * **التوثيق:** يوثّق [حد المعدل](/ar/api-reference/rate-limits) حقول الاستخدام والحصة التي تُعيدها Profile Usage، بما يشمل كيفية تطبيق `total_max_*` لمضاعِف الترخيص.
    * **API:** تسرد مرشحات التوسع (`stages`، `signal_types`، `signal_strengths`، `freshness`، `momentum`، `polarity`) الآن قيمها المسموح بها، ويحذّر كل منها من أن قيمة غير معروفة تُهمَل بصمت بدلًا من رفضها — مما يُسقط المرشح في بعض المعاملات ولا يطابق شيئًا في أخرى.
    * **API:** يقبل `momentum` القيم `advancing` و`steady` و`pulling_back`. قيم `directions` في مرجع التوسع (`retreating`، `new`) هي قيم استجابة في `stage.direction` ولم تكن صالحة كمرشح أبدًا.
    * **API:** تم تصحيح رؤى الأخبار — `mentions` و`topics` و`sources` و`top_source` حقول عدد صحيح/نص داخل `data.totals`، لا مصفوفات في المستوى الأعلى. `topics` و`sources` عدّادات لقيم مميزة؛ القوائم لكل عنصر هي `category_breakdown` و`market_breakdown`.
    * **API:** تم تصحيح رؤى الإعلانات — تستخدم `postings[]` المفاتيح المختصرة `r` و`m` و`ch` و`fo` و`n`؛ و`reach_tiers[]` كتالوج `{slug, label}` دون أعداد؛ وتوثّق `creatives[]` كل الحقول العشرة بما فيها `image_url` و`cta` و`has_video`.
    * **API:** تختلف مفاتيح `parameters` لقالب القناة حسب `channel_type_slug` — قوالب البريد الإلكتروني وLinkedIn وTwilio يحمل كل منها مجموعة مختلفة.
    * **التوثيق:** أُزيلت حقول استجابة لا تُعيدها الواجهة: `referral_code` من User، و`similarity_score` من Similar People، و`funding_status` و`crunchbase_url` من LinkedIn Company Lookup، و`expansion_signals` من News Search، و`occurs_at` / `occurs_until` من Expansion Signal Search.
    * **التوثيق:** أُعيد بناء جدول رموز الحالة من جدول أخطاء الواجهة. كانت تسعة رموز خاطئة: وُثّقت `40075` و`40076` و`40091` و`40092` و`40095` لإخفاقات الترقيم الصفحي والحصة لكنها في الواقع `41675` و`41676` و`41691` و`41692` و`41695` عند **HTTP 416** — وكل رقم موثَّق هو رمز حي لشيء غير ذي صلة. `40003` و`40602` و`40603` هي في الواقع `40303` و`40632` و`40633`؛ و`40099` غير موجودة أصلًا.
    * **التوثيق:** **HTTP 416** موثَّق الآن. يُعيد تجاوز حدود الترقيم الصفحي والحصة الرمز 416 مع رمز `416xx`، لا مجموعة نتائج مقتطَعة أبدًا.
    * **التوثيق:** أُضيفت عائلة أخطاء الـ Monitor (`40020`–`40035`)، بما فيها `40021` — لا يمكن تغيير `detection_mode` بعد إنشاء Monitor.
    * **API:** يبلغ سقف `per_page` حد `max_search_per_page` في خطتك (25 في معظم الخطط)؛ وتُعيد `26` الرمز HTTP 416. يبلغ سقف `page` حد `max_search_page`. يُعاد كلا الحدين، وكل سقف خطة آخر، عبر [Profile](/ar/api-reference/endpoint/profile/profile) وهما مُدرَجان الآن في [حد المعدل](/ar/api-reference/rate-limits).
    * **API:** يقبل `people_contact_types` بالضبط `email-work` و`email-personal` و`phone`. القيمة غير المعروفة **لا** تُرفَض — بل تُعيد HTTP 200 مع `emails: null` وتكلفة صفرية من الأرصدة، وهو ما لا يمكن تمييزه عن شخص ليس لديه بيانات تواصل.
    * **API:** تُعيد استجابات الاستبدال (Redemption) `null`، لا `[]`، لـ`emails` و`phones` عند عدم وجود شيء.
    * **API:** توثّق معاملات `create` لقالب القناة الآن — `channel_node_id` هو UUID من Channel Template Types، ويحدد مفاتيح `parameters` الصالحة. تأخذ `delete` قيم `channel_template_id` رقمية وتزيل إصدارًا واحدًا في كل مرة.
    * **API:** يُنفّذ التحقق من webhook الخاص بـ Monitor تسليمًا موقَّعًا حقيقيًا؛ لا يزال الرابط الذي يستجيب فقط لـ`GET` يفشل، وتُعيد `details` نص استجابة المصدر الأعلى.
  </Accordion>

  <Accordion title="v2.3.0 - إصدار التوسع (يوليو 2026)">
    * **ميزة جديدة:** **واجهة Market Expansion API.** تتبّع أي الشركات تدخل أي الأسواق، ومدى تقدمها — سلّم من أربع مراحل (استكشاف ← التزام ← توسع ← تنمية) مبني من إشارات توظيف، وأخبار، وإعلانات، وبنية تحتية سحابية، وفعاليات حقيقية. ابحث حسب الممر بـ`froms` / `tos`، وتعمّق في دخول شركة واحدة إلى السوق، وقارن النظراء. [ابدأ بالبداية السريعة](/ar/knowledge-base/concepts/expansion-api-quickstart).
    * **ميزة جديدة:** **البحث باللغة الطبيعية.** مرّر `query` بلغة إنجليزية عادية إلى البحث في التوسع ("شركات فينتك تتوسع إلى المملكة المتحدة") ويفسّره Pubrio إلى مرشحات — مع تفسيرات مطابقة اختيارية بالذكاء الاصطناعي مستندة إلى الإشارات الحقيقية لكل شركة عبر `is_explain_match`.
    * **API:** تعود النتائج الآن افتراضيًا بترتيب صلة يضع المتحركين المدعَّمين (أنواع إشارات مستقلة متعددة) أولًا؛ مرّر `sort_by: "recent"` للحداثة الصرفة.
    * **API:** يمكن للـ Monitors الآن مراقبة **إشارات التوسع** (`signal_types: ["expansions"]`) إلى جانب الوظائف والأخبار والإعلانات، ويمكن صياغة Monitor من جملة بلغة إنجليزية عادية عبر [Monitor Interpret](/ar/api-reference/endpoint/monitors/interpret).
    * **API:** أصبحت دورة حياة الـ Monitor الآن حقل `status` واحد (`draft` / `active` / `paused` / `inactive`)، محلًّا محل القيم المنطقية السابقة `is_active` / `is_paused` في الطلبات والاستجابات.
  </Accordion>

  <Accordion title="v2.2.0 - إصدار Monitor (أبريل 2026)">
    * **ميزة جديدة:** **Monitors.** اكتشاف إشارات آلي مع تسليم في الوقت الفعلي — تتبّع إعلانات الوظائف، وأخبار الشركات، والحملات الإعلانية عبر ملايين الشركات دون بناء خط أنابيب استعلام دوري خاص بك. حدّد المرشحات مرة واحدة، ويفحص Pubrio الإشارات المطابقة ويُثريها ويسلّمها إلى webhook أو بريدك الإلكتروني أو تسلسل تواصلك.
    * **ميزة جديدة:** **وضعا اكتشاف.** اختر بين **الإشارة أولًا** (فحص واسع للسوق) و**الشركة أولًا** (تتبّع حسابات محددة بالاسم) لمطابقة سير عمل تنقيبك.
    * **ميزة جديدة:** **إثراء تلقائي للأشخاص.** يمكن لكل تفعيل Monitor إيجاد جهات تواصل واستبدالها تلقائيًا في الشركات المطابقة — إثراء متعدد الطبقات مع مرشحات قابلة للضبط للمستوى الإداري والقسم والمسمى الوظيفي.
    * **API:** أُضيفت 15 نقطة طرفية جديدة لـ Monitor — عمليات CRUD كاملة، وإحصاءات، ومخططات، وسجلات اكتشاف، والتحقق من webhook، ومعالجة اختبار. [راجع مرجع Monitor API](/ar/api-reference/endpoint/monitors/create).
    * **API:** لم تعد `profile_id` مطلوبة في أجسام الطلبات. يتضمن مفتاح API الآن معلومات مساحة العمل. لا يزال المعامل مقبولًا للتوافق الخلفي.
    * **API:** أُضيفت `operationId` و`summary` و`description` و`tags` إلى كل النقاط الطرفية التسعة والخمسين لتحسين توافق وكلاء الذكاء الاصطناعي وأدوات MCP.
    * **التوثيق:** تفعيل `llms.txt` لاكتشاف زواحف الذكاء الاصطناعي.
  </Accordion>

  <Accordion title="v2.1.0 - نسخة Smart List التجريبية (فبراير 2026)">
    * **ميزة جديدة:** **قوائم Pubrio الذكية بالذكاء الاصطناعي (تجريبي).** يمكن للمستخدمين الآن رفع ملفات CSV وعرضها في واجهة جدول بيانات حيث يملأ Pubrio الأعمدة الناقصة تلقائيًا.
    * **البيانات:** أُضيف 3 ملايين كيان جديد موثَّق في منطقة DACH (ألمانيا، النمسا، سويسرا).
    * **API:** أوقات استجابة أسرع (انخفض زمن الاستجابة بمقدار 200 مللي ثانية) لنقطة `/enrich/company`.
  </Accordion>

  <Accordion title="v2.0.0 - تحديث العام الجديد (يناير 2026)">
    * **ميزة جديدة:** **معلومات استخباراتية للبحث الإعلاني.** نفهرس الآن مراكز شفافية الإعلانات ومستودعات البحث المدفوع. يمكنك الآن رؤية *ما إذا كانت* شركة تدير إعلانات، و*أين* تنفق، و*ما* الكلمات المفتاحية التي تستهدفها.
    * **تحسين:** تحسين اكتشاف "حزمة التقنيات" للشركات التي تستخدم برمجيات محلية غير قياسية في أمريكا اللاتينية.
  </Accordion>
</AccordionGroup>

***

## أرشيف 2025: عام الشركاء

تميز عام 2025 بتكاملاتنا الكبرى مع النظام البيئي، حاملةً بيانات Pubrio إلى المنصات التي تستخدمها يوميًا.

<AccordionGroup>
  <Accordion title="الربع الرابع 2025 - تكاملات الأتمتة">
    * **تكامل:** **Ottokit.** إطلاق الموصل الأصلي لسير عمل الوكلاء الذاتيين.
    * **تكامل:** **Databar.** إضافة Pubrio كمزوّد موثَّق في سوق Databar للبحث دون كتابة كود.
  </Accordion>

  <Accordion title="الربع الثالث 2025 - مزامنة التصميم إلى تسلسل التواصل">
    * **تكامل:** **Stripo.** تفعيل وظيفة "Push to Sequence"، مما يتيح لفرق التصميم مزامنة قوالب HTML مباشرة مع سير عمل Pubrio.
    * **ميزة:** **حقن متغيرات ديناميكي.** إتاحة حل العناصر النائبة العامة في القوالب ببيانات Pubrio في الوقت الفعلي عند الإرسال.
  </Accordion>

  <Accordion title="الربع الثاني 2025 - شراكة Clay">
    * **تكامل:** **تكامل Clay الأصلي.** أصبح Pubrio مزوّدًا افتراضيًا في قائمة إثراء Clay.
    * **البيانات:** توسيع تغطية "الـ70% غير المرئية" لتشمل 15 سجلًا محليًا جديدًا عبر آسيا والمحيط الهادئ.
  </Accordion>
</AccordionGroup>
