Account API

The Account API returns details about your Easyparser account: the active plan, credit balance, per-minute credit limits for the Real-Time API and Bulk API, address quota, and usage history. Use it to monitor remaining credits, show account data in your own dashboards, build usage reports, or alert when your balance runs low.

Endpoint

GET https://account.easyparser.com/v1/account

Authenticate with your API key in the api_key query parameter. The Account API does not accept an Authorization: Bearer header. You find your key in the web app under Account > Plan at https://app.easyparser.com/account/plan. New accounts get 100 free credits per month, with no credit card required. See Getting Started for a step-by-step guide.

Parameters

Parameter	Type	Required	Description
`api_key`	string	Yes	Your Easyparser API key. Send it as a query parameter.

The endpoint takes no other parameters.

Example request

curl --get "https://account.easyparser.com/v1/account" \
  --data-urlencode "api_key=YOUR_API_KEY"

import requests

params = {
    "api_key": "YOUR_API_KEY",
}

response = requests.get("https://account.easyparser.com/v1/account", params=params)
print(response.json())

const params = new URLSearchParams({
  api_key: "YOUR_API_KEY",
});

const response = await fetch(`https://account.easyparser.com/v1/account?${params}`);
const data = await response.json();
console.log(data);

GET /v1/account?api_key=YOUR_API_KEY HTTP/1.1
Host: account.easyparser.com

<?php
$params = [
    'api_key' => 'YOUR_API_KEY',
];

$url = 'https://account.easyparser.com/v1/account?' . http_build_query($params);
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);

package main

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

func main() {
  params := url.Values{}
  params.Add("api_key", "YOUR_API_KEY")

  resp, err := http.Get("https://account.easyparser.com/v1/account?" + params.Encode())
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;

var parameters = new Dictionary<string, string>
{
    ["api_key"] = "YOUR_API_KEY",
};

var query = string.Join("&", parameters.Select(p =>
    $"{Uri.EscapeDataString(p.Key)}={Uri.EscapeDataString(p.Value)}"));

using var client = new HttpClient();
var response = await client.GetStringAsync($"https://account.easyparser.com/v1/account?{query}");
Console.WriteLine(response);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.stream.Collectors;

public class EasyparserRequest {
    public static void main(String[] args) throws Exception {
        Map<String, String> params = new LinkedHashMap<>();
        params.put("api_key", "YOUR_API_KEY");

        String query = params.entrySet().stream()
            .map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "="
                + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
            .collect(Collectors.joining("&"));

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://account.easyparser.com/v1/account?" + query))
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Response fields

The response has two top-level objects: request_info and account_info.

request_info
  success
account_info
  api_key, name, email, plan
  credits_used, credits_remaining, credits_limit, credits_reset_at
  minutely_real_time_credit_limit, minutely_bulk_credit_limit
  addresses_used, addresses_limit, addresses_available
  usage_history[]
    month, year, date, month_number, is_current_month, account_package_id
    credits_total_per_day
      <day>
        day_total
        REALTIME { total, operations }
        BULK { total, operations }
    month_summary

`request_info`

Field	Type	Description
`success`	boolean	`true` when the request succeeded. Check it before reading `account_info`.

`account_info`

Field	Type	Description
`api_key`	string	The API key the request was made with.
`name`	string	Account holder name.
`email`	string	Email address linked to the account.
`plan`	string	Name of the active subscription plan.
`credits_used`	integer	Credits used in the current billing cycle.
`credits_remaining`	integer	Credits left in the current billing cycle.
`credits_limit`	integer	Total credits included in the billing cycle.
`credits_reset_at`	string	When credits reset, as an ISO 8601 date-time.
`minutely_real_time_credit_limit`	integer	Maximum Real-Time API credits you can spend per minute.
`minutely_bulk_credit_limit`	integer	Maximum Bulk API credits you can spend per minute.
`addresses_used`	integer	Number of saved addresses in use.
`addresses_limit`	integer	Maximum number of saved addresses your plan allows.
`addresses_available`	integer	Address slots still available.
`usage_history`	array	Monthly usage records, newest first. See `usage_history[]`.

Per-minute limits are measured in credits. A Real-Time API request above minutely_real_time_credit_limit returns HTTP 429 (Too Many Requests). Bulk API items above minutely_bulk_credit_limit are returned in rate_limit_exceeded (see Bulk Service Response). Creating an address beyond addresses_limit fails with "Maximum address count reached". See Address Management.

`usage_history[]`

Each entry covers one month.

Field	Type	Description
`month`	string	Month name, for example `September`.
`year`	integer	Year of the record.
`date`	string	Reference date for the record (`YYYY-MM-DD`).
`month_number`	integer	Zero-based month index: `0` is January, `8` is September.
`is_current_month`	boolean	`true` for the current month.
`account_package_id`	integer	ID of the plan that was active during the month.
`credits_total_per_day`	object	Daily usage keyed by day of month (`"1"`, `"3"`). See `credits_total_per_day.<day>`.
`month_summary`	object	Month total of successful credits, as `{ "success": N }`.

`credits_total_per_day.<day>`

Field	Type	Description
`day_total`	object	Successful credits for the day across both services, as `{ "success": N }`.
`REALTIME`	object	Real-Time API usage for the day. See `REALTIME` and `BULK`.
`BULK`	object	Bulk API usage for the day, in the same shape as `REALTIME`. Present only on days with bulk usage.

`REALTIME` and `BULK`

Field	Type	Description
`total`	object	Successful credits for the service that day, as `{ "success": N }`.
`operations`	object	Usage per operation code, for example `DETAIL` or `SEARCH`. Each value is `{ "success": N }`.

Sample response

Sample response (Account API)

{
  "request_info": {
    "success": true
  },
  "account_info": {
    "api_key": "YOUR_API_KEY",
    "name": "MEMBER_NAME",
    "email": "member_mail@mail.com",
    "plan": "YOUR_PLAN",
    "credits_used": 9629,
    "credits_remaining": 990371,
    "credits_reset_at": "2028-12-09T08:46:47.000Z",
    "credits_limit": 1000000,
    "minutely_real_time_credit_limit": 500,
    "minutely_bulk_credit_limit": 5000,
    "addresses_used": 2,
    "addresses_limit": 30,
    "addresses_available": 28,
    "usage_history": [
      {
        "month": "September",
        "year": 2026,
        "date": "2026-09-03",
        "account_package_id": 2446,
        "month_number": 8,
        "is_current_month": true,
        "credits_total_per_day": {
          "1": {
            "day_total": { "success": 10 },
            "REALTIME": {
              "total": { "success": 10 },
              "operations": {
                "DETAIL": { "success": 5 },
                "SEARCH": { "success": 3 },
                "OFFER": { "success": 1 },
                "SELLER_PRODUCTS": { "success": 1 }
              }
            }
          },
          "3": {
            "day_total": { "success": 4 },
            "REALTIME": {
              "total": { "success": 3 },
              "operations": {
                "SEARCH": { "success": 1 },
                "DETAIL": { "success": 1 },
                "OFFER": { "success": 1 }
              }
            },
            "BULK": {
              "total": { "success": 1 },
              "operations": {
                "DETAIL": { "success": 1 }
              }
            }
          }
        },
        "month_summary": { "success": 21 }
      }
    ]
  }
}

Getting Started: create an account and find your API key
Credit Consumption: how many credits each operation uses
Address Management: saved addresses and the address quota
Real-Time API overview: response envelope, rate limits and errors
MCP Server: the check_credits tool reads this endpoint

Account API

Endpoint

Parameters

Example request

Response fields

request_info

account_info

usage_history[]

credits_total_per_day.<day>

REALTIME and BULK