> ## 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 عن شركات تطابق معايير محددة مثل الصناعة، والحجم، والموقع، والتقنيات. ## OpenAPI ````yaml ar-openapi POST /companies/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/search: post: tags: - Search summary: البحث عن شركات description: >- ابحث في قاعدة بيانات Pubrio عن شركات تطابق معايير محددة مثل الصناعة، والحجم، والموقع، والتقنيات. operationId: companies_search parameters: [] requestBody: required: true content: application/json: schema: type: object properties: company_name: $ref: '#/components/schemas/company_name' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' company_filters: $ref: '#/components/schemas/company_filters' locations: $ref: '#/components/schemas/locations' exclude_locations: $ref: '#/components/schemas/exclude_locations' places: $ref: '#/components/schemas/places' exclude_places: $ref: '#/components/schemas/exclude_places' job_locations: $ref: '#/components/schemas/locations' job_exclude_locations: $ref: '#/components/schemas/job_exclude_locations' job_posted_dates: $ref: '#/components/schemas/posted_dates' job_titles: $ref: '#/components/schemas/people_titles' verticals: $ref: '#/components/schemas/verticals' vertical_categories: $ref: '#/components/schemas/vertical_categories' vertical_sub_categories: $ref: '#/components/schemas/vertical_sub_categories' categories: $ref: '#/components/schemas/categories' technologies: $ref: '#/components/schemas/technologies' employees: $ref: '#/components/schemas/employees' revenues: $ref: '#/components/schemas/revenues' founded_dates: $ref: '#/components/schemas/founded_dates' keywords: $ref: '#/components/schemas/keywords' social_media: $ref: '#/components/schemas/company_social_media' news_categories: $ref: '#/components/schemas/news_categories' news_published_dates: $ref: '#/components/schemas/published_dates' advertisement_search_terms: $ref: '#/components/schemas/advertisement_search_terms' advertisement_target_locations: $ref: '#/components/schemas/advertisement_target_locations' advertisement_exclude_target_locations: $ref: '#/components/schemas/advertisement_exclude_target_locations' advertisement_start_dates: $ref: '#/components/schemas/advertisement_start_dates' advertisement_end_dates: $ref: '#/components/schemas/advertisement_end_dates' advertisement_active_dates: $ref: '#/components/schemas/advertisement_active_dates' advertisement_status: $ref: '#/components/schemas/advertisement_status' advertisement_headlines: $ref: '#/components/schemas/advertisement_headlines' advertisement_platforms: $ref: '#/components/schemas/advertisement_platforms' advertisement_publisher_platforms: $ref: '#/components/schemas/advertisement_publisher_platforms' advertisement_exclude_publisher_platforms: $ref: >- #/components/schemas/advertisement_exclude_publisher_platforms advertisement_formats: $ref: '#/components/schemas/advertisement_formats' 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' filter_conditions: $ref: '#/components/schemas/company_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' exclude_fields: $ref: '#/components/schemas/exclude_fields' is_parameter_metadata_available: $ref: '#/components/schemas/is_parameter_metadata_available' is_profile_metadata_available: $ref: '#/components/schemas/is_profile_metadata_available' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' responses: '200': description: استجابة ناجحة تحتوي على تفاصيل البحث عن الشركات. content: application/json: schema: type: object properties: metadata: type: object description: >- سياق الطلب: `recent_search_log_identifier`، و`parameters` و`filters` المُعادة، وكتلة أرصدة `profile` اختيارية، و`ignored_fields` (مفاتيح جسم الطلب التي تجاهلتها النقطة الطرفية). data: $ref: '#/components/schemas/data' example: data: pagination: page: 1 per_page: 25 total_entries: 45234700 total_pages: 1809388 companies: - logo_url: >- https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg company_name: Twitter emails: - ... phones: - ... contacts: - ... founded_year: 2006 specialties: - Software Development industry: Software Development domain: twitter.com domain_search_id: 61a73da7-2efc-41a5-a252-a8a8df29925a domain_id: 224475931 linkedin_company_id: 44005587 linkedin_name: twitter is_company_url_active: true domain_ids: - 224475931 - 1758889566 - 368242865 company_keywords: - realtime information - social commerce - online shopping - classifieds - craigslist killers - e-commerce - killers - consumer internet - internet - information technology - edp services - technology - software development - microblogging - social networking - public conversation - user engagement - content sharing - advertising solutions - monetization - community building - digital wallet - ai integration - user safety company_size: 1500 youtube_url: null crunchbase_url: null linkedin_url: http://www.linkedin.com/company/twitter instagram_url: null facebook_url: http://facebook.com/twitterinc twitter_url: https://twitter.com/x github_url: null x_url: null location: United States company_ranking: null company_url: http://twitter.com saved_lists: null company_size_printed: 1,500 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: company_name: type: string example: pubrio description: |- صفِّ نتائج البحث لتشمل اسم شركة محدد. إن لم تطابق القيمة التي تدخلها لهذا المعامل اسم شركة، لن تظهر الشركة في نتائج البحث، حتى إن طابقت معاملات أخرى. تُقبل المطابقات الجزئية. companies: type: array items: type: string format: uuid description: >- قائمة من معرّفات فريدة (domain_search_id) تُستخدَم لعمليات البحث عن شركات وأشخاص. 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/` company_filters: type: object description: >- كائن غلاف للمرشحات على مستوى الشركة. تجميع موصى به يفصل بصريًا المفاتيح التي تصفّي *الشخص* (المستوى الأعلى) عن تلك التي تصفّي *الشركة*. يقبل نفس مفاتيح مرشحات الشركة في المستوى الأعلى (مثل `technologies`، `verticals`، `vertical_categories`، `vertical_sub_categories`، `categories`، `keywords`، `founded_dates`، `employees`، `revenues`، `company_locations`، `company_exclude_locations`، `company_places`، `company_exclude_places`، `companies`، `domains`، `company_linkedin_urls`، `is_enable_similarity_search`، `similarity_score`، بالإضافة إلى `filter_conditions`). يُسطِّح المحرك هذا الكائن إلى المستوى الأعلى قبل المعالجة — تفوز مفاتيح المستوى الأعلى عند التعارض. نفس الشكل المُستخدَم في `company_filters` الخاص بـ Monitor. راجع دليل مطوري Filters Overview للأمثلة. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and locations: type: array items: type: string example: - US - SG - CN description: >- يُستخدَم ISO 3166-1 alpha-2 (cca2) لتصفية المواقع. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: >- يُستخدَم ISO 3166-1 alpha-2 (cca2) لاستبعاد المواقع التي لا يلزم إعادتها. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. places: type: array items: type: string example: - Tokyo description: >- أسماء أماكن (مدينة، منطقة) تُستخدَم لتصفية النتائج. تقبل أسماء أماكن محلية أو إنجليزية. exclude_places: type: array items: type: string example: - Tokyo description: >- أسماء أماكن (مدينة، منطقة) مستبعدة من النتائج. تقبل أسماء أماكن محلية أو إنجليزية. job_exclude_locations: allOf: - $ref: '#/components/schemas/exclude_locations' description: المواقع الجغرافية المستبعدة من نتائج إعلانات الوظائف. posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- المسميات الوظيفية المرتبطة بالأفراد الذين تهدف إلى تحديدهم. ستشمل النتائج أيضًا مسميات وظيفية تحتوي مصطلحات مشابهة، حتى لو لم تطابق تمامًا. مثلًا، البحث عن `software engineer` قد يُظهر نتائج لأفراد بمسمى `senior software engineer`. verticals: type: array items: type: integer description: >- قائمة من `vertical_id` تُستخدَم للبحث عن شركات في قطاع أو صناعة محددة. لإيجاد المعرّف، استدعِ نقطة `vertical` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["AI"]`. vertical_categories: type: array items: type: integer description: >- قائمة من `vertical_category_id` تُستخدَم للبحث عن شركات في فئة قطاع محددة. لإيجاد المعرّف، استدعِ نقطة `vertical category` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["Information Technology"]`. vertical_sub_categories: type: array items: type: integer description: >- قائمة من `vertical_sub_category_id` تُستخدَم للبحث عن شركات في فئة فرعية محددة لقطاع. لإيجاد المعرّف، استدعِ نقطة `vertical sub category` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["Software"]`. categories: type: array items: type: integer description: >- قائمة من `category_id` تُستخدَم للبحث عن فئات محددة من التقنيات التي تستخدمها الشركات. لإيجاد المعرّف، استدعِ نقطة `category` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["CDN"]`. technologies: type: array items: type: integer description: >- قائمة من `tag_id` تُستخدَم للبحث عن تقنيات محددة تستخدمها الشركات. لإيجاد المعرّف، استدعِ نقطة `technology` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["Shopify"]`. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- نطاق عدد الموظفين العاملين في الشركة. يتيح لك هذا إيجاد شركات بناءً على عدد الموظفين. يمكنك إضافة نطاقات متعددة لتوسيع نتائج بحثك. راجع نقاط `company size` تحت تبويب Filters لمزيد من المعلومات. revenues: type: array items: type: integer example: - 0 - 100000 description: الحد الأدنى والأقصى لنطاق إيرادات الشركة. founded_dates: type: array items: type: integer example: - 2018 - 2024 description: نطاق سنوات تأسيس الشركة. القيمة القصوى للتأسيس هي السنة الحالية. keywords: type: array items: type: string example: - ecommerce - ai - fintech description: >- قائمة من الكلمات المفتاحية لتصفية الشركات حسب الصلة، أو التخصصات، أو الأوصاف. company_social_media: type: array items: type: string enum: - linkedin - facebook - instagram - tiktok - twitter - x - github - wantedly - rocketpunch example: - tiktok description: >- شركات لديها ملف على أي من: `linkedin`، `facebook`، `instagram`، `tiktok`، `twitter`، `x`، `github`، `wantedly`، `rocketpunch`. ارفعه إلى AND بـ `filter_conditions`. news_categories: type: array items: type: string example: - launches description: >- قائمة من `category slugs` للبحث عن فئات أخبار محددة. لإيجاد اسم قياسي، استدعِ نقطة `news categories` تحت تبويب Filters. published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك. advertisement_search_terms: type: array items: type: string example: - asus description: كلمات مفتاحية تُستخدَم للبحث ضمن محتوى الإعلان أو عناوينه. advertisement_target_locations: allOf: - $ref: '#/components/schemas/target_locations' description: المواقع الجغرافية المستهدفة للإعلانات. advertisement_exclude_target_locations: allOf: - $ref: '#/components/schemas/exclude_target_locations' description: المواقع الجغرافية المستبعدة من استهداف الإعلانات. advertisement_start_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: نطاق تاريخ البداية لتصفية الإعلانات. advertisement_end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: نطاق تاريخ النهاية لتصفية الإعلانات. advertisement_active_dates: type: array items: type: string format: date example: - '2026-01-01' - '2026-01-31' description: >- اعثر على إعلانات كانت نشطة في أي لحظة خلال نطاق التاريخ هذا (قائم على التداخل: يشمل إعلانات بدأت قبل النطاق ولا تزال نشطة، لا الإعلانات التي بدأت ضمنه فقط). advertisement_status: type: array items: type: string enum: - currently_running - active_last_30_min example: - currently_running description: >- `currently_running`: شركات لديها إعلانات مسجَّلة. `active_last_30_min`: شركات تغيّرت إعلاناتها خلال آخر 30 دقيقة. advertisement_headlines: type: array items: type: string example: - limited time offer description: كلمات مفتاحية للبحث ضمن نص عنوان الإعلان. advertisement_platforms: type: array items: type: string enum: - linkedin - facebook - google - tiktok - apple example: - linkedin - facebook description: >- صفِّ حسب مكتبة الإعلانات التي جاء منها الإعلان. أحرف صغيرة، غير حساسة لحالة الأحرف. تُقبل `meta` كاسم بديل لـ `facebook`. 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_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_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` في المستوى الأعلى. company_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - advertisement_target_locations - advertisement_exclude_target_locations - advertisement_search_terms - places - exclude_places - job_exclude_locations example: keywords description: مفتاح المرشح الذي يحدد الخاصية التي يُطبَّق عليها العامل. operator: type: string enum: - or - and example: or description: >- العامل المنطقي المراد تطبيقه. استخدم 'or' لمطابقة أي من القيم المحددة، أو 'and' لاشتراط كل القيم المحددة. description: >- خيارات تصفية متقدمة لعمليات البحث عن الشركات. حدّد شروطًا تجمع بين مفاتيح وعوامل منطقية لتحسين نتائج البحث. is_enable_similarity_search: type: boolean description: >- عند التفعيل، يمكن ملء المرشحات المذكورة أعلاه التي تدعم بحث التشابه بنص حر لمعرّفات محددة. similarity_score: type: number format: float example: 0.7 description: >- يُستخدَم مع `is_enable_similarity_search`. يُستخدَم هذا الرقم لتحليل ما إذا كان اسم قياسي محدد (مثل قطاع صناعي، تقنية) مشابهًا لمدخل المستخدم، وكلما زاد الرقم، زادت الصرامة. exclude_fields: type: array items: type: string example: - emails - phones - contacts description: قائمة الحقول المستبعدة من حمولة الاستجابة. is_parameter_metadata_available: type: boolean description: يشير إلى ما إذا كانت بيانات المعامل الوصفية متاحة للطلب. is_profile_metadata_available: type: boolean description: يشير إلى ما إذا كانت بيانات الملف الشخصي الوصفية متاحة للطلب. 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**. data: type: object nullable: true description: تعتمد معلومات الاستجابة على النقطة الطرفية المحددة. 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'، يجب ألا يستهدف الإعلان أيًا من المواقع المستبعدة. 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 ````