Meer API: Meerapi Get Usage Stats

Read your Meer API request counts: total, by month and by country.

Tool ID: meerapi_get_usage_stats

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'meerapi_get_usage_stats',
  {},
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute meerapi_get_usage_stats --input '{}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "customer_name": "Example",
    "total_requests": 123,
    "monthly": [
      {
        "year": 123,
        "month": 12,
        "request_count": 123
      }
    ],
    "by_country": [
      {
        "country": "US",
        "request_count": 123
      }
    ]
  }
}

Use deepline describe meerapi_get_usage_stats --json for the latest machine-readable contract.

Input reference

Lifetime request counts for your account, by calendar month and country. Free. This action requires no input fields.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.customer_name`	`string`	Yes	—	The account the API key belongs to.
`result.data.total_requests`	`integer`	Yes	—	Sum of `monthly[].request_count`. Format: `int64`.
`result.data.monthly`	`array`	Yes	—	Oldest month first. Months with no requests may be missing.
`result.data.monthly[].year`	`integer`	Yes	—	UTC year.
`result.data.monthly[].month`	`integer`	Yes	—	UTC month. Minimum: 1. Maximum: 12.
`result.data.monthly[].request_count`	`integer`	Yes	—	Billable requests that month.
`result.data.by_country`	`array`	Yes	—	Most requests first, then by country code.
`result.data.by_country[].country`	`string`	Yes	—	ISO 3166-1 alpha-2 code.
`result.data.by_country[].request_count`	`integer`	Yes	—	Format: `int64`.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation