البحث
ابحث عن المنتجات أو حلّل رابطًا ملصوقًا من منصة تسوق.
يتطلب GET /api/v1/search رمز bearer. يستخدم منطق البحث نفسه المستخدم في المتجر والتطبيق، دون تسجيل سجل العميل أو الزيارات.
curl --get https://www.ninjabuy.com/api/v1/search \
-H "Authorization: Bearer $NINJABUY_ACCESS_TOKEN" \
--data-urlencode "q=hoodie" \
--data-urlencode "provider=taobao" \
--data-urlencode "page=0"معاملات الاستعلام
| المعامل | القواعد |
|---|---|
q | مطلوب، وتُحذف المسافات من طرفيه. الكلمات المفتاحية: من 2 إلى 120 حرفًا. الروابط الملصوقة: حتى 2,048 حرفًا. |
provider | taobao (الافتراضي) أو a1688. |
page | عدد صحيح يبدأ من الصفر، من 0 إلى 20؛ القيمة الافتراضية 0. |
أرسل كل معامل مرة واحدة فقط. المعاملات غير الصالحة أو المكررة تُرجع 400 مع المشكلة bad-body.
أنواع الإجابات
تحتوي كل إجابة ناجحة على kind وrequest_id.
kind | الحقول ومعناها |
|---|---|
products | نتائج الكلمات المفتاحية: items وpage وpageSize وtotalCount وmaximumPageCount وunread (كائن يحتوي على المضيف لرابط ملصوق لم تتم قراءته، وإلا null). |
product | منتج واحد: handle وurl في المتجر. قد يؤدي رابط ملصوق أو بحث بمعرّف المنتج إلى هذا النوع مباشرةً. |
vendor | متجر تم تحليله: vendor. |
sheet | جدول Google Sheets تم التعرف عليه: sheetId وgid الذي قد يكون null؛ دون محتوى الجدول. |
unsupported | رابط تم التعرف عليه لكنه غير مدعوم: link يحتوي على marketplace وid. |
يحتوي كل عنصر في products على handle وurl في المتجر وtitle وprice: { amount, currency: "CNY" } وimage (قد يكون null) وmarketplace (taobao أو a1688). amount سلسلة عشرية باليوان الصيني، مطابقة لشبكة المنتجات في المتجر. روابط البحث هي روابط منتجات عادية؛ استخدم الروابط لإنشاء روابط تُنسب إليك.
الاستهلاك وحدود المعدل
تستخدم الروابط الملصوقة المحلّل المجهول ولا يمكنها شراء خدمة فك الحظر المدفوعة من Bright Data. روابط المنتجات والمتاجر والجداول والروابط غير المدعومة التي يتم التعرف عليها تتخطى البحث بالكلمات المفتاحية. أما الرابط الملصوق الذي لم تتم قراءته فقد يتحول إلى بحث بالكلمات المفتاحية ويستهلك حصة بحث OT.
لعمليات البحث بالكلمات المفتاحية حد خاص بها يبلغ 30 استدعاءً لكل حساب كل 60 ثانية، منفصل عن استدعاءات إنشاء الروابط. الإجابات الناجحة التي تصل إلى مرحلة قبول البحث بالكلمات المفتاحية، وحالات الرفض بسبب حد البحث، تحمل:
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60يُرجع الرفض 429 والمشكلة search-rate-limited وRetry-After بالثواني. الروابط الملصوقة التي تم تحليلها لا تستهلك أيًّا من النافذتين ولا تحمل ترويسات حد البحث. تحمل كل إجابة X-Request-Id وCache-Control: no-store. راجع حدود المعدل لمعرفة حقول الترويسات.