Skip to main content
POST
البحث عن إعلانات الوظائف

التفويضات

pubrio-api-key
string
header
مطلوب

رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات والعمليات المقابلة. يمكنك إنشاءه عبر قسم Settings.

الجسم

application/json
locations
string[]

يُستخدَم ISO 3166-1 alpha-2 (cca2) لتصفية المواقع. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
exclude_locations
string[]

رموز مواقع ISO 3166-1 alpha-2 (cca2) المستبعدة من نتائج الوظائف. راجع نقاط location تحت تبويب Filters للحصول على الرموز الصالحة.

مثال:
location_ids
integer[]

دولة الإعلان حسب location_id الخاص بـ Pubrio (نقطة Locations؛ موجود أيضًا في كل صف). بديل لـ locations.

مثال:
company_locations
string[]

موقع مقر الشركة. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
companies
string<uuid>[]

قائمة من معرّفات فريدة (domain_search_id) تُستخدَم لعمليات البحث عن شركات وأشخاص.

domains
string[]

قائمة نطاقات شركات تُستخدَم لعمليات البحث عن شركات وأشخاص. إن استلمنا رابطًا مثل www.pubrio.com أو https://docs.pubrio.com/، سيحوّله النظام إلى pubrio.com للمعالجة.

مثال:
linkedin_urls
string[]

الرابط الكامل لملف شركة على LinkedIn. يبدأ الرابط بـhttp ويحتوي linkedin.com/company/

مثال:
search_term
string

سلسلة من الكلمات نريد تصفية النتائج بها.

مثال:

"pubrio"

search_terms
string[]

مصفوفة من كلمات مفتاحية لتصفية إعلانات الوظائف. تُطابَق كل عبارة مقابل محتوى الوظيفة. استخدم search_term لعبارة واحدة أو search_terms لعدة كلمات مفتاحية.

مثال:
titles
string[]

المسميات الوظيفية المرتبطة بالأفراد الذين تهدف إلى تحديدهم.

ستشمل النتائج أيضًا مسميات وظيفية تحتوي مصطلحات مشابهة، حتى لو لم تطابق تمامًا. مثلًا، البحث عن software engineer قد يُظهر نتائج لأفراد بمسمى senior software engineer.

مثال:
functions
string[]

أسماء الوظائف الأساسية القياسية المشتقة من المسمى، مثل engineering، sales، marketing، finance، product_management — نفس القيم التي تُعيدها الصفوف في functions. الأسماء القياسية غير المعروفة لا تطابق شيئًا. القائمة الكاملة: التعدادات والثوابت.

مثال:
seniority_ranks
enum<integer>[]

فئة الأقدمية من المسمى: 1 مبتدئ، 2 خبير، 3 مدير، 4 مدير تنفيذي، 5 قيادة عليا. تُتجاهَل القيم خارج النطاق 1-5 ويُسقَط المرشح. تُعيد الصفوف فئتها في seniority_rank (0 = غير مصنَّف).

الخيارات المتاحة:
1,
2,
3,
4,
5
مثال:
posted_dates
string[]

نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك.

مثال:
launch_dates
string<date>[]

نافذة [من, إلى] شاملة (UTC) على تاريخ الإطلاق: posting_date، أو يوم الاستيعاب عند غيابه. يطابق كيفية احتساب رؤى الوظائف. التاريخ الواحد يطابق ذلك اليوم.

Required array length: 1 - 2 elements
مثال:
created_at
string<date-time>

استُوعِب عند هذه اللحظة أو بعدها (UTC). تاريخ أو طابع زمني ISO. للمزامنات التزايدية مرّر created_at لأحدث صف مخزَّن لديك.

مثال:

"2026-09-02T12:00:00Z"

is_realtime_enrichment
boolean
افتراضي:false

فعّل الإثراء في الوقت الفعلي لاستعلام واحد محدَّد النطاق بشركة (مصفّى بـdomain_search_id أو domains أو linkedin_urls). عندما يُعيد البحث الأولي صفر نتائج، تجمع النقطة الطرفية بيانات من المصدر، وتحفظ السجلات، وتعيد تشغيل البحث قبل الاستجابة. خاضع لموعد نهائي لكل مسار.

مثال:

true

is_ascending_order
boolean
افتراضي:false

اتجاه الترتيب. تُعاد النتائج بترتيب الأحدث أولًا افتراضيًا؛ اضبط true للأقدم أولًا. لا يوجد sort_by في هذه النقطة الطرفية — مفتاح الترتيب ثابت ومذكور في وصف النقطة الطرفية.

مثال:

false

per_page
integer
افتراضي:25

السجلات لكل صفحة. القيمة الافتراضية 25، وهي أيضًا السقف في معظم الخطط — الحد هو max_search_per_page الخاص باشتراكك، الذي تُعيده Profile. تجاوزه يُعيد HTTP 416 برمز 41676 (أو 41613 في بحث الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة.

النطاق المطلوب: x <= 25
مثال:

25

page
integer
افتراضي:1

رقم الصفحة، بدءًا من 1. السقف هو max_search_page الخاص باشتراكك (max_company_search_page لبحث الشركات)، الذي تُعيده Profile. تجاوزه يُعيد HTTP 416.

مثال:

1

الاستجابة

استجابة ناجحة تحتوي على تفاصيل بحث وظائف الشركة.

metadata
object

سياق الطلب.

data
object
آخر تعديل في ٤ سبتمبر ٢٠٢٦