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

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 يومًا. يستخدم مؤشر new_transitions_30d دائمًا نافذته الثابتة الخاصة من 30 يومًا بصرف النظر عن هذا النطاق.

مثال:
window_days
integer

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

مثال:

90

min_markets
integer

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

مثال:

3

home_country_code
string[]

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

مثال:
industries
string[]

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

مثال:
exclude_industries
string[]

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

مثال:
select_size
integer

الحد الأقصى للأسواق المُعادة (محدود حسب الخطة).

مثال:

250

flows_size
integer

الحد الأقصى للتدفقات العابرة للحدود المُعادة (محدود حسب الخطة).

مثال:

50

is_include_metadata
boolean

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

مثال:

true

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

مثال:

true

الاستجابة

تجميعات لوحة تحكم السوق.

metadata
object
data
object

حاوية لوحة التحكم: أسواق مرتبة بالإضافة إلى أهم تدفقات الممرات. مرآة قديمة مهجورة. يُصدَر أيضًا كل حاوية داخل data في المستوى الأعلى (countries، top_flows، picks_aggregate، watchlist_markets، watchlist_timeline) للعملاء الأقدم. اقرأها من data — ستُزال النسخ في المستوى الأعلى.