Αναζήτηση
Αναζητήστε προϊόντα ή αναλύστε έναν επικολλημένο σύνδεσμο πλατφόρμας αγορών.
Το 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 (αντικείμενο host για μη αναγνώσιμη επικόλληση, διαφορετικά null). |
product | Ένα προϊόν: handle και url του ιστότοπου. Ένας επικολλημένος σύνδεσμος ή αναζήτηση αναγνωριστικού προϊόντος μπορεί να καταλήξει απευθείας σε αυτό το είδος. |
vendor | Κατάστημα που αναγνωρίστηκε: vendor. |
sheet | Google Sheet που αναγνωρίστηκε: sheetId και gid που μπορεί να είναι null· χωρίς περιεχόμενο φύλλου. |
unsupported | Μη υποστηριζόμενος σύνδεσμος που αναγνωρίστηκε: link που περιέχει marketplace και id. |
Κάθε στοιχείο του products περιέχει handle, url του ιστότοπου, title, price: { amount, currency: "CNY" }, image που μπορεί να είναι null και marketplace (taobao ή a1688). Το amount είναι δεκαδική συμβολοσειρά σε κινεζικά γιουάν, όπως στο πλέγμα προϊόντων του ιστότοπου. Τα URL αναζήτησης είναι συνηθισμένα URL προϊόντων· χρησιμοποιήστε τους Συνδέσμους για να δημιουργήσετε συνδέσμους με απόδοση παραπομπών.
Κατανάλωση και όρια αιτημάτων
Οι επικολλημένοι σύνδεσμοι χρησιμοποιούν τον ανώνυμο μηχανισμό ανάλυσης και δεν μπορούν να αγοράσουν επί πληρωμή παράκαμψη αποκλεισμού 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. Δείτε τα Όρια αιτημάτων για τα πεδία κεφαλίδων.