Skip to content

Account-wide summary

GET
/analytics/global-summary
curl --request GET \
--url 'https://api.nsin.ir/analytics/global-summary?period=3h' \
--header 'Authorization: Bearer <token>'

Headline figures aggregated across every domain you can access.

period
string
default: 24h
Allowed values: 3h 6h 12h 24h 7d 30d

Time window, ending now. Buckets are hourly up to 24h and daily for 7d and 30d. An unrecognised value falls back to 24h.

Account-wide totals.

Media type application/json
object
total_requests
integer
total_bandwidth

Bytes.

integer
unique_visitors
integer
error_rate

Share of requests that failed, 0–1.

number
cache_hit_rate

Share of cacheable requests served from cache, 0–1.

number
peak_rps

Highest request count in any single second of the period.

integer
domains

How many domains contributed.

integer
Example generated
{
"total_requests": 1,
"total_bandwidth": 1,
"unique_visitors": 1,
"error_rate": 1,
"cache_hit_rate": 1,
"peak_rps": 1,
"domains": 1
}

Missing, malformed, revoked or expired API key — or the owning account is inactive.

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Examples
Example invalidKey
{
"error": "invalid API key"
}

The key exceeded its request budget (300 requests per minute by default).

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Examples
Example limited
{
"error": "rate limit exceeded"
}

The analytics backend is temporarily unreachable. Retry; no data is lost.

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Examples
Example unavailable
{
"error": "analytics unavailable"
}