Best Seller Search API
Updated on 1/11/2023.
Overview
The Best Seller Search requires a country_code, a platform and a query. It returns a list of best sellers including best seller infos, category, sales estimations and evolution.
Use your API key to authenticate on the API.
List of values for platform
: Allegro, Aliexpress, Amazon,
Backmarket, Cdiscount, ManoMano, Vinted, Walmart, Wayfair, Zalando
List of values for country_code
: us, gb, fr, de, it, es,
pl, ca.
⚠️ there is no data for some (country_code, platform) pairs, e.g. (us, Cdiscount).
Minimal example URL
https://vigiesearch.com/api/v1/search?country_code=gb&platform=Amazon&q=beauty&api_key=•••668b
[
{
"id": "B079Y882CJ",
"title": "Ardell Duo Quick-Set Clear 5 g",
"brand": "Ardell",
"image": "https://images-eu.ssl-images-amazon.com/images/I/61C9Iwt2Z7L._AC_UL300_SR300,200_.jpg",
"link": "https://www.amazon.co.uk/Duo-Quick-Set-Striplash-Adhesive-Clear/dp/B079Y882CJ",
"category1_id": "beauty",
"category2_id": "make-up",
"category3_id": "make-up brushes & tools",
"category4_id": "eyes",
"product_type": "eyes",
"created_at": "2022-05-16",
"price": 6,
"price_evol": 0,
"sales": 80597,
"sales_evol": 290,
"units": 16276,
"units_evol": 333,
"start": "2022-01-10",
"period": "last-52-weeks",
"gtin": "0073930675839",
"seller": "Zadaz ltd"
}
]
Parameters
Parameter name | Required | Example |
---|---|---|
platform | yes |
Amazon |
country_code | yes |
fr |
q | no |
beauty |
category1_id | no |
beauty |
category2_id | no |
make-up |
category3_id | no |
make-up brushes & tools |
category4_id | no |
eyes |
brand | no |
Ardell |
seller | no |
Amazon |
api_key | yes |
•••668b |
limit | no |
120 |
period | no |
last-52-weeks |
The API is case-sensitive, eg Beauty
will not return the
same results as beauty
.
Response format
Field | Type | Description |
---|---|---|
id | string |
ASIN, Id |
title | string |
product title |
brand | string |
product brand |
image | string |
product principal reduced image |
link | string |
product url |
seller | string |
product main's seller, eg Amazon |
category1_id | string |
category level 1 as displayed on the platform |
category2_id | string |
level 2 |
category3_id | string |
level 3 |
category4_id | string |
level 4 |
created_at | date |
first time the crawler discovered the best seller. Can be useful to filter out new products. |
gtin | string |
EAN or UPC |
price | float |
last price captured in the period |
price_evol | integer |
price evolution vs last period, eg last week, as a
0-100 percentage. A best seller going from $10 to $11
will have 10 as price_evol .
|
sales | integer |
sales estimated by Vigie in the given period (week, 4 weeks, 52 weeks) |
sales_evol | integer |
sales evolution vs last period, eg last week, as a
0-100 percentage. A best seller going from $1000 to
$1100 will have 10 as sales_evol .
|
units | integer |
period unit sales estimated by Vigie (weekly sales) |
units_evol | integer |
units evolution vs last period, eg last week, as a
0-100 percentage. A best seller going from 100 to 90
will have -10 as units_evol .
|
start | date |
period start date (weeks start on monday). |
period | string |
last-week , last-4-weeks ,
last-52-weeks
|
Errors
Http status code | Description |
---|---|
400 |
a required query parameter is missing or has a wrong value |
401 |
need api key |
403 |
wrong api key |
404 |
no data |
429 |
quota exceeded |
500 |
something is wrong on our side |
Quota
The quota resets every Monday at 2 PM at Paris time.