Skip to main content
POST
البحث في التوسع

التفويضات

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

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

الجسم

application/json
froms
string[]
مطلوب

أسواق المنشأ (ISO 3166-1 alpha-2). من أين تتوسع شركة — دولها الأصلية/مقرها. استخدمها وحدها لإيجاد شركات تنمو خارج هذه الأسواق؛ اجمعها مع tos لممر محدد من→إلى.

مثال:
tos
string[]

الأسواق المستهدفة (ISO 3166-1 alpha-2). إلى أين تتوسع شركة. استخدمها وحدها لإيجاد كل شركة تدخل هذه الأسواق؛ اجمعها مع froms لممر محدد من→إلى.

مثال:
exclude_froms
string[]

أسواق المنشأ المستبعدة (ISO 3166-1 alpha-2).

مثال:
exclude_tos
string[]

الأسواق المستهدفة المستبعدة (ISO 3166-1 alpha-2).

مثال:
stages
enum<string>[]

القيم حساسة لحالة الأحرف ولا تُتحقَّق منها. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في stages وfreshness وscopes وmomentum يُسقَط المرشح بأكمله وتحصل على نتائج غير مصفّاة، بينما في signal_types وsignal_strengths يُطبَّق المرشح ولا يطابق شيئًا. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من مرجع التوسع وقارن data.pagination.total_entries مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة.

الخيارات المتاحة:
exploring,
committing,
expanding,
scaling
مثال:
momentum
enum<string>[]

مسار تحرك الشركة في السوق. advancing يعني كسب أرض، وsteady يعني الثبات، وpulling_back يغطي التراجع والانكماش.

لا تستخدم القيم من directions في مرجع التوسع هنا. تلك (advancing، steady، retreating، new) هي قيم الاستجابة التي تحصل عليها في stage.direction؛ فقط الثلاث المذكورة أعلاه مقبولة كمرشح. إرسال retreating أو new يعطّل المرشح بصمت ويُعيد نتائج غير مصفّاة.

الخيارات المتاحة:
advancing,
steady,
pulling_back
مثال:
freshness
enum<string>[]

القيم حساسة لحالة الأحرف ولا تُتحقَّق منها. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في stages وfreshness وscopes وmomentum يُسقَط المرشح بأكمله وتحصل على نتائج غير مصفّاة، بينما في signal_types وsignal_strengths يُطبَّق المرشح ولا يطابق شيئًا. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من مرجع التوسع وقارن data.pagination.total_entries مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة.

الخيارات المتاحة:
fresh,
cooling,
stale,
cold
مثال:
scopes
enum<string>[]

التصفية حسب نطاق دخول السوق.

الخيارات المتاحة:
entering_new_market,
expanding_within_presence,
established_only
مثال:
ahead_of_pace
boolean

التحديد للأزواج المتحركة أسرع من الوتيرة المعتادة لذلك السوق.

مثال:

false

signal_types
enum<string>[]

القيم حساسة لحالة الأحرف ولا تُتحقَّق منها. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في stages وfreshness وscopes وmomentum يُسقَط المرشح بأكمله وتحصل على نتائج غير مصفّاة، بينما في signal_types وsignal_strengths يُطبَّق المرشح ولا يطابق شيئًا. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من مرجع التوسع وقارن data.pagination.total_entries مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة.

الخيارات المتاحة:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
مثال:
signal_strengths
enum<string>[]

القيم حساسة لحالة الأحرف ولا تُتحقَّق منها. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في stages وfreshness وscopes وmomentum يُسقَط المرشح بأكمله وتحصل على نتائج غير مصفّاة، بينما في signal_types وsignal_strengths يُطبَّق المرشح ولا يطابق شيئًا. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من مرجع التوسع وقارن data.pagination.total_entries مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة.

الخيارات المتاحة:
low,
medium,
high,
very_high
مثال:
min_signal_count
integer

الحد الأدنى لعدد إشارات التوسع التي يجب أن تملكها شركة ضمن النافذة — "نشطة جدًا / بصمة ثقيلة".

مثال:

3

only_contraction
boolean

عند true، أعِد فقط التوسعات الموسومة بالانكماش (الشركات المتقلصة).

مثال:

false

min_markets
integer

الحد الأدنى لعدد الأسواق الجديدة التي يجب أن تكون شركة قد دخلتها ضمن النافذة.

مثال:

3

home_country_code
string[]

التصفية حسب دولة مقر الشركة (ISO 3166-1 alpha-2). تتقاطع مع froms عند توفير كليهما.

مثال:
industries
string[]

التصفية حسب اسم الصناعة (مطابقة نص حر).

مثال:
exclude_industries
string[]

الصناعات المستبعدة (مطابقة نص حر).

مثال:
verticals
integer[]

قائمة من vertical_id تُستخدَم للبحث عن شركات في قطاع أو صناعة محددة. لإيجاد المعرّف، استدعِ نقطة vertical تحت تبويب Filters.

يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["AI"].

vertical_categories
integer[]

قائمة من vertical_category_id تُستخدَم للبحث عن شركات في فئة قطاع محددة. لإيجاد المعرّف، استدعِ نقطة vertical category تحت تبويب Filters.

يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["Information Technology"].

vertical_sub_categories
integer[]

قائمة من vertical_sub_category_id تُستخدَم للبحث عن شركات في فئة فرعية محددة لقطاع. لإيجاد المعرّف، استدعِ نقطة vertical sub category تحت تبويب Filters.

يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["Software"].

technologies
integer[]

قائمة من tag_id تُستخدَم للبحث عن تقنيات محددة تستخدمها الشركات. لإيجاد المعرّف، استدعِ نقطة technology تحت تبويب Filters.

يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["Shopify"].

employees
string[][]

نطاق عدد الموظفين العاملين في الشركة. يتيح لك هذا إيجاد شركات بناءً على عدد الموظفين. يمكنك إضافة نطاقات متعددة لتوسيع نتائج بحثك.

راجع نقاط company size تحت تبويب Filters لمزيد من المعلومات.

مثال:
revenues
integer[]

الحد الأدنى والأقصى لنطاق إيرادات الشركة.

مثال:
founded_dates
integer[]

نطاق سنوات تأسيس الشركة. القيمة القصوى للتأسيس هي السنة الحالية.

مثال:
keywords
string[]

قائمة من الكلمات المفتاحية لتصفية الشركات حسب الصلة، أو التخصصات، أو الأوصاف.

مثال:
companies
string[]

التحديد لشركات محددة عبر أي مزيج من domain_search_id، أو نطاق الشركة، أو رابط ملف شركة على وسائل التواصل الاجتماعي. تُحل النطاقات والروابط إلى أفضل شركة مطابقة مرتبة.

مثال:
job_locations
string[]

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

مثال:
job_exclude_locations
string[]

المواقع الجغرافية المستبعدة من نتائج إعلانات الوظائف.

مثال:
job_posted_dates
string[]

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

مثال:
job_titles
string[]

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

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

مثال:
advertisement_target_locations
string[]

المواقع الجغرافية المستهدفة للإعلانات.

مثال:
advertisement_exclude_target_locations
string[]

المواقع الجغرافية المستبعدة من استهداف الإعلانات.

مثال:
advertisement_search_terms
string[]

كلمات مفتاحية تُستخدَم للبحث ضمن محتوى الإعلان أو عناوينه.

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

نطاق تاريخ البداية لتصفية الإعلانات.

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

نطاق تاريخ النهاية لتصفية الإعلانات.

مثال:
news_categories
string[]

قائمة من category slugs للبحث عن فئات أخبار محددة. لإيجاد اسم قياسي، استدعِ نقطة news categories تحت تبويب Filters.

مثال:
news_published_dates
string[]

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

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

نطاق تاريخ ISO لنافذة الجدول الزمني. الافتراضي آخر 90 يومًا. يمكن لاستعلام query بلغة طبيعية أيضًا ضبط هذا من عبارات تقويمية ("هذا العام"، "العام الماضي"، "الربع الثاني 2026").

مثال:
window_days
integer

اختياري. حجم النافذة المتحركة بالأيام. يُستخدَم عندما لا يُوفَّر نطاق transitioned_dates صريح؛ إن حُذف كلاهما، تُستخدَم نافذة افتراضية.

مثال:

90

query
string

استعلام بلغة طبيعية يفسّره Pubrio إلى مرشحات توسع + شركة.

مثال:

"fintech companies expanding into the UK"

is_explain_match
boolean

أدرِج تفسيرات مولَّدة بالذكاء الاصطناعي لسبب مطابقة كل شركة للبحث، مستندة إلى الإشارات الحقيقية للشركة. الأنسب مع استعلام بلغة طبيعية. يتناسب عدد الإشارات المُستشهَد بها وحجم الدفعة مع per_page؛ تُلخَّص المصادر عالية الحجم (إعلانات الوظائف، الحملات الإعلانية) كعدد محدَّد بنافذة (مثل "12 إعلان وظيفة") بدلًا من سردها فرديًا.

مثال:

true

sort_by
enum<string>

ترتيب النتائج. اتركه فارغًا لترتيب الصلة الافتراضي: الأزواج المدعَّمة أولًا (نوعا إشارة مميزان أو أكثر)، ثم أزواج الأدلة المتكررة (3 إشارات أو أكثر)، ثم البقية — الأحدث انتقالًا أولًا ضمن كل مستوى. recent — الحداثة الصرفة (الأحدث انتقالًا أولًا). expansion_score — أعلى درجة توسع أولًا. signal_count — أكثر إشارات في الزوج أولًا. company_ranking — ترتيب Pubrio الإجمالي للشركة (الأدنى أبرز)، تصاعديًا.

الخيارات المتاحة:
recent,
expansion_score,
signal_count,
company_ranking
مثال:

"expansion_score"

is_include_metadata
boolean

أعِد حمولة التفاصيل الكاملة. حركة مرور مفتاح API مختصرة افتراضيًا: تُحذَف كتلة model، وأرقام الثقة (stage.confidence في تفاصيل توسع الشركة، وconfidence_score في other_markets[] وفي markers[] الخاصة بالتصنيفات)، وحقول established_min / share_of_detected / has_known_office ما لم تكن هذه بقيمة true.

مثال:

true

page
integer
افتراضي:1

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

مثال:

1

per_page
integer
افتراضي:25

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

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

25

فعّل المطابقة بالنص الحر لـ verticals وvertical_categories وvertical_sub_categories وtechnologies؛ تُسقَط تلك المرشحات ما لم تكن هذه بقيمة true.

مثال:

true

الاستجابة

قائمة مرقّمة صفحيًا من الشركات المتوسعة في السوق (الأسواق). تعرض filters المعايير المطبَّقة (أو المفسَّرة من اللغة الطبيعية)؛ تتضمن كل شركة match_summary عندما تكون is_explain_match بقيمة true.

metadata
object

بيانات وصفية للبحث: المرشحات المطبَّقة فعليًا، بالإضافة إلى تجميع السوق (الإجمالي، النطاق الجغرافي، أهم المصادر/الوجهات/الصناعات، الجدول الزمني). تتضمن استجابات مفتاح API التجميع فقط عندما تكون is_include_metadata بقيمة true.

data
object

حاوية النتائج (غلاف البحث القياسي): قائمة الشركات بالإضافة إلى الترقيم الصفحي.

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