Skip to main content
POST
أحداث إشارات الشركة

التفويضات

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

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

الجسم

application/json
domain_search_id
string<uuid>
مطلوب

معرّف فريد لعملية البحث عن شركات.

signal_types
enum<string>[]

التحديد لأنواع إشارات محددة. راجع كتالوج أنواع الإشارات في قاعدة المعرفة للتعريفات والفئات (DNS وINFRA إشارات من الفئة المتميزة Premier).

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

اختياري. حدّد نطاق التغذية بسوق أجنبية واحدة أو أكثر (ISO 3166-1 alpha-2، مثل ["JP","SG"]). عند الحذف ← كل الأسواق الأجنبية (تُستبعَد دولة المقر دائمًا).

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

نطاق تاريخ ISO [من, إلى] لنافذة الإشارة/الانتقال. له الأولوية على window_days عند توفير كليهما.

مثال:
window_days
integer
افتراضي:90

اختياري. حجم نافذة الأحداث المتحركة بالأيام. الافتراضي 90 (نافذة العرض القياسية) عندما لا يُوفَّر هذا ولا transitioned_dates. لـ transitioned_dates الأولوية عند إرسال كليهما.

مثال:

90

query
string

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

مثال:

"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."

is_explain_match
boolean

عند true وتوفير query، تُعيد data.summary ملخصًا واحدًا بالذكاء الاصطناعي لنشاط توسع هذه الشركة مقروءًا مقابل query الخاص بك، مستندًا إلى إشارات الشركة الحقيقية باستشهادات [n]. بخلاف match_summary لكل شركة في بحث الشركات، يُبنى هذا الملخص من تغذية الشركة الكاملة للنافذة (كل الأسواق، كل إشارة)، لذا فهو ثابت بصرف النظر عن page / per_page.

مثال:

true

domain
string

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

مثال:

"pubrio.com"

linkedin_url
string

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

مثال:

"https://www.linkedin.com/company/pubrio"

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

الاستجابة

أحداث إشارات مرقّمة صفحيًا. عندما تكون is_explain_match بقيمة true ويُوفَّر query، تحمل data.summary ملخصًا بالذكاء الاصطناعي ({ text, citations }) لنشاط تغذية الشركة الكاملة مقروءًا مقابل الاستعلام؛ null خلاف ذلك.

metadata
object
data
object

حاوية النتائج.

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