> ## 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/job-search). ## OpenAPI ````yaml ar-openapi POST /companies/jobs/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/jobs/search: post: tags: - Search summary: البحث عن إعلانات الوظائف description: >- ابحث في إعلانات الوظائف. راجع [دليل البحث عن الوظائف](/ar/developer-guides/search/job-search). operationId: companies_search_jobs parameters: [] requestBody: required: true content: application/json: schema: type: object properties: locations: $ref: '#/components/schemas/locations' exclude_locations: type: array items: type: string example: - TW description: >- رموز مواقع ISO 3166-1 alpha-2 (cca2) المستبعدة من نتائج الوظائف. راجع نقاط `location` تحت تبويب Filters للحصول على الرموز الصالحة. location_ids: $ref: '#/components/schemas/job_location_ids' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' 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: - Software Developer description: >- مصفوفة من كلمات مفتاحية لتصفية إعلانات الوظائف. تُطابَق كل عبارة مقابل محتوى الوظيفة. استخدم `search_term` لعبارة واحدة أو `search_terms` لعدة كلمات مفتاحية. titles: $ref: '#/components/schemas/people_titles' functions: $ref: '#/components/schemas/job_functions' seniority_ranks: $ref: '#/components/schemas/job_seniority_ranks' posted_dates: $ref: '#/components/schemas/posted_dates' launch_dates: $ref: '#/components/schemas/job_launch_dates' created_at: $ref: '#/components/schemas/search_created_at' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' 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' jobs: type: array items: $ref: '#/components/schemas/job_search_result' example: metadata: profile: null filters: domains: - google.com per_page: 25 language: en ignored_fields: [] data: pagination: page: 1 per_page: 25 total_entries: 2228628 total_pages: 89146 is_timeout: false total_display_pages: 250 jobs: - job_id: 371d0c44-4c56-4c9c-98e2-ef6dd986b848 job_search_id: 371d0c44-4c56-4c9c-98e2-ef6dd986b848 last_modified: '2025-05-31T20:41:27.894Z' companies: logo_url: >- https://buckets.pubrio.com/company-logo/OTQxMjYxMTFnb29nbGUuY29tLnBrbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: 539e2c34-de6b-4613-8f5b-e3aa18b4ef47 company_name: Google linkedin_name: google country_code: US domain: google.com location: Seoul, Seoul, South Korea job_url: >- https://kr.linkedin.com/jobs/view/software-engineer-greach-program-for-people-with-disabilities-%EC%9E%A5%EC%95%A0%EC%9D%B8-%EC%B1%84%EC%9A%A9-at-google-4224659596?position=7&pageNum=0&refId=DwDpGXGftUql%2FkETvFCwXw%3D%3D&trackingId=gAvrIP0yUQuf8fjK67HSbQ%3D%3D posting_date: '2025-05-31' country_code: KR location_id: 491 title: >- Software Engineer, gReach Program for People with Disabilities (장애인 채용) country: South Korea created_at: '2025-05-10T14:30:58.348Z' source_type: linkedin functions: null seniority_rank: 0 base_salary: null experience_requirement: null education_requirement: null employment_type: null - ... '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 لمزيد من المعلومات. job_location_ids: type: array items: type: integer example: - 357 - 419 description: >- دولة الإعلان حسب `location_id` الخاص بـ Pubrio (نقطة Locations؛ موجود أيضًا في كل صف). بديل لـ `locations`. 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) تُستخدَم لعمليات البحث عن شركات وأشخاص. 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: سلسلة من الكلمات نريد تصفية النتائج بها. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- المسميات الوظيفية المرتبطة بالأفراد الذين تهدف إلى تحديدهم. ستشمل النتائج أيضًا مسميات وظيفية تحتوي مصطلحات مشابهة، حتى لو لم تطابق تمامًا. مثلًا، البحث عن `software engineer` قد يُظهر نتائج لأفراد بمسمى `senior software engineer`. job_functions: type: array items: type: string example: - engineering - product_management description: >- أسماء الوظائف الأساسية القياسية المشتقة من المسمى، مثل `engineering`، `sales`، `marketing`، `finance`، `product_management` — نفس القيم التي تُعيدها الصفوف في `functions`. الأسماء القياسية غير المعروفة لا تطابق شيئًا. القائمة الكاملة: [التعدادات والثوابت](/ar/api-reference/enums#job-functions). job_seniority_ranks: type: array items: type: integer enum: - 1 - 2 - 3 - 4 - 5 example: - 4 - 5 description: >- فئة الأقدمية من المسمى: `1` مبتدئ، `2` خبير، `3` مدير، `4` مدير تنفيذي، `5` قيادة عليا. تُتجاهَل القيم خارج النطاق 1-5 ويُسقَط المرشح. تُعيد الصفوف فئتها في `seniority_rank` (`0` = غير مصنَّف). posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك. job_launch_dates: type: array items: type: string format: date minItems: 1 maxItems: 2 example: - '2026-08-01' - '2026-08-31' description: >- نافذة `[من, إلى]` شاملة (UTC) على تاريخ الإطلاق: `posting_date`، أو يوم الاستيعاب عند غيابه. يطابق كيفية احتساب رؤى الوظائف. التاريخ الواحد يطابق ذلك اليوم. search_created_at: type: string format: date-time example: '2026-09-02T12:00:00Z' description: >- استُوعِب عند هذه اللحظة أو بعدها (UTC). تاريخ أو طابع زمني ISO. للمزامنات التزايدية مرّر `created_at` لأحدث صف مخزَّن لديك. is_realtime_enrichment: type: boolean default: false example: true description: >- فعّل الإثراء في الوقت الفعلي لاستعلام واحد محدَّد النطاق بشركة (مصفّى بـ`domain_search_id` أو `domains` أو `linkedin_urls`). عندما يُعيد البحث الأولي صفر نتائج، تجمع النقطة الطرفية بيانات من المصدر، وتحفظ السجلات، وتعيد تشغيل البحث قبل الاستجابة. خاضع لموعد نهائي لكل مسار. is_ascending_order: type: boolean default: false example: false description: >- اتجاه الترتيب. تُعاد النتائج بترتيب الأحدث أولًا افتراضيًا؛ اضبط `true` للأقدم أولًا. لا يوجد `sort_by` في هذه النقطة الطرفية — مفتاح الترتيب ثابت ومذكور في وصف النقطة الطرفية. 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**. 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` تقديرًا جزئيًا. job_search_result: type: object description: إعلان وظيفة واحد. properties: job_id: type: string format: uuid description: معرّف الإعلان. job_search_id: type: string format: uuid description: نفس قيمة `job_id`. مرّره إلى Job Lookup. created_at: type: string format: date-time description: متى استوعب Pubrio الإعلان لأول مرة. هذا هو مفتاح الترتيب الافتراضي. last_modified: type: string format: date-time description: متى حُدِّث السجل آخر مرة. title: type: string description: المسمى الوظيفي كما نُشر. job_url: type: string description: رابط إلى الإعلان في المصدر. location: type: string description: الموقع كنص حر كما نُشر. nullable: true location_id: type: integer nullable: true description: >- `location_id` الخاص بـ Pubrio لدولة الإعلان. نفس مفردات مرشح `location_ids`. country: type: string description: اسم دولة الإعلان. nullable: true country_code: type: string description: رمز ISO 3166-1 alpha-2 لدولة الإعلان. نفس مفردات مرشح `locations`. nullable: true posting_date: type: string format: date nullable: true description: >- تاريخ نشر الناشر. تُصفّي `launch_dates` عليه، وتعود إلى `created_at` عند غيابه. source_type: type: string description: المصدر الذي التُقط منه الإعلان، مثل `linkedin`. functions: type: array nullable: true items: type: string description: >- الأسماء القياسية للوظائف الأساسية المحلولة من المسمى؛ `null` عندما تكون غير مصنَّفة. نفس مفردات مرشح `functions`. seniority_rank: type: integer enum: - 0 - 1 - 2 - 3 - 4 - 5 description: >- فئة الأقدمية من `1` إلى `5` كما هي معرَّفة في مرشح `seniority_ranks`؛ `0` عندما يتعذّر تصنيف المسمى. base_salary: type: string description: نص الراتب كما نُشر، عندما يوفّره المصدر. nullable: true experience_requirement: type: string description: متطلب الخبرة كما نُشر، عندما يوفّره المصدر. nullable: true education_requirement: type: string description: متطلب التعليم كما نُشر، عندما يوفّره المصدر. nullable: true employment_type: type: string description: نوع التوظيف كما نُشر (مثل `Full-time`)، عندما يوفّره المصدر. nullable: true companies: $ref: '#/components/schemas/search_result_company' 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 ````