Skip to main content
POST
البحث عن شركات

التفويضات

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

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

الجسم

application/json
company_name
string

صفِّ نتائج البحث لتشمل اسم شركة محدد.

إن لم تطابق القيمة التي تدخلها لهذا المعامل اسم شركة، لن تظهر الشركة في نتائج البحث، حتى إن طابقت معاملات أخرى. تُقبل المطابقات الجزئية.

مثال:

"pubrio"

companies
string<uuid>[]

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

company_groups
integer[]

قصر النتائج على أعضاء مجموعات الشركات هذه (المعرّفات)، مثل source_group_id أو excluded_group_id للمونيتور؛ مقسّمة إلى صفحات كأي بحث.

domains
string[]

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

مثال:
linkedin_urls
string[]

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

مثال:
company_filters
object

كائن غلاف للمرشحات على مستوى الشركة. تجميع موصى به يفصل بصريًا المفاتيح التي تصفّي الشخص (المستوى الأعلى) عن تلك التي تصفّي الشركة. يقبل نفس مفاتيح مرشحات الشركة في المستوى الأعلى (مثل 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 للأمثلة.

مثال:
locations
string[]

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

مثال:
exclude_locations
string[]

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

مثال:
places
string[]

أسماء أماكن (مدينة، منطقة) تُستخدَم لتصفية النتائج. تقبل أسماء أماكن محلية أو إنجليزية.

مثال:
exclude_places
string[]

أسماء أماكن (مدينة، منطقة) مستبعدة من النتائج. تقبل أسماء أماكن محلية أو إنجليزية.

مثال:
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.

مثال:
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"].

categories
integer[]

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

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

technologies
integer[]

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

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

اسم المنتج الموجود في قائمة التقنيات يطابق ذلك المنتج ومنتجاته الخاصة ("Salesforce" يطابق أيضًا Salesforce Desk وSalesforce Service Cloud)، ولا يطابق المنتجات المشابهة؛ أما النص الآخر فيُطابَق حسب التشابه.

exclude_technologies
string[]

التقنيات التي يجب ألا تستخدمها الشركة، على شكل tag_id أو، مع is_enable_similarity_search، أسماء مثل ["Shopify"]. تبقى الشركة التي لا تُعرف لها أي تقنية.

مثال:
employees
string[][]

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

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

مثال:
revenues
integer[]

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

مثال:
founded_dates
integer[]

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

مثال:
keywords
string[]

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

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

شركات لديها ملف على أي من: linkedin، facebook، instagram، tiktok، twitter، x، github، wantedly، rocketpunch. ارفعه إلى AND بـ filter_conditions.

الخيارات المتاحة:
linkedin,
facebook,
instagram,
tiktok,
twitter,
x,
github,
wantedly,
rocketpunch
مثال:
news_categories
string[]

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

مثال:
news_published_dates
string[]

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

مثال:
advertisement_search_terms
string[]

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

مثال:
advertisement_target_locations
string[]

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

مثال:
advertisement_exclude_target_locations
string[]

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

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

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

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

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

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

اعثر على إعلانات كانت نشطة في أي لحظة خلال نطاق التاريخ هذا (قائم على التداخل: يشمل إعلانات بدأت قبل النطاق ولا تزال نشطة، لا الإعلانات التي بدأت ضمنه فقط).

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

currently_running: شركات لديها إعلانات مسجَّلة. active_last_30_min: شركات تغيّرت إعلاناتها خلال آخر 30 دقيقة.

الخيارات المتاحة:
currently_running,
active_last_30_min
مثال:
advertisement_headlines
string[]

كلمات مفتاحية للبحث ضمن نص عنوان الإعلان.

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

صفِّ حسب مكتبة الإعلانات التي جاء منها الإعلان. أحرف صغيرة، غير حساسة لحالة الأحرف. تُقبل meta كاسم بديل لـ facebook.

الخيارات المتاحة:
linkedin,
facebook,
google,
tiktok,
apple
مثال:
advertisement_publisher_platforms
enum<string>[]

صفِّ إعلانات Facebook/Meta حسب سطح المنصة الذي عُرضت عليه. أحرف صغيرة وغير حساسة لحالة الأحرف. يُطبَّق فقط على مصدر facebook (المصادر الأخرى منصة واحدة).

الخيارات المتاحة:
facebook,
instagram,
messenger,
threads,
audience_network
مثال:
advertisement_exclude_publisher_platforms
enum<string>[]

استبعد إعلانات Facebook/Meta المعروضة على أسطح المنصات هذه.

الخيارات المتاحة:
facebook,
instagram,
messenger,
threads,
audience_network
مثال:
advertisement_formats
enum<string>[]

اعثر على شركات لديها إعلان واحد على الأقل بأي من هذه الصيغ الإبداعية.

الخيارات المتاحة:
image,
video,
text,
carousel,
dynamic_product,
document,
message,
event,
article,
spotlight,
follow,
job,
engagement
مثال:
advertisement_active_ads
(integer | null)[]

الحد الأدنى والأقصى لعدد إعلانات الشركة النشطة حاليًا، عبر كل الدول. استخدم null لحد مفتوح، مثل [1, null] لـ "إعلان نشط واحد على الأقل".

Required array length: 2 elements
مثال:
advertisement_running_ads
(integer | null)[]

الحد الأدنى والأقصى لعدد إعلانات الشركة التي لا تزال تعمل (دون تاريخ انتهاء، أو بتاريخ انتهاء في المستقبل). مُعبَّأ حاليًا لإعلانات LinkedIn فقط.

Required array length: 2 elements
مثال:
advertisement_total_ads
(integer | null)[]

الحد الأدنى والأقصى لإجمالي عدد إعلانات الشركة المسجَّلة على الإطلاق، عبر كل الدول.

Required array length: 2 elements
مثال:
advertisement_platform_count
(integer | null)[]

الحد الأدنى والأقصى لعدد منصات الإعلان المميزة (linkedin، facebook، google، tiktok، apple) التي تعلن الشركة عليها بنشاط.

Required array length: 2 elements
مثال:
advertisement_format_count
(integer | null)[]

الحد الأدنى والأقصى لعدد صيغ المحتوى الإبداعي الإعلاني المميزة التي تديرها الشركة بنشاط.

Required array length: 2 elements
مثال:
advertisement_impressions_estimate
(integer | null)[]

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

Required array length: 2 elements
مثال:
advertisement_country_activity
object

النشاط الإعلاني لدولة واحدة محددة. country مطلوب، ويجب ضبط حقل واحد آخر على الأقل (الدولة وحدها لا تطابق شيئًا). لإجمالي عبر كل الدول بدلًا من ذلك، استخدم مرشحات advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate في المستوى الأعلى.

مثال:
sort_by
enum<string>

ترتيب النتائج. اتركه فارغًا لترتيب الصلة الافتراضي. يرتّب advertisement_country_rank حسب الترتيب الإعلاني للشركة داخل الدولة المحدَّدة في advertisement_country_activity (الترتيب 1 = أكبر معلن في ذلك السوق)، ويُتجاهَل ما لم يكن ذلك الفلتر موجودًا. اقرنه بـ is_ascending_order: false لسرد أصغر المعلنين أولًا. غير متاح بعد: name (في كلا الاتجاهين) وrelevance مع is_ascending_order: false — تنتهي مهلة هذه الطلبات. استخدم بدلًا من ذلك ترتيب الصلة الافتراضي أو number_of_employees أو founded_year.

الخيارات المتاحة:
relevance,
name,
number_of_employees,
founded_year,
advertisement_country_rank
مثال:

"advertisement_country_rank"

is_ascending_order
boolean

اتجاه sort_by. القيمة الافتراضية تصاعديًا، وهو ما يعني بالنسبة إلى advertisement_country_rank أكبر المعلنين أولًا.

مثال:

true

filter_conditions
object[]

خيارات تصفية متقدمة لعمليات البحث عن الشركات. حدّد شروطًا تجمع بين مفاتيح وعوامل منطقية لتحسين نتائج البحث.

عند التفعيل، يمكن ملء المرشحات المذكورة أعلاه التي تدعم بحث التشابه بنص حر لمعرّفات محددة.

similarity_score
number<float>

يُستخدَم مع is_enable_similarity_search. يُستخدَم هذا الرقم لتحليل ما إذا كان اسم قياسي محدد (مثل قطاع صناعي، تقنية) مشابهًا لمدخل المستخدم، وكلما زاد الرقم، زادت الصرامة.

مثال:

0.7

query
string

بحث باللغة الطبيعية. عند توفيره، يحوّله Pubrio إلى عوامل تصفية الشركات أدناه: القطاع (والقطاعات المستبعدة)، والتخصص، والتقنية (والأدوات المستبعدة)، والحسابات على وسائل التواصل الاجتماعي، ودولة المقر أو منطقته أو مدينته، وعدد الموظفين، والإيرادات، وسنة التأسيس، والوظائف التي يجري التوظيف لها ومكانها، والأحداث الإخبارية مثل "توسعت مؤخرًا"، والإعلانات (المنصة، والصيغة، والدولة المستهدفة، وعدد الإعلانات، ومرات الظهور، والتواريخ، والترتيب في دولة واحدة)، والاستضافة السحابية (المزوّد، ودول الخوادم ومدنها، وعدد المضيفات والخوادم، إجمالًا أو في دولة واحدة). القيم المرتبطة بـ "أو" تطابق أيًّا منها؛ أما الأدوات أو الحسابات المرتبطة بـ "و" ("تستخدم Salesforce وHubSpot معًا") فيجب أن تتطابق كلها. تكون لعوامل التصفية الصريحة التي ترسلها الأولوية على ما تم تفسيره. أي جزء من الجملة لا يمكن لأي عامل تصفية التعبير عنه (مثل الملكية) يُعاد في metadata.unmatched_criteria بدلًا من تجاهله، والجملة التي لا تحتوي على أي شيء قابل للبحث تُعيد نتائج فارغة مع metadata.nl_no_intent: true.

مثال:

"Food & Beverage companies in Singapore that recently expanded"

exclude_fields
string[]

قائمة الحقول المستبعدة من حمولة الاستجابة.

مثال:
is_parameter_metadata_available
boolean

يشير إلى ما إذا كانت بيانات المعامل الوصفية متاحة للطلب.

is_profile_metadata_available
boolean

يشير إلى ما إذا كانت بيانات الملف الشخصي الوصفية متاحة للطلب.

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

cloud_footprint_providers
string[]

الشركات التي تستخدم أيًا من هؤلاء المزوّدين في أي مكان. providers بدون بادئة يضيّق السجلات، وهذا يضيّق الشركات.

مثال:
cloud_footprint_exclude_providers
string[]

استبعد السجلات المطابقة لهذه مزوّدي السحابة أو الاستضافة. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
cloud_footprint_target_locations
string[]

الشركات الموجودة في أي من هذه الدول ضمن أي جزء من بصمتها.

مثال:
cloud_footprint_exclude_target_locations
string[]

استبعد السجلات المطابقة لهذه رموز الدول التي توجد بها البنية التحتية.

مثال:
cloud_footprint_cloud_regions
string[]

اقتصر على السجلات المطابقة لهذه المناطق السحابية. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
cloud_footprint_exclude_cloud_regions
string[]

استبعد السجلات المطابقة لهذه المناطق السحابية. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
cloud_footprint_cities
string[]

اقتصر على السجلات المطابقة لهذه المدن. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
cloud_footprint_exclude_cities
string[]

استبعد السجلات المطابقة لهذه المدن. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
cloud_footprint_first_seen_dates
(string | null)[]

تاريخان بصيغة ISO 8601 (YYYY-MM-DD) يحددان فترة أول رصد لها البصمة. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

Required array length: 2 elements
مثال:
cloud_footprint_last_seen_dates
(string | null)[]

تاريخان بصيغة ISO 8601 (YYYY-MM-DD) يحددان فترة آخر رصد لها البصمة. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

Required array length: 2 elements
مثال:
cloud_footprint_is_cross_border_only
boolean

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

مثال:

true

cloud_footprint_host_count
(integer | null)[]

الحد الأدنى والأقصى لـ المضيفات. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_server_count
(integer | null)[]

الحد الأدنى والأقصى لـ الخوادم (عناوين IP مميزة). استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_shared_server_count
(integer | null)[]

الحد الأدنى والأقصى لـ الخوادم المشتركة مع شركات أخرى. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_provider_count
(integer | null)[]

الحد الأدنى والأقصى لـ المزوّدين المختلفين لدى الشركة. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_country_count
(integer | null)[]

الحد الأدنى والأقصى لـ الدول التي تستضيف بها الشركة. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_cross_border_country_count
(integer | null)[]

الحد الأدنى والأقصى لـ الدول خارج السوق المحلية للشركة. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_region_count
(integer | null)[]

الحد الأدنى والأقصى لـ المناطق السحابية. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_city_count
(integer | null)[]

الحد الأدنى والأقصى لـ المدن. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_primary_provider
string[]

الشركات التي يكون أكبر مزوّد لديها أحد هؤلاء.

مثال:
cloud_footprint_country_activity
object

حدود مقصورة على دولة واحدة: {"country":"DE","host_count":[100,null]} يجد الشركات التي تشغّل 100 مضيف أو أكثر في ألمانيا تحديدًا. أما cloud_footprint_host_count المجرّد فهو إجمالي الشركة عبر كل الدول، لذا لا يعبّران عن ذلك معًا. ويُرفض country وحده.

الاستجابة

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

metadata
object

سياق الطلب: recent_search_log_identifier، وparameters وfilters المُعادة، وكتلة أرصدة profile اختيارية، وignored_fields (مفاتيح جسم الطلب التي تجاهلتها النقطة الطرفية).

data
object | null

تعتمد معلومات الاستجابة على النقطة الطرفية المحددة.

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