1. Casa
  2. Docs
  3. Documentazione di amzpecty
  4. Specifiche API Amzpecty
  5. API delle informazioni sul venditore

API delle informazioni sul venditore

AGGIUNGI L'ID VENDITORE ALLA CODA DELLE RICHIESTE DI INFORMAZIONI SUL VENDITORE

La richiesta di aggiungere un ID venditore alla coda delle query sulle informazioni sul venditore.

DETRAZIONE DEL CREDITO

1 (uno) detrazione del credito dopo il recupero riuscito dei dati.

RICHIESTA
URI /api/query/seller/{ID VENDITORE}? dominio={dominio}&chiavesegreta={chiavesegreta} {SELLER ID} – obbligatorio – l'ID venditore del venditore target {domain} – facoltativo – il valore predefinito è www.amazon.com se non specificato. Vedere Domini Amazon supportati per lista.
Intestazione HTTP (facoltativa) AMZPECTY_CALLBACK_URL={Il tuo URL di richiamata}
Esempio /api/query/seller/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX
RISPOSTA
Headers
Tipo di supporto application / json
Dati JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerinfo",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03be54",
    "dateProcessed": null,
    "domain": null
}
INFORMAZIONI SUL VENDITORE QUERY CALLBACK DATI ESEMPIO JSON
Headers
Tipo di supporto application / json
Dati JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerinfo",
    "allowed": 4986,
    "dailyAllowed": 4986,
    "messageId": null,
    "message": null,
    "data": {
            "sellerId": "A3VHYG59GNVJVO",
            "sellerName": "CMDStore",
            "logoUrl": "https://images-na.ssl-images-amazon.com/images/I/419Udl8VRCL.png",
            "businessInfo": {
                "Business Name": "9103-6152 Quebec Inc",
                "Business Address": " 3940 Griffith St Montreal QC H4T1A7 CA",
                "other key": "other value"
            },
            "about": "CMDStore is committed to providing each customer with the highest standard of customer service.",
            "feedbackStar": 4.5,
            "productCount": 2000,
            "feedbackPositive30days": 91,
            "feedbackPositive90days": 95,
            "feedbackPositive12months": 96,
            "feedbackPositiveLifetime": 98,
            "feedbackNeutral30days": 4,
            "feedbackNeutral90days": 1,
            "feedbackNeutral12months": 1,
            "feedbackNeutralLifetime": 1,
            "feedbackNegative30days": 4,
            "feedbackNegative90days": 4,
            "feedbackNegative12months": 3,
            "feedbackNegativeLifetime": 1,
            "feedbackCount30days": 23,
            "feedbackCount90days": 75,
            "feedbackCount12months": 357,
            "feedbackCountLifetime": 13300
            },
   "rid": "60f12c1a0cf24280ed03be5e",
   "dateProcessed": 1626418203388,
   "domain": "www.amazon.com",
   "totalCreditsDeducted": 1
}
INFORMAZIONI SUL VENDITORE DOMANDA RISPOSTA RICHIAMATA ATTRIBUTI JSON
nome attributoDettagli
statusLo stato della richiesta.
rispostaperValore "sellerinfo" per il risultato della query sulle informazioni sul venditore.
permessoConteggio delle richieste attualmente consentite. Si ripristina mensilmente.
giornalieroConsentitoIl conteggio attuale delle richieste giornaliere consentite. Si ripristina quotidianamente.
ID messaggioL'ID del messaggio (se presente).
messaggioIl messaggio effettivo (se presente). Fare riferimento ai Messaggi di errore.
liberareL'ID della richiesta. Può essere utilizzato nella query Ottieni come chiave.
dominioIl dominio Amazon corrispondente al venditore.
crediti totali detrattiQuesto campo indica quanti crediti API Amzpecty sono stati utilizzati per soddisfare questa richiesta.
dataProcessedLa data in cui la richiesta è stata elaborata nel formato ora Unix.
dati.sellerIdL'ID del venditore.
data.nomevenditoreIl nome online del venditore.
dati.logoUrlL'URL del logo del venditore.
dati.businessInfoMappa delle coppie chiave-valore, ad es
Nome azienda=9103-6152 Quebec Inc
Indirizzo commerciale=558A Hempstead Ave WEST TOWN New York 112233 Stati Uniti
( altra_chiave = altro_valore )
dati.suInformazioni sul venditore.
dati.feedbackStarElenco delle coppie di valori chiave dei marchi di prodotti offerti dal venditore.
dati.productCountIl numero di prodotti del venditore
** DEPRECATO dal 2/16/2024 **
dati.prodottiMarchi[]
Elenco delle coppie di valori chiave dei marchi di prodotti offerti dal venditore.
dati.feedbackPositivo30 giorniIl venditore ha feedback positivo per un periodo di 30 giorni.
dati.feedbackPositivo90 giorniIl venditore ha feedback positivo per un periodo di 90 giorni.
dati.feedbackPositivo12mesiIl venditore feedback positivo per un periodo di 12 mesi.
data.feedbackPositiveLifetimeIl venditore feedback positivo per tutta la vita.
data.feedbackNeutro30 giorniIl feedback neutro del venditore per un periodo di 30 giorni.
data.feedbackNeutro90 giorniIl feedback neutro del venditore per un periodo di 90 giorni.
data.feedbackNeutro12mesiIl feedback neutro del venditore per un periodo di 12 mesi.
data.feedbackNeutralLifetimeIl feedback neutro del venditore per il periodo di vita.
data.feedbackNegativo30 giorniIl venditore feedback negativo per un periodo di 30 giorni.
data.feedbackNegativo90 giorniIl venditore feedback negativo per un periodo di 90 giorni.
dati.feedbackNegativo12mesiIl venditore feedback negativo per un periodo di 12 mesi.
data.feedbackNegativeLifetimeIl venditore feedback negativo per tutta la vita.
data.feedbackCount30daysIl feedback del venditore conta per un periodo di 30 giorni.
data.feedbackCount90daysIl feedback del venditore conta per un periodo di 90 giorni.
data.feedbackCount12monthsIl feedback del venditore conta per un periodo di 12 mesi.
data.feedbackCountLifetimeIl feedback del venditore conta per il periodo di vita.

OTTIENI INFORMAZIONI SUL VENDITORE RISULTATO MEDIANTE RICHIESTA ID

La richiesta per ottenere il risultato delle informazioni sul venditore in base all'ID richiesta (rid).

DETRAZIONE DEL CREDITO

Detrazione di 0 (zero) credito per la chiamata Get.

RICHIESTA
URI /api/query/getsellerinfo/rid/{rid}?secretKey={secretKey} {rid} – ID richiesta dalla risposta /api/query/estprofit/
Esempio /api/query/ getsellerinfo/rid/60f12c1a0cf24280ed03c11d?secretKey=XXXXXXXXXX
RISPOSTA

See Dati di esempio JSON per la richiamata delle query sulle informazioni del venditore

AGGIUNGI L'ID VENDITORE PER OTTENERE LA CODA DI INTERROGAZIONE ASINS DEL VENDITORE

La richiesta di aggiungere un ID venditore alla coda delle query Ottieni asins venditore.

Avvertenza: L'API Amzpecty può ottenere solo un massimo di 2,400 Asin.

DETRAZIONE DEL CREDITO

1 (uno) detrazione di credito dopo il recupero riuscito di 1 pagina di dati Asin. Ogni pagina contiene un massimo di 16 Asin.

RICHIESTA
URI /api/query/seller/getasins/{ID VENDITORE}? dominio={dominio}&chiavesegreta={chiavesegreta} {SELLER ID} – obbligatorio – l'ID venditore del venditore target {domain} – facoltativo – il valore predefinito è www.amazon.com se non specificato. Vedere Domini Amazon supportati per lista.
Intestazione HTTP (facoltativa) AMZPECTY_CALLBACK_URL={Il tuo URL di richiamata}
Esempio /api/query/seller/getasins/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX
RISPOSTA
Headers
Tipo di supporto application / json
Dati JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerasins",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03b000",
    "dateProcessed": null,
    "domain": null
}
OTTIENI DATI DI ESEMPIO JSON RICHIAMO ASINS DEL VENDITORE
Headers
Tipo di supporto application / json
Dati JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerasins",
    "allowed": 4986,
    "dailyAllowed": 4986,
    "messageId": null,
    "message": null,
    "data": {
        "sellerId": "A3VHYG59GNVJVO",
        "status": "completed",
        "completedAsins": 2,
        "totalAsins": 2,
        "asins": [
            {
                "asin": "B07JLCLVRJ",
                "itemName": "Funko PoP! MArvel",
                "price": 9.99,
                "customerStarRating": "4.5 out of 5 stars",
                "customerReview": "5,006 ratings",
                "linkUrl": "http://www.amazon.com/gp/product/B07JLCLVRJ/ref=silver_xx_cont_revecalc",
                "imageUrl": "https://m.media-amazon.com/images/I/61Y6N4hBjDL._SL120_.jpg",
                "otherDetails": [
                    "Get it as soon as Tue, Mar 29",
                    "$3.99 shipping",
                    "Only 1 left in stock - order soon."
                ]
            },
            {
                "asin": "B08XMY2DWM",
                "itemName": "Party House Masters of The Universe Mini Figurines Cake Toppers ",
                "price": 7.4,
                "priceShipping": 0,
                "inventoryWarning": "",
                "customerStarRating": "5 out of 5 stars",
                "customerReview": "1,105 ratings",
                "linkUrl": "http://www.amazon.com/gp/product/B08XMY2DWM/ref=silver_xx_cont_revecalc",
                "imageUrl": "https://m.media-amazon.com/images/I/61Y6N4hBjDL._SL120_.jpg",
                "otherDetails": [
                    "Get it as soon as Tue, Mar 29",
                    "$2.99 shipping",
                    "Only 10 left in stock - order soon."
                ]
            }
        ]
    },
    "rid": "60f12c1a0cf24280ed03be5e",
    "dateProcessed": 1626418203388,
    "domain": "www.amazon.com"
    "totalCreditsDeducted": 1
}
OTTIENI GLI ASINS DEL VENDITORE QUERY RISPOSTA CALLBACK ATTRIBUTI JSON
nome attributoDettagli
Stato dell'ordineLo stato della richiesta.
rispostaperValore "sellerinfo" per il risultato della query sulle informazioni sul venditore.
permessoConteggio delle richieste attualmente consentite. Si ripristina mensilmente.
giornalieroConsentitoIl conteggio attuale delle richieste giornaliere consentite. Si ripristina quotidianamente.
ID messaggioL'ID del messaggio (se presente).
messaggioIl messaggio effettivo (se presente). Fare riferimento ai Messaggi di errore.
liberareL'ID della richiesta. Può essere utilizzato nella query Ottieni come chiave.
dominioIl dominio Amazon corrispondente al venditore.
crediti totali detrattiQuesto campo indica quanti crediti API Amzpecty sono stati utilizzati per soddisfare questa richiesta.
dataProcessedLa data in cui la richiesta è stata elaborata nel formato ora Unix.
dati.sellerIdL'ID del venditore.
dati.searchStatusLo stato della ricerca. “in corso” o “completato”
data.completedAsinsIl numero di Asin recuperati. Limite massimo di 2,400 Asin solo anche se il venditore ha più di 2,400 Asin. Tieni presente che gli Asin totali potrebbero non essere uguali agli Asin completati per vari motivi. Fare riferimento al campo searchStatus per lo stato di ricerca.
dati.businessInfoMappa delle coppie chiave-valore, ad es
Nome azienda=9103-6152 Quebec Inc
Indirizzo commerciale=558A Hempstead Ave WEST TOWN New York 112233 Stati Uniti
data.totalAsinsIl numero totale di Asin posseduti da questo venditore.
dati.asins[]L'elenco degli Asin posseduti da questo venditore.
asins[n].asinL'Asin dell'articolo
asins[n].itemNameIl nome dell'oggetto dell'Asin
asins[n].prezzoIl prezzo visualizzato dell'Asin
asins[n].customerStarRatingLa valutazione in stelle dell'Asin da parte dei clienti
asins[n].customerReviewIl numero di recensioni dei clienti dell'Asin
asins[n].linkUrlIl collegamento dell'Asin
asins[n].imageUrlL'URL dell'immagine dell'Asin
asins[n].otherDetails[n]Elenco di altri dettagli come informazioni sulla spedizione, spese di spedizione, avviso di stock ecc.

OTTIENI I RISULTATI ASINS DEL VENDITORE PER ID RICHIESTA

La richiesta per ottenere il risultato Asins del venditore in base all'ID richiesta (rid).

Tieni presente che puoi richiamarlo per recuperare i dati dei risultati anche se Amzpecty sta ancora cercando i dati e non è completo al 100%. È possibile fare riferimento al campo searchStatus per lo stato della ricerca.

Note:: Evitare di effettuare chiamate successive a intervalli molto brevi. L'intervallo di chiamata consigliato è ogni almeno 30 secondi.

DETRAZIONE DEL CREDITO

Detrazione di 0 (zero) credito per la chiamata Get.

RICHIESTA
URI /api/query/seller/getasins/{ID VENDITORE}? dominio={dominio}&chiavesegreta={chiavesegreta} {SELLER ID} – obbligatorio – l'ID venditore del venditore target {domain} – facoltativo – il valore predefinito è www.amazon.com se non specificato. Vedere Domini Amazon supportati per lista.
Esempio /api/query/getsellerasin/rid/60f12c1a0cf24280ed03c11d?secretKey=XXXXXXXXXX
RISPOSTA

See Ottieni dati di esempio JSON per la richiamata della query Asins del venditore

È stato utile quest'articolo? Si Non
Come vi possiamo aiutare?