# 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**

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

### Real-Time Integration

> #### a\_plus\_content:

```javascript
// 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

```javascript
// 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 ✅


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://easyparser.gitbook.io/easyparser-documentation/amazon/credit-consumption.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.