Request

To initiate a Sales Analysis & History request, send a GET request to the EasyParser Real-Time API endpoint.

Endpoint

GET https://realtime.easyparser.com/v1/request

Required Parameters

This operation requires certain common parameters to be included in every request. For more details, see Common Required Request Fields.

Optional Parameters

history_range

String

Defines the historical depth of the data in months. Valid values are "0", "3", "6", "9", "12".

Important Note on Historical Data: When you request historical data using history_range (e.g., "3" for 3 months), the API returns a history array.
Input: Defined in Months.
Output: Aggregated by Weeks.
Each item in the history array represents one week of performance data (Views, Sales, Price, Rank) corresponding to the requested date range.

Credit Consumption

This operation has a base cost of 5 credits. Requesting historical data incurs additional credits based on the depth of history required.

"0" (Default)

Current Snapshot

5 Credits

"3"

Last 3 Months

8 Credits

"6"

Last 6 Months

11 Credits

"9"

Last 9 Months

14 Credits

"12"

Last 12 Months

+12

17 Credits

For more details, please refer to the Credit Consumption Page.

Example Request

curl --location 'https://realtime.easyparser.com/v1/request?
  api_key=YOUR_API_KEY&
  platform=AMZ&
  operation=SALES_ANALYSIS_HISTORY&
  domain=.com&
  asin=B07C2Z21X5&
  history_range=3'


import requests
import json

# set up the request parameters
params = {
  "api_key": "YOUR_API_KEY",
  "platform": "AMZ",
  "operation": "SALES_ANALYSIS_HISTORY",
  "domain": ".com",
  "asin": "B07C2Z21X5",
  "history_range": "3",
}

# make the http GET request to EasyParser API
api_result = requests.get("https://realtime.easyparser.com/v1/request", params=params)

# print the JSON response from EasyParser API
print(json.dumps(api_result.json(), indent=2))


const axios = require("axios");

// set up the request parameters
const params = {
  api_key: "YOUR_API_KEY",
  platform: "AMZ",
  operation: "SALES_ANALYSIS_HISTORY",
  domain: ".com",
  asin: "B07C2Z21X5",
  history_range: "3",
}

// make the http GET request to EasyParser API
axios.get("https://realtime.easyparser.com/v1/request", { params })
.then(response => {
  // print the JSON response from EasyParser API
  console.log(JSON.stringify(response.data, null, 2));
})


<?php

# set up the request parameters
$params = [
  "api_key" => "YOUR_API_KEY",
  "platform" => "AMZ",
  "operation" => "SALES_ANALYSIS_HISTORY",
  "domain" => ".com",
  "asin" => "B07C2Z21X5",
  "history_range" => "3",
];

# make the http GET request to EasyParser API
$response = file_get_contents("https://realtime.easyparser.com/v1/request?" . http_build_query($params));

# print the JSON response from EasyParser API
echo $response;


package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {
  // set up the request parameters
  url := "https://realtime.easyparser.com/v1/request?params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("platform", "AMZ")
params.Add("operation", "SALES_ANALYSIS_HISTORY")
params.Add("domain", ".com")
params.Add("asin", "B07C2Z21X5")
params.Add("history_range", "3")
fullURL := fmt.Sprintf("%s?%s", baseURL, params.Encode())
"
  
  // make the http GET request to EasyParser API
  res, _ := http.Get(url)
  defer res.Body.Close()
  
  // print the JSON response from EasyParser API
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}


using System.Net.Http;

// set up the request parameters
var client = new HttpClient();

// make the http GET request to EasyParser API
var response = await client.GetAsync("https://realtime.easyparser.com/v1/request?var query = HttpUtility.ParseQueryString(string.Empty);
query["api_key"] = "YOUR_API_KEY";
query["platform"] = "AMZ";
query["operation"] = "SALES_ANALYSIS_HISTORY";
query["domain"] = ".com";
query["asin"] = "B07C2Z21X5";
query["history_range"] = "3";
var fullUrl = baseUrl + "?" + query.ToString();
");

// print the JSON response from EasyParser API
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);


import okhttp3.*;

// set up the request parameters
OkHttpClient client = new OkHttpClient();

// make the http GET request to EasyParser API
Request request = new Request.Builder()
  .url("https://realtime.easyparser.com/v1/request?URIBuilder builder = new URIBuilder(baseUrl);
builder.addParameter("api_key", "YOUR_API_KEY");
builder.addParameter("platform", "AMZ");
builder.addParameter("operation", "SALES_ANALYSIS_HISTORY");
builder.addParameter("domain", ".com");
builder.addParameter("asin", "B07C2Z21X5");
builder.addParameter("history_range", "3");
String fullUrl = builder.build().toString();
")
  .build();

// print the JSON response from EasyParser API
Response response = client.newCall(request).execute();
System.out.println(response.body().string());

PreviousSales Analysis & History NextResponse

Last updated 7 days ago