logo

Monitor API Usage

GuideUpdated 2026-06-20

The Usage page gives you a live view of how many requests you have made and how many credits you have consumed, with a date range selector and a per-day chart. You can also query your balance programmatically at any time.

In the dashboard

  1. Click Usage in the left sidebar.
  2. The page loads in 30-day view by default. The header reads "API Usage" with the subtitle "Track request volume, success rate, and credit consumption."
  3. Use the date range control in the top-right to switch between 7 days, 30 days, and 90 days. Every section on the page reloads when you change the range.
Usage page showing the 4 stat cards and the Requests over time chart in 30-day view
The Usage page in 30-day view. Four stat cards sit above a daily requests chart.

Stat cards

The four cards across the top summarise your activity for the selected period:

  • Total requests — the number of scrape requests dispatched. A trend arrow (green up, red down) shows the percentage change vs. the previous equivalent period.
  • Success rate — not yet tracked; displays "—".
  • Credits used — credits consumed in the current billing cycle, shown as "X of N this cycle".
  • Avg response — not yet tracked; displays "—".

Requests over time chart

Below the stat cards, a line-area chart plots daily request counts for the selected window.

  • The Y-axis shows volume (displayed in thousands when the count exceeds 1,000).
  • The X-axis shows up to four date markers spanning the period.
  • A highlighted dot marks the most recent data point.
Requests over time line chart with a highlighted dot on the last data point and four date labels on the X-axis
The daily requests chart. The highlighted dot marks the most recent day's count.
Usage page after switching to the 7-day filter — the active segment reads '7 days'
Switching to 7 days reloads all cards and the chart to cover only the last week.

Empty state

If no requests were made in the selected period the chart area is replaced with:

No usage data — No requests found for this period.

Usage page empty state showing the no-data message
The empty state appears when there are no requests in the chosen range.

Check your balance via the API

Use POST /users/credits/ to fetch your current credit balance at any time — useful for dashboards, alerting, or pre-flight checks before running a large collection.

Get Credits

POST
https://multicartapi.com/api/v1/users/credits/
API Key or Session Token

No request body needed

Send an empty JSON object {} or omit the body entirely. The endpoint identifies you from the x-api-key header.

curl https://multicartapi.com/api/v1/users/credits/ \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
"code": 200,
"data": {
  "id": 5,
  "user": 42,
  "available_credits": 10000,
  "used_credits": 342,
  "frozen_credits": 0,
  "period_end": "2026-07-20T00:00:00Z",
  "created_at": "2025-01-15T09:00:00Z",
  "updated_at": "2026-06-20T00:00:00Z"
},
"status": 1
}

Reading the response

FieldMeaning
available_creditsTotal credits granted for the current cycle
used_creditsCredits consumed by completed scrapes
frozen_creditsCredits reserved for in-flight scrape jobs
period_endWhen the cycle resets. null means a lifetime Starter grant that never auto-resets

Remaining usable credits = available_credits - used_credits - frozen_credits.