Credit Consumption

This page outlines how credits are consumed across different EasyParser integrations and operations. By default, every request consumes 1 credit, regardless of integration type. However, certain operations or parameters (such as pagination or advanced content retrieval) may require additional credits. The table below summarizes all current scenarios that can affect credit usage.

Detailed Credit Consumption Table

Integration Type	Operation	Condition / Parameter	Credits Consumed	Description
All Integrations	Any operation	Default behavior	1	By default, all operations consume 1 credit per request unless otherwise specified below.
Real-Time	DETAIL	Default	1	Retrieves product detail for a given ASIN.
Real-Time	DETAIL	a_plus_content:true	2	Includes additional A+ (enhanced brand) content. (+1 credit)
Real-Time	OFFER	Default	1	Retrieves offer data (sellers, pricing, etc.) for a product.
Real-Time	SEARCH	Default (1 page)	1	Parses the first page of search results.
Real-Time	SEARCH / OFFER / PRODUCT LOOKUP	Pagination (min_page / max_page)	1 credit per page	You can fetch up to 5 pages in one request. Each page consumes 1 credit.
Real-Time	PRODUCT LOOKUP	Default	1	Retrieves results for product-based searches.
Bulk	DETAIL	Default	1	Retrieves product detail for each ASIN in the bulk list.
Bulk	DETAIL	a_plus_content:true	2	Includes A+ content for each ASIN. (+1 credit per ASIN)
Bulk	SEARCH	Multiple URLs	1 credit per URL × page	Each URL and page combination consumes 1 credit.
Bulk	OFFER	Default	1	Retrieves offer listings for each URL or ASIN.

Real-Time Integration

a_plus_content:

// DETAIL OPERATION 
const axios = require("axios");

// set up the request parameters
const params = {
  api_key: "YOUR_API_KEY",
  platform: "AMZ",
  operation: "DETAIL",
  output: "json",
  domain: ".com",
  asin: "B07C2Z21X5",
  a_plus_content: "true",
  include_html: "false",
};

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

Credit Calculation (example):

• Base DETAIL request for one ASIN: 1 credit

• a_plus_content:true: +1 credit Total credits consumed for this request: 2 credits ✅

min_page and max_page:

• min_page: Defines the starting page number when paginating through offers or search results. It doesn’t have to start from 1 (e.g., "min_page": 2).

• max_page: Defines the ending page number. The total number of pages retrieved is calculated as max_page - min_page + 1, and it cannot exceed 5. One credit is consumed per page.

Bulk Integration

// SEARCH OPERATION
[
    {
        "platform": "AMZ",
        "operation": "SEARCH",
        "domain": ".com",
        "address_id": 123,
        "payload": {
            "urls": [
                "https://www.amazon.com/s?k=car+play",
                "https://www.amazon.com/s?k=airpods"
            ],
            //"keywords":[
            // "car play" , "airpods"
            //],
            "page": 2,
            "exclude_sponsored": true
        },
        "callback_url": "{{bulk_callback_url}}"
    }
]

Credit Calculation (example):

• Number of URLs or KEYWORDs: 2

• Page requested per URL: 1 Total credits consumed: 2 credits ✅