Return to Home

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.