Arama
Ürün arayın veya yapıştırılmış bir pazaryeri bağlantısını çözümleyin.
GET /api/v1/search, bearer belirteci gerektirir. Müşteri veya ziyaret geçmişi yazmadan, web sitesi ve uygulamayla aynı arama kararını kullanır.
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"Sorgu parametreleri
| Parametre | Kurallar |
|---|---|
q | Zorunlu; baştaki ve sondaki boşluklar temizlenir. Anahtar sözcükler: 2 ile 120 karakter. Yapıştırılmış bağlantılar: en fazla 2.048 karakter. |
provider | taobao (varsayılan) veya a1688. |
page | 0 ile 20 arasında, sıfırdan başlayan tam sayı; varsayılan 0. |
Her parametreyi bir kez gönderin. Geçersiz veya yinelenen parametreler, bad-body sorunuyla 400 döndürür.
Yanıt türleri
Her başarılı yanıtta kind ve request_id bulunur.
kind | Alanlar ve anlamı |
|---|---|
products | Anahtar sözcük sonuçları: items, page, pageSize, totalCount, maximumPageCount ve unread (okunamayan bir yapıştırma için host nesnesi; diğer durumlarda null). |
product | Tek ürün: handle ve mağaza url değeri. Yapıştırılmış bir bağlantı veya ürün kimliği araması doğrudan bu türe çözümlenebilir. |
vendor | Çözümlenmiş mağaza: vendor. |
sheet | Tanınan Google Sheet: sheetId ve null olabilen gid; tablo içeriği yoktur. |
unsupported | Tanınan ancak desteklenmeyen bağlantı: marketplace ve id içeren link. |
products içindeki her öğe handle, mağaza url değeri, title, price: { amount, currency: "CNY" }, null olabilen image ve marketplace (taobao veya a1688) içerir. amount, web sitesindeki ürün ızgarasıyla aynı biçimde, Çin yuanı cinsinden ondalık bir dizedir. Arama URL'leri sıradan ürün URL'leridir; hesabınıza atfedilen bağlantılar oluşturmak için Bağlantılar sayfasını kullanın.
Harcama ve istek sınırları
Yapıştırılmış bağlantılar anonim çözümleyiciyi kullanır ve ücretli Bright Data engel kaldırma hizmeti satın alamaz. Tanınan ürün, mağaza, tablo ve desteklenmeyen bağlantılar anahtar sözcük aramasını atlar. Okunamayan bir yapıştırma anahtar sözcük aramasına geçip OT arama kotası tüketebilir.
Anahtar sözcük aramalarının, bağlantı oluşturma çağrılarından ayrı, hesap başına 60 saniyede 30 çağrılık kendi sınırı vardır. Anahtar sözcük kabul aşamasına ulaşan başarılı yanıtlar ve arama sınırı nedeniyle reddedilenler şunları içerir:
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60Reddedilen istek, 429, search-rate-limited sorunu ve saniye cinsinden Retry-After döndürür. Çözümlenmiş yapıştırmalar iki pencereyi de tüketmez ve arama sınırı başlıklarını içermez. Her yanıt X-Request-Id ve Cache-Control: no-store içerir. Başlık alanları için İstek sınırları sayfasına bakın.