API Documentation | LegendAI

API Documentation for Programmatic Product Search

(Our data is only currently from the Amazon U.S marketplace)

1 usage of New API Endpoint 1 call for an ASIN = 1 data session usage.

(For there to be data in API Endpoint 2&3, you need to at least call API Endpoint 1 once because API Endpoint 1 is the one that collects data for all 3 endpoints.)

(if you call API Endpoint 1 call more than 1 times/day for the same ASIN, it will still be counted as 1 data session)

(if you call API Endpoint 1 call for for the same ASIN the next day, it will be counted as another data session)

API Endpoint 2 calls & API Endpoint 3 calls are free.

Endpoint 1: https://datalegendai.com/search/api/{asin}/product_data/{email}/{password}

Use case: Retrieve today product data of an ASIN. Data includes: today stock, competitor count, average price, max selling price, min selling price.

Python Code:

import requests

email = "youremail@gmail.com"

password = "password12345"

asin = "B08ZB4BQFX"

response = requests.get(f"https://datalegendai.com/search/api/{asin}/product_data/{email}/{password}")

print(response.text)

Response:

{
  "output": {
    "date": "Mon, 31 Jul 2023 00:00:00 GMT",
    "product_amazon_asin": "B08ZB4BQFX",
    "product_amazon_average_price": 187.7,
    "product_amazon_competitor_count": 18,
    "product_amazon_max_competitor_selling_price": 249.95,
    "product_amazon_min_competitor_selling_price": 133.99,
    "product_amazon_stock": 62
  },
  "success": true
}

Endpoint 2: https://datalegendai.com/search/api/{asin}/product_history/{email}/{password}

Use case: Retrieve all available history of a an ASIN. Format is same as the Endpoint above (Endpoint 1) except that there are records of multiple dates.

Python Code:

import requests

email = "youremail@gmail.com"

password = "password12345"

asin = "B08ZB4BQFX"

response2 = requests.get(f"https://datalegendai.com/search/api/{asin}/product_history/{email}/{password}")

print(response2.text)

Response:

{
  "output": [
    {
      "date": "Mon, 03 Apr 2023 00:00:00 GMT",
      "product_amazon_asin": "B08ZB4BQFX",
      "product_amazon_average_price": 195.35,
      "product_amazon_competitor_count": 21,
      "product_amazon_max_competitor_selling_price": 249.95,
      "product_amazon_min_competitor_selling_price": 164.99,
      "product_amazon_stock": 65
    },
    {
      "date": "Tue, 04 Apr 2023 00:00:00 GMT",
      "product_amazon_asin": "B08ZB4BQFX",
      "product_amazon_average_price": 195.65,
      "product_amazon_competitor_count": 21,
      "product_amazon_max_competitor_selling_price": 249.95,
      "product_amazon_min_competitor_selling_price": 164.99,
      "product_amazon_stock": 65
    },
    ...
  ],
    "date": "Tue, 04 Apr 2023 00:00:00 GMT",
  "product_amazon_asin": "B08ZB4BQFX",
  "product_amazon_average_price": 195.65,
  "product_amazon_competitor_count": 21,
  "product_amazon_max_competitor_selling_price": 249.95,
  "product_amazon_min_competitor_selling_price": 164.99,
  "product_amazon_stock": 65
},
...
],
"success": true
}

Endpoint 3: https://datalegendai.com/search/api/{asin}/seller_history/{email}/{password}

Use case: Retrieve all seller data history of an ASIN through different date. Data includes: date, buy_box_won_today, product_amazon_stock, rating_amount, selling_price

Python Code:

import requests

email = "youremail@gmail.com"

password = "password12345"

asin = "B08ZB4BQFX"

response3 = requests.get(f"https://datalegendai.com/search/api/{asin}/seller_history/{email}/{password}")

print(response3.text)

Response:

{
  "output": [
    {
      "buy_box_won_today": true,
      "date": "Sun, 30 Jul 2023 00:00:00 GMT",
      "product_amazon_asin": "B08ZB4BQFX",
      "product_amazon_stock": 19,
      "rating_amount": 1298,
      "seller_name": "SBS4U LLC",
      "selling_price": 133.95
    },
    {
      "buy_box_won_today": false,
      "date": "Sun, 30 Jul 2023 00:00:00 GMT",
      "product_amazon_asin": "B08ZB4BQFX",
      "product_amazon_stock": 20,
      "rating_amount": 0,
      "seller_name": "Amazon.com",
      "selling_price": 135.99
    },
    ...
    {
      "buy_box_won_today": false,
      "date": "Mon, 31 Jul 2023 00:00:00 GMT",
      "product_amazon_asin": "B08ZB4BQFX",
      "product_amazon_stock": 4,
      "rating_amount": 359,
            "product_amazon_asin": "B08ZB4BQFX",
      "product_amazon_stock": 4,
      "rating_amount": 359,
      "seller_name": "Instock Distributing",
      "selling_price": 240.0
    }
  ],
  "success": true
}