> ## 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/advertisement-search). ## OpenAPI ````yaml ar-openapi POST /companies/advertisements/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/advertisements/search: post: tags: - Search summary: البحث في إعلانات الشركات description: >- ابحث في الإعلانات التي تديرها الشركات. راجع [دليل البحث في الإعلانات](/ar/developer-guides/search/advertisement-search). operationId: companies_search_advertisements parameters: [] requestBody: required: true content: application/json: schema: type: object properties: target_locations: $ref: '#/components/schemas/target_locations' exclude_target_locations: $ref: '#/components/schemas/exclude_target_locations' search_terms: $ref: '#/components/schemas/search_terms' headlines: $ref: '#/components/schemas/headlines' filter_conditions: $ref: '#/components/schemas/ads_filter_conditions' start_dates: $ref: '#/components/schemas/start_dates' end_dates: $ref: '#/components/schemas/end_dates' active_dates: $ref: '#/components/schemas/advertisement_active_dates_search' created_at: $ref: '#/components/schemas/search_created_at' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' advertisement_search_id: allOf: - $ref: '#/components/schemas/advertisement_search_id' description: >- أعِد هذا السجل الواحد فقط. مفيد لإعادة جلب صف خزّنته سابقًا دون ترقيم صفحات. domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' advertisement_formats: $ref: '#/components/schemas/advertisement_formats' reach_tiers: $ref: '#/components/schemas/advertisement_reach_tiers' advertisement_active_ads: $ref: '#/components/schemas/advertisement_active_ads' advertisement_running_ads: $ref: '#/components/schemas/advertisement_running_ads' advertisement_total_ads: $ref: '#/components/schemas/advertisement_total_ads' advertisement_platform_count: $ref: '#/components/schemas/advertisement_platform_count' advertisement_format_count: $ref: '#/components/schemas/advertisement_format_count' advertisement_impressions_estimate: $ref: '#/components/schemas/advertisement_impressions_estimate' advertisement_country_activity: $ref: '#/components/schemas/advertisement_country_activity' source_types: $ref: '#/components/schemas/advertisement_source_types' exclude_source_types: $ref: '#/components/schemas/advertisement_exclude_source_types' enrichment_mode: $ref: '#/components/schemas/advertisement_enrichment_mode' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' publisher_platforms: $ref: '#/components/schemas/advertisement_publisher_platforms' exclude_publisher_platforms: $ref: >- #/components/schemas/advertisement_exclude_publisher_platforms is_include_unlinked_companies: $ref: >- #/components/schemas/advertisement_is_include_unlinked_companies responses: '200': description: استجابة ناجحة تحتوي على تفاصيل البحث في إعلانات الشركة. content: application/json: schema: type: object properties: metadata: $ref: '#/components/schemas/advertisement_search_metadata' data: type: object properties: pagination: $ref: '#/components/schemas/search_pagination' advertisements: type: array items: $ref: '#/components/schemas/advertisement_search_result' example: metadata: profile: null filters: source_types: - linkedin per_page: 25 language: en ignored_fields: [] applied_source_types: - linkedin data: pagination: page: 1 per_page: 25 total_entries: 694356 total_pages: 27775 total_display_pages: 250 is_timeout: false advertisements: - target_country_codes: - US - GB - SG advertisement_id: 3af8cb80-9a04-49a8-832d-333961d5f77a advertisement_search_id: 3af8cb80-9a04-49a8-832d-333961d5f77a created_at: '2026-03-03T01:46:35.909Z' last_modified: '2026-03-03T12:46:25.289Z' started_at: '2026-02-25T00:00:00.000Z' ended_at: '2026-03-02T00:00:00.000Z' title: Thuraya-4 Satellite Solutions for Energy source_type: linkedin advertisement_format: Single Image Ad video_url: null image_url: >- https://buckets.pubrio.com/images/public/cL1U5ghYPAy65qc4cu5wtmgzv8P9xJgrofNTwohPWsyT3S5ob2zNp6Jov1nM9aaDRy.jpg carousel_images: null destination_url: >- https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content companies: logo_url: >- https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg domain_search_id: fe3963dc-87a4-4016-8c95-217ea68cd57a company_name: Space42 linkedin_name: space42ai country_code: AE domain: space42.ai raw_link_url: null publisher_platforms: null advertisement_format_normalized: image is_company_matched: true advertiser: Thuraya advertiser_url: https://www.linkedin.com/company/thuraya advertisement_url: https://www.linkedin.com/ad-library/detail/1518455034 total_impressions: < 1k total_impressions_lower: null total_impressions_upper: 1000 - target_country_codes: - US - GB - SG advertisement_id: 47eb6229-e7aa-427f-bcd3-76e154fd5022 advertisement_search_id: 47eb6229-e7aa-427f-bcd3-76e154fd5022 created_at: '2026-06-03T22:00:33.035Z' last_modified: '2026-06-05T18:15:51.823Z' started_at: '2026-05-25T07:00:00.000Z' ended_at: '2026-06-03T07:00:00.000Z' title: Dubai Opportunities. One Exclusive Event source_type: facebook advertisement_format: DCO video_url: null image_url: >- https://buckets.pubrio.com/images/public/4snZgJwKCWEYwAUwxrkkK1ooEFEAMF92Xet6Bm16oAyqwUSoqekDjX8S9DmfixutuH.jpg carousel_images: null destination_url: >- https://promotions.damacproperties.com/en/event-in-egypt-social-specific/ raw_link_url: http://fb.me/ publisher_platforms: - facebook - instagram companies: logo_url: >- https://buckets.pubrio.com/company-logo/MjYwODA0MjRkYW1hY3Byb3BlcnRpZXMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: 9da7386c-5bdc-42b2-8fee-456e91024a3a company_name: Damac Properties linkedin_name: damac-properties country_code: AE domain: damacproperties.com advertisement_format_normalized: image is_company_matched: true advertiser: Thuraya advertiser_url: https://www.linkedin.com/company/thuraya advertisement_url: https://www.linkedin.com/ad-library/detail/1518455034 total_impressions: < 1k total_impressions_lower: null total_impressions_upper: 1000 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- صفِّ الإعلانات لتشمل تلك المستهدِفة مواقع محددة حسب رمز الدولة. استخدم هذا لإيجاد إعلانات تُعرض في دول محددة. يجمع مع `filter_conditions` باستخدام عامل OR — يجب أن يستهدف الإعلان موقعًا واحدًا على الأقل من المواقع المحددة. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- صفِّ الإعلانات لاستبعاد تلك المستهدِفة مواقع محددة حسب رمز الدولة. استخدم هذا لاستبعاد إعلانات تُعرض في دول محددة. عند تحديدها في `filter_conditions` بعامل 'or'، يجب ألا يستهدف الإعلان أيًا من المواقع المستبعدة. search_terms: type: array items: type: string example: - pubrio description: قائمة من السلاسل النصية نريد تصفية النتائج بها. headlines: type: array items: type: string example: - ASUS - iPhone description: قائمة من العناوين لتصفية نتائج البحث. ads_filter_conditions: type: array items: type: object properties: key: type: string enum: - target_locations - exclude_target_locations example: exclude_target_locations description: مفتاح المرشح الذي يحدد الخاصية التي يُطبَّق عليها العامل. operator: type: string enum: - or - and example: or description: >- العامل المنطقي المراد تطبيقه. استخدم 'or' لمطابقة الإعلانات التي تتضمن/تستبعد أيًا من المواقع المحددة، أو 'and' لمطابقة الإعلانات التي تتضمن/تستبعد كل المواقع المحددة. description: >- خيارات تصفية متقدمة لعمليات بحث الإعلانات. حدّد شروطًا لتحسين نتائج بحثك لنقطة بحث الإعلانات. start_dates: type: array items: type: string format: date example: - '2025-12-01' - '2025-12-01' description: قائمة من تواريخ البداية لتصفية نتائج البحث. end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: قائمة من تواريخ النهاية لتصفية نتائج البحث. advertisement_active_dates_search: type: array items: type: string format: date minItems: 2 maxItems: 2 example: - '2026-08-01' - '2026-08-31' description: >- نافذة `[من, إلى]` شاملة (UTC). تُعيد إعلانات نشطة في أي لحظة ضمنها، بما فيها التي بدأت قبل ذلك، لذا تتوافق مع رؤى الإعلانات. تُحتسَب الإعلانات غير المؤرَّخة من `created_at`. كلا التاريخين مطلوب، `from` ≤ `to`. search_created_at: type: string format: date-time example: '2026-09-02T12:00:00Z' description: >- استُوعِب عند هذه اللحظة أو بعدها (UTC). تاريخ أو طابع زمني ISO. للمزامنات التزايدية مرّر `created_at` لأحدث صف مخزَّن لديك. 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) تُستخدَم لعمليات البحث عن شركات وأشخاص. advertisement_search_id: type: string format: uuid example: a92643e8-9033-4029-aa65-ef929327cebb 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/` is_realtime_enrichment: type: boolean default: false example: true description: >- فعّل الإثراء في الوقت الفعلي لاستعلام واحد محدَّد النطاق بشركة (مصفّى بـ`domain_search_id` أو `domains` أو `linkedin_urls`). عندما يُعيد البحث الأولي صفر نتائج، تجمع النقطة الطرفية بيانات من المصدر، وتحفظ السجلات، وتعيد تشغيل البحث قبل الاستجابة. خاضع لموعد نهائي لكل مسار. advertisement_formats: type: array items: type: string enum: - image - video - text - carousel - dynamic_product - document - message - event - article - spotlight - follow - job - engagement example: - image - video description: اعثر على شركات لديها إعلان واحد على الأقل بأي من هذه الصيغ الإبداعية. advertisement_reach_tiers: type: array items: type: string enum: - lt_1k - 1k_10k - 10k_50k - 50k_100k - 100k_500k - 500k_1m - 1m_plus example: - 100k_500k - 500k_1m - 1m_plus description: >- نطاق انطباعات الإعلان: `lt_1k`، `1k_10k`، `10k_50k`، `50k_100k`، `100k_500k`، `500k_1m`، `1m_plus`. الإعلانات دون قيمة `total_impressions` لا تطابق أبدًا؛ الأسماء القياسية غير المعروفة لا تطابق شيئًا. advertisement_active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- الحد الأدنى والأقصى لعدد إعلانات الشركة النشطة حاليًا، عبر كل الدول. استخدم `null` لحد مفتوح، مثل `[1, null]` لـ "إعلان نشط واحد على الأقل". advertisement_running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- الحد الأدنى والأقصى لعدد إعلانات الشركة التي لا تزال تعمل (دون تاريخ انتهاء، أو بتاريخ انتهاء في المستقبل). مُعبَّأ حاليًا لإعلانات LinkedIn فقط. advertisement_total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: >- الحد الأدنى والأقصى لإجمالي عدد إعلانات الشركة المسجَّلة على الإطلاق، عبر كل الدول. advertisement_platform_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- الحد الأدنى والأقصى لعدد منصات الإعلان المميزة (linkedin، facebook، google، tiktok، apple) التي تعلن الشركة عليها بنشاط. advertisement_format_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- الحد الأدنى والأقصى لعدد صيغ المحتوى الإبداعي الإعلاني المميزة التي تديرها الشركة بنشاط. advertisement_impressions_estimate: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: >- الحد الأدنى والأقصى لتقدير انطباعات الإعلانات، مجموعة عبر كل الدول. تُحتسَب فقط الإعلانات التي لها نطاق انطباعات مُبلَّغ عنه. advertisement_country_activity: type: object properties: country: type: string example: US description: رمز دولة ISO 3166-1 alpha-2 لتحديد نطاق هذا المرشح به. مطلوب. rank: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - null - 500 description: >- الترتيب ضمن تلك الدولة حسب حجم الإعلان. 1 يعني أكبر منفق، ويزيد الرقم كلما انخفض حجم الإعلان. استخدم `[null, 500]` لإيجاد أكبر 500 منفق في تلك الدولة؛ استخدم `[500, null]` لإيجاد كل من ترتيبه 500 أو أقل. percentile: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 90 - null description: >- المئين ضمن تلك الدولة حسب حجم الإعلان، 0-100. الأعلى يعني منفقًا أكبر. استخدم `[90, null]` لأعلى 10% من المنفقين في تلك الدولة. volume_score: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 0.5 - null description: >- درجة حجم الإعلان الأساسية من 0-1 التي تُحسَب منها كل من `rank` و`percentile`. active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: الحد الأدنى والأقصى للإعلانات النشطة، محدَّد النطاق بهذه الدولة. running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- الحد الأدنى والأقصى للإعلانات العاملة، محدَّد النطاق بهذه الدولة. مُعبَّأ حاليًا لإعلانات LinkedIn فقط. total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: الحد الأدنى والأقصى لإجمالي الإعلانات، محدَّد النطاق بهذه الدولة. impressions: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: الحد الأدنى والأقصى لتقدير الانطباعات، محدَّد النطاق بهذه الدولة. required: - country example: country: US rank: - null - 500 description: >- النشاط الإعلاني لدولة واحدة محددة. `country` مطلوب، ويجب ضبط حقل واحد آخر على الأقل (الدولة وحدها لا تطابق شيئًا). لإجمالي عبر كل الدول بدلًا من ذلك، استخدم مرشحات `advertisement_active_ads` / `advertisement_total_ads` / `advertisement_impressions_estimate` في المستوى الأعلى. advertisement_source_types: type: array items: type: string enum: - linkedin - facebook - google - tiktok - apple example: - linkedin - facebook description: >- المصادر المراد تضمينها: `linkedin`، `facebook` (تُقبل `meta`)، `google`، `tiktok`، `apple`. القيم غير المعروفة لا تطابق شيئًا وتُعرض في `metadata.unsupported_source_types`. advertisement_exclude_source_types: type: array items: type: string enum: - linkedin - facebook - google - tiktok - apple example: - apple description: >- استبعد إعلانات مُلتقَطة من هذه المصادر. نفس مفردات `source_types` (`linkedin`، `facebook`، `google`، `tiktok`، `apple`؛ `meta` اسم بديل لـ`facebook`). تُتجاهَل القيم غير المعروفة. advertisement_enrichment_mode: type: string enum: - default - latest default: default example: latest description: >- يتحكم في سلوك الإثراء في الوقت الفعلي. تُعيد `default` ما هو موجود بالفعل في قاعدة البيانات، وتفعّل الإثراء فقط عندما تكون مجموعة النتائج فارغة و`is_realtime_enrichment` مضبوطة. تتجاوز `latest` التخزين المؤقت وتفرض تمريرة إعادة إثراء مقابل أحدث سجلات المصدر في كل استدعاء — تفعّل الإثراء بمفردها دون الحاجة إلى أي علَم آخر. 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` في هذه النقطة الطرفية — مفتاح الترتيب ثابت ومذكور في وصف النقطة الطرفية. advertisement_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - facebook - instagram description: >- صفِّ إعلانات Facebook/Meta حسب سطح المنصة الذي عُرضت عليه. أحرف صغيرة وغير حساسة لحالة الأحرف. يُطبَّق فقط على مصدر `facebook` (المصادر الأخرى منصة واحدة). advertisement_exclude_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - audience_network description: استبعد إعلانات Facebook/Meta المعروضة على أسطح المنصات هذه. advertisement_is_include_unlinked_companies: type: boolean default: false example: true description: >- أدرِج إعلانات غير مرتبطة بعد بشركة محلولة (إعلانات طبقة خام، مثل إعلانات احتيالية أو صفحات مؤقتة). الافتراضي false، والذي يُعيد فقط الإعلانات المنسوبة لشركة. advertisement_search_metadata: allOf: - $ref: '#/components/schemas/search_metadata' - type: object properties: applied_source_types: type: array items: type: string description: >- فقط عند إرسال `source_types`: القيم التي تم التعرّف عليها وتطبيقها. unsupported_source_types: type: array items: type: string description: >- فقط عندما احتوت `source_types` قيمة غير معروفة كمصدر. تلك القيم لا تطابق شيئًا. coverage_notes: type: array items: type: object properties: source_type: type: string scope: type: string enum: - eea_uk_ch description: ملاحظات التغطية للمصادر المطلوبة، عند الاقتضاء. skipped_source_types: type: array items: type: object properties: source_type: type: string description: المصدر الذي تم تخطّيه. reason: type: string enum: - country_unknown_until_enriched description: سبب عدم تطبيق المصدر. description: >- المصادر التي لم تُطبَّق بالنسبة لـ`target_locations` المطلوبة، كل منها بـ`reason`. 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` تقديرًا جزئيًا. advertisement_search_result: type: object description: إعلان واحد. properties: advertisement_id: type: string format: uuid description: معرّف الإعلان. advertisement_search_id: type: string format: uuid description: نفس قيمة `advertisement_id`. مرّره إلى Advertisement Lookup. created_at: type: string format: date-time description: متى التقط Pubrio الإعلان لأول مرة. هذا هو مفتاح الترتيب الافتراضي. last_modified: type: string format: date-time description: متى حُدِّث السجل آخر مرة. started_at: type: string format: date-time description: متى بدأ الإعلان بالعمل، كما أبلغ عنه المصدر. nullable: true ended_at: type: string format: date-time description: متى توقف الإعلان عن العمل؛ `null` طالما لا يزال يعمل. nullable: true title: type: string description: العنوان الرئيسي أو عنوان الإعلان. nullable: true source_type: type: string enum: - linkedin - facebook - google - tiktok - apple description: المصدر الذي التُقط منه الإعلان. نفس مفردات مرشح `source_types`. advertisement_format: type: string description: >- تسمية الصيغة بالضبط كما ينشرها المصدر، مثل `Single Image Ad`، `MULTI_IMAGES`. nullable: true advertisement_format_normalized: type: string nullable: true enum: - image - video - text - carousel - dynamic_product - document - message - event - article - spotlight - follow - job - engagement - other description: >- الصيغة القياسية، المفردات التي يقبلها مرشح `advertisement_formats`. `other` عندما لا تكون التسمية الخام مُعيَّنة. is_company_matched: type: boolean description: >- `true` عندما يكون الإعلان مرتبطًا بسجل شركة في Pubrio. تُعاد الإعلانات غير المرتبطة فقط مع `is_include_unlinked_companies: true`. advertiser: type: string description: اسم المُعلن كما يعرضه المصدر. nullable: true advertiser_url: type: string description: صفحة المُعلن في المصدر، عند توفرها. nullable: true advertisement_url: type: string description: رابط إلى الإعلان في مكتبة إعلانات المصدر، عند توفرها. nullable: true total_impressions: type: string description: >- تقدير الانطباعات بالضبط كما ينشره المصدر، مثل `< 1k`، `10k-50k`. `null` للمصادر التي لا تُبلِّغ عن الانطباعات. nullable: true total_impressions_lower: type: integer nullable: true description: الحد الأدنى لنطاق الانطباعات؛ `null` لنطاقات `< N`. total_impressions_upper: type: integer nullable: true description: الحد الأقصى لنطاق الانطباعات؛ `null` للنطاقات المفتوحة. image_url: type: string description: الصورة الإبداعية، عندما يكون للإعلان واحدة. nullable: true video_url: type: string description: الفيديو الإبداعي، عندما يكون للإعلان واحد. nullable: true carousel_images: type: array nullable: true items: type: string description: إطارات العرض الدوّار، لصيغ العرض الدوّار. destination_url: type: string description: >- صفحة الهبوط المحلولة. تُفكّ أغلفة نقر Facebook مثل `fb.me` إلى رابط قمع التحويل الحقيقي. nullable: true raw_link_url: type: string description: الرابط الأصلي بالضبط كما التُقط، قبل الفك. nullable: true target_country_codes: type: array nullable: true items: type: string description: >- الدول التي عُرض فيها الإعلان (ISO 3166-1 alpha-2). نفس مفردات مرشح `target_locations`. publisher_platforms: type: array nullable: true items: type: string enum: - facebook - instagram - messenger - threads - audience_network description: >- أسطح Meta التي عمل عليها الإعلان: `facebook`، `instagram`، `messenger`، `threads`، `audience_network`. `null` للمصادر من غير `facebook`. companies: $ref: '#/components/schemas/search_result_company' 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_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 ````