ابنِ مع Seller Niche API
ادمج بيانات منتجات Amazon، AI إنشاء المحتوى وتحليلات المبيعات مباشرة في سير عملك. REST API بسيط، توثيق كامل، مثال للكود جاهز للتشغيل.
جميع طلبات API تتطلب مفتاح API في رأس Authorization. احصل على مفتاحك من لوحة التحكم ← الإعدادات ← API.
Authorization: Bearer <span class="tok-str">YOUR_API_KEY</span> Content-Type: <span class="tok-str">application/json</span>
⚠️ لا تشارك مفاتيح API في الكود العام. استخدم متغيرات البيئة دائماً.
https://sellerniche.com/api/v1الحد يومي ويُحتسب لكل حساب. عند تجاوزه ترجع الاستجابة برمز 429 مع الحقول limit وused وresetsAt (وقت إعادة الضبط بصيغة ISO).
| الخطة | الطلبات/يوم | الحد الفوري | إعادة الضبط |
|---|---|---|---|
| Free | — | — | — |
| Starter | 100/day | — | Daily |
| Pro | 500/day | — | Daily |
| Business | 2,000/day | — | Daily |
| Agency | 10,000/day | — | Daily |
/api/v1/search| الاسم | المكان | الوصف |
|---|---|---|
keyword string | query required | Search term (e.g. yoga mat) |
marketplace string | query optional | Amazon domain, e.g. amazon.com (default), amazon.co.uk, amazon.de |
page integer | query optional | Result page, default 1 |
{
"success": true,
"data": {
"keyword": "yoga mat",
"marketplace": "amazon.com",
"page": 1,
"totalResults": 20,
"nicheScore": { "score": 54, "demand": 61, "competition": 48, "opportunity": 52 },
"products": [
{
"asin": "B01LP0V4JY",
"title": "Extra Thick Yoga Mat 1/2 inch",
"brand": "Gaiam",
"category": "Sports & Outdoors",
"imageUrl": "https://m.media-amazon.com/images/I/71abc.jpg",
"price": 24.98,
"bsr": 1204,
"monthlySales": 8400,
"reviewCount": 38421,
"rating": 4.6
}
]
},
"meta": { "timestamp": "2026-07-29T10:00:00.000Z" }
}curl "https://sellerniche.com/api/v1/search?keyword=yoga+mat&marketplace=amazon.com" \ -H "Authorization: Bearer YOUR_API_KEY"
| الرمز | المعنى | الحل |
|---|---|---|
400 | Bad Request | تحقق من المعاملات |
401 | Unauthorized | تحقق من مفتاح API |
403 | Plan limit | ارقِّ خطتك |
429 | Rate limited | انتظر حتى إعادة الضبط |
500 | Server Error | تواصل مع الدعم |
اشترك في الأحداث الفورية — لا حاجة للاستطلاع. أضف عنوان webhook من لوحة التحكم ← Zapier (أو عبر POST /api/zapier/webhooks).
bsr_dropkeyword_rank_changenew_reviewprice_changealert_triggeredlow_stockلا توجد حزمة SDK رسمية بعد. الواجهة REST عادية مع رأس Bearer، لذا تعمل مقتطفات requests / fetch أعلاه كما هي — انسخها والصقها مباشرة.
تحتاج إلى حدود مخصصة، endpoint مخصص أو اتفاقية SLA؟ فريقنا الهندسي يعمل مباشرة معك.