جلب متقدّم هي GET على /linkedin/v2/{account_id}/linkedin/jobs/{job_id}/applicants/{applicant_id}، ضمن عائلة linkedin في Top-Rated Team API. كل طلب يحمل مفتاحك أنت في ترويسة X-API-KEY؛ والمفتاح هو ما يحدد أي مؤسسة أنت، وبالتالي أي حسابات LinkedIn يحق لك ذكرها.
هذه العائلة تمرر الطلب إلى سطح LinkedIn نفسه، فالذي يعود يأخذ شكله من LinkedIn لا منا.
الطلب
curl -X GET "https://top-rated.team/linkedin/v2/$ACCOUNT_ID/linkedin/jobs/$JOB_ID/applicants/$APPLICANT_ID" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
ما يوضع في المسار
- account_id — حساب LinkedIn المتصل الذي ستتصرف باسمه. يجب أن يكون حسابًا ربطه مفتاحك أنت؛ وأي معرّف آخر يُجاب بـ 404.
- job_id — معرّف أعاده استدعاء سابق من هذه العائلة.
- applicant_id — معرّف أعاده استدعاء سابق من هذه العائلة.
ما يعود حين لا تنجح
- 401 — المفتاح ناقص أو خاطئ أو مُلغى.
- 402 — الخطة غير مدفوعة. تجيب خدمة Top-Rated Team API بهذا بعد انتهاء التجربة.
- 404 — إما أن الشيء غير موجود، وإما أن معرّف الحساب ليس لك. الجوابان متطابقان عن قصد، حتى لا تُستكشَف المعرّفات.
- 429 — طلبات أكثر من اللازم، أو LinkedIn يكبح الحساب. الانتظار وحده هو الحل؛ وإعادة المحاولة مبكرًا تطيل المدة.
- 503 — LinkedIn، أو القفزة التي قبله، لم يجب. ويحمل الجسم رمز الحالة المجرد كما رآه.
كل خطأ هو JSON بالشكل نفسه: {"type":"errors/<code>","status":<n>,"detail":"..."} — فمعالج واحد يغطيها جميعًا، وحقل detail مكتوب ليُعرض على إنسان.
اطلبها من مساعد بدلًا من ذلك
هذه العملية أداة MCP أيضًا. الصق https://top-rated.team/linkedin/mcp/<مفتاح الواجهة الخاص بك> في Claude أو ChatGPT أو أي مساعد يتكلم MCP، واطلب ما تريد بلغة عادية — فيختار المساعد الاستدعاء، ويملأ المعرّفات، ويقرأ لك الجواب. لا شيء يُثبَّت.
في غرفة مشروع
في غرفة مشروع، حدِّد Top-Rated Team تحت «يمكنه استخدام» لوكيل ذكاء اصطناعي خاص بك، فيستدعي «جلب متقدّم» أداةً كلما احتاجت المحادثة إلى ذلك، على حسابات LinkedIn التي ربطتها مؤسستك. ويرى كل من في الغرفة ما طلبه وما عاد به. اسأل بكلمات عادية؛ واسم الوكيل هنا @scout:
أسئلة شائعة
هل يستطيع وكيل ذكاء اصطناعي أن يستدعي «جلب متقدّم» نيابةً عني؟
نعم. يستطيع ذلك أي مساعد يتكلم MCP، عبر العنوان أعلاه، ويستطيعه كذلك وكيل ذكاء اصطناعي خاص بك في غرفة مشروع حُدِّد له Top-Rated Team. أما الوكلاء المدمجون في الغرفة فلا يستطيعون: فهم ينصحون ولا يحملون مفتاح LinkedIn الخاص بك.
هل يعمل خارج الغرفة، من كودي أنا؟
نعم. الطلب أعلاه هو العملية نفسها التي تستدعيها أدوات وكيل الذكاء الاصطناعي، بالجواب نفسه وبالأخطاء نفسها. ومفتاحك هو ما يحدد حسابات LinkedIn التي يحق له ذكرها، أيًّا كانت الطريقة التي تدخل بها.
هل يعمل في غرفة بعلامتي التجارية؟
نعم. على عنوان العلامة البيضاء تُدرَج الأداة باسم منتجك، وتصل إلى الحسابات نفسها بالقواعد نفسها.
في أي خطة
Top-Rated Team API، على /linkedin. تسعة دولارات لكل حساب LinkedIn متصل شهريًا، وسبعة ابتداءً من مئة حساب، مع تجربة 30 يومًا لحساب واحد.