Measure Network Requests API
Network request domains, paths, trends and plots.
Operations 6
GET
/apps/{id}/networkRequests/plots/endpointStatusCodes
Fetch exact HTTP status-code counts over time
#
Network request domains, paths, trends and plots.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/measure-sh:measure-sh-network-requests-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Measure Dashboard Network Requests API
version: 1.0.0
description: 'Reference for Measure''s Dashboard REST API. Every endpoint, request body,
response format and status code.
Requests are authenticated with the user''s access token in
`Authorization: Bearer ` format, unless cookies are used to
send tokens. Set `Content-Type: application/json; charset=utf-8` on each
request.
Failed requests have the following response shape:
```json
{
"error": "Error message",
"details": "Additional error details, when available"
}
```'
servers:
- url: https://api.measure.sh
description: Measure cloud
- url: http://localhost:8080
description: Self-hosted Measure API origin
security:
- bearerAuth: []
tags:
- name: Network Requests
description: Network request domains, paths, trends and plots.
paths:
/apps/{id}/networkRequests/endpoints:
get:
operationId: getNetworkRequestsEndpoints
tags:
- Network Requests
summary: List an app's network endpoints
description: 'An empty query returns up to 20 generated endpoint patterns. A non-empty
query returns a de-duplicated union of up to 20 matching generated
endpoint patterns and up to 20 matching captured request paths (up to
40 results total). Each source is ranked by request count.
Use `query` to search endpoint text or enter a domain and path pattern.
`from` and `to` default to the last seven days when omitted.'
parameters:
- name: id
in: path
required: true
description: App's UUID.
schema:
type: string
format: uuid
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/FilterExpr'
- name: query
in: query
required: false
description: Endpoint text or a domain and path pattern.
schema:
type: string
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
type: object
properties:
results:
type: array
maxItems: 40
items:
type: object
properties:
domain:
type: string
path_pattern:
type: string
examples:
response:
value:
results:
- domain: api.example.com
path_pattern: /api/users/*
- domain: cdn.example.com
path_pattern: /assets/**
'400':
description: Request URI is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
'401':
description: Either the user's access token is invalid or has expired.
'403':
description: Requester does not have access to this resource.
'429':
description: Rate limit of the requester has crossed maximum limits.
'500':
description: Measure server encountered an unfortunate error. Report this to your server administrator.
/apps/{id}/networkRequests/trends:
get:
operationId: getNetworkRequestsTrends
tags:
- Network Requests
summary: Fetch an app's network request trends
description: 'Fetch an app''s network request trends showing top endpoints by latency,
error rate and frequency.
`from` & `to` will default to a last seven days time range if not
supplied. Results are limited to the top `trends_limit` most
relevant endpoints per category (default 10, max 50). P95 latency is in
milliseconds. Error rate is a percentage (0-100).'
parameters:
- name: id
in: path
required: true
description: App's UUID.
schema:
type: string
format: uuid
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/FilterExpr'
- name: trends_limit
in: query
required: false
description: Maximum number of top endpoints to include per category. Defaults to 10, max 50.
schema:
type: integer
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
type: object
properties:
trends_latency:
type: array
items:
type: object
properties:
domain:
type: string
path_pattern:
type: string
p95_latency:
type: number
error_rate:
type: number
frequency:
type: number
trends_error_rate:
type: array
items:
type: object
properties:
domain:
type: string
path_pattern:
type: string
p95_latency:
type: number
error_rate:
type: number
frequency:
type: number
trends_frequency:
type: array
items:
type: object
properties:
domain:
type: string
path_pattern:
type: string
p95_latency:
type: number
error_rate:
type: number
frequency:
type: number
examples:
response:
value:
trends_latency:
- domain: api.example.com
path_pattern: /api/users
p95_latency: 250.5
error_rate: 2.3
frequency: 15000
trends_error_rate:
- domain: api.example.com
path_pattern: /api/auth
p95_latency: 150.2
error_rate: 5.8
frequency: 8500
trends_frequency:
- domain: api.example.com
path_pattern: /api/feed
p95_latency: 120.0
error_rate: 1.2
frequency: 50000
'400':
description: Request URI is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
'401':
description: Either the user's access token is invalid or has expired.
'403':
description: Requester does not have access to this resource.
'429':
description: Rate limit of the requester has crossed maximum limits.
'500':
description: Measure server encountered an unfortunate error. Report this to your server administrator.
/apps/{id}/networkRequests/plots/statusCodes:
get:
operationId: getNetworkStatusCodesPlot
tags:
- Network Requests
summary: Fetch HTTP status-class counts over time
description: 'Fetch HTTP status-class counts over time for the app, or an optional
endpoint selection.
`from` & `to` will default to a last seven days time range if not
supplied.'
parameters:
- name: id
in: path
required: true
description: App's UUID.
schema:
type: string
format: uuid
- name: domain
in: query
required: false
description: Exact domain or `*` wildcard pattern.
schema:
type: string
- name: path
in: query
required: false
description: Exact path or a `*` or trailing `**` pattern. Without a domain, searches every domain.
schema:
type: string
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/FilterExpr'
- $ref: '#/components/parameters/Timezone'
- $ref: '#/components/parameters/PlotTimeGroup'
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
type: array
items:
type: object
properties:
datetime:
type: string
total_count:
type: number
count_2xx:
type: number
count_3xx:
type: number
count_4xx:
type: number
count_5xx:
type: number
examples:
response:
value:
- datetime: '2024-01-15'
total_count: 125000
count_2xx: 120625
count_3xx: 2000
count_4xx: 1250
count_5xx: 1125
- datetime: '2024-01-16'
total_count: 128000
count_2xx: 124480
count_3xx: 2304
count_4xx: 768
count_5xx: 448
'400':
description: Request URI is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
'401':
description: Either the user's access token is invalid or has expired.
'403':
description: Requester does not have access to this resource.
'429':
description: Rate limit of the requester has crossed maximum limits.
'500':
description: Measure server encountered an unfortunate error. Report this to your server administrator.
/apps/{id}/networkRequests/plots/latency:
get:
operationId: getNetworkLatencyPlot
tags:
- Network Requests
summary: Fetch latency percentiles over time
description: 'Fetch latency percentiles for the app, or an optional endpoint selection.
`from` & `to` will default to a last seven days time range if not
supplied. Latency values (`p50`, `p90`, `p95`, `p99`) are in
milliseconds and may be null.'
parameters:
- name: id
in: path
required: true
description: App's UUID.
schema:
type: string
format: uuid
- name: domain
in: query
required: false
description: Exact domain or `*` wildcard pattern.
schema:
type: string
- name: path
in: query
required: false
description: Exact path or a `*` or trailing `**` pattern. Without a domain, searches every domain.
schema:
type: string
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/FilterExpr'
- $ref: '#/components/parameters/Timezone'
- $ref: '#/components/parameters/PlotTimeGroup'
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
type: array
items:
type: object
properties:
datetime:
type: string
p50:
type:
- number
- 'null'
p90:
type:
- number
- 'null'
p95:
type:
- number
- 'null'
p99:
type:
- number
- 'null'
count:
type: number
examples:
response:
value:
- datetime: '2024-01-15T14:30:00'
p50: 100.5
p90: 250.3
p95: 350.7
p99: 500.2
count: 1500
- datetime: '2024-01-15T15:00:00'
p50: 95.2
p90: 240.1
p95: 340.5
p99: 510.3
count: 1600
'400':
description: Request URI is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
'401':
description: Either the user's access token is invalid or has expired.
'403':
description: Requester does not have access to this resource.
'429':
description: Rate limit of the requester has crossed maximum limits.
'500':
description: Measure server encountered an unfortunate error. Report this to your server administrator.
/apps/{id}/networkRequests/plots/endpointStatusCodes:
get:
operationId: getNetworkEndpointStatusCodesPlot
tags:
- Network Requests
summary: Fetch exact HTTP status-code counts over time
description: 'Fetch exact HTTP status-code counts over time for a domain, path, or
endpoint selection. At least one of `domain` or `path` is required.
When `domain` is omitted, `path` matches across all domains.
`from` & `to` will default to a last seven days time range if not
supplied. `status_codes` lists all distinct HTTP status codes
observed. `data_points` contains per-bucket counts keyed by exact
status code (e.g., `count_200`, `count_404`), not by status class.'
parameters:
- name: id
in: path
required: true
description: App's UUID.
schema:
type: string
format: uuid
- name: domain
in: query
required: false
description: Exact domain or `*` wildcard pattern.
schema:
type: string
- name: path
in: query
required: false
description: Exact path or a `*` or trailing `**` pattern; matches across all domains when domain is omitted.
schema:
type: string
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/FilterExpr'
- $ref: '#/components/parameters/Timezone'
- $ref: '#/components/parameters/PlotTimeGroup'
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
type: object
properties:
status_codes:
type: array
items:
type: integer
data_points:
type: array
items:
type: object
description: Per-bucket counts keyed by exact status code, e.g. `count_200`.
properties:
datetime:
type: string
total_count:
type: number
additionalProperties: true
examples:
response:
value:
status_codes:
- 200
- 301
- 404
- 500
data_points:
- datetime: '2024-01-15T14:30:00'
total_count: 1500
count_200: 1470
count_301: 15
count_404: 10
count_500: 5
- datetime: '2024-01-15T15:00:00'
total_count: 1600
count_200: 1568
count_301: 20
count_404: 8
count_500: 4
'400':
description: Request URI is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
'401':
description: Either the user's access token is invalid or has expired.
'403':
description: Requester does not have access to this resource.
'429':
description: Rate limit of the requester has crossed maximum limits.
'500':
description: Measure server encountered an unfortunate error. Report this to your server administrator.
/apps/{id}/networkRequests/plots/timeline:
get:
operationId: getNetworkTimelinePlot
tags:
- Network Requests
summary: Fetch an endpoint request timeline
description: 'Fetch the request timeline for the app or an optional endpoint selection.
`from` & `to` will default to a last seven days time range if not
supplied. Results include up to 10 endpoint patterns. `interval` is the time
bucket size in seconds. `elapsed` represents seconds of elapsed time
within sessions. `count` is the average request count per session for
that endpoint in that bucket.'
parameters:
- name: id
in: path
required: true
description: App's UUID.
schema:
type: string
format: uuid
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/FilterExpr'
- name: domain
in: query
required: false
description: Exact domain or `*` wildcard pattern.
schema:
type: string
- name: path
in: query
required: false
description: Exact path or a `*` or trailing `**` pattern. Without a domain, searches every domain.
schema:
type: string
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
type: object
properties:
interval:
type: number
description: Time bucket size in seconds.
points:
type: array
items:
type: object
properties:
elapsed:
type: number
description: Seconds of elapsed time within sessions.
domain:
type: string
path_pattern:
type: string
count:
type: number
description: Average request count per session for the endpoint in the bucket.
examples:
response:
value:
interval: 5
points:
- elapsed: 0
domain: api.example.com
path_pattern: /api/users
count: 125.5
- elapsed: 5
domain: api.example.com
path_pattern: /api/users
count: 128.3
- elapsed: 0
domain: cdn.example.com
path_pattern: /images/avatar.png
count: 45.2
'400':
description: Request URI is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
'401':
description: Either the user's access token is invalid or has expired.
'403':
description: Requester does not have access to this resource.
'429':
description: Rate limit of the requester has crossed maximum limits.
'500':
description: Measure server encountered an unfortunate error. Report this to your server administrator.
components:
parameters:
Timezone:
name: timezone
in: query
required: true
description: 'IANA timezone used to bucket and format datetime values in the response. Example: `Asia/Kolkata`.'
schema:
type: string
FilterExpr:
name: filter_expr
in: query
required: false
description: 'Conditions joined by `AND` or `OR` and grouped with parentheses,
each reading `key:operator:values` with the names
`/apps/{id}/filters/keys` publishes. `AND` binds tighter than `OR`.
```
version_name:in:[1.2.0,1.1.9] AND mapping_type:not_in:jsbundle
(version_name:contains:SNAPSHOT AND mapping_type:in:proguard) OR patch_id:is_set
```
An operator taking no values ends its condition, as
`patch_id:is_set` does. Double-quote a value holding a space,
comma, bracket, colon or quote, with `\"` and `\\` inside.
At most 4096 bytes, 32 conditions, 4 levels of nesting and 200
values in one condition.
'
schema:
type: string
PlotTimeGroup:
name: plot_time_group
in: query
required: false
description: Time bucket used for plot aggregation. Defaults to `days`.
schema:
type: string
enum:
- minutes
- hours
- days
- months
To:
name: to
in: query
required: false
description: 'ISO 8601 UTC string in milliseconds precision. Example: `2023-11-01T18:30:00.000Z`. Omitting both `from` and `to` returns the last seven days.'
schema:
type: string
From:
name: from
in: query
required: false
description: 'ISO 8601 UTC string in milliseconds precision. Example: `2023-11-01T18:30:00.000Z`. Omitting both `from` and `to` returns the last seven days.'
schema:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'User access token issued at sign-in. Sent as
`Authorization: Bearer <access-token>` unless cookies are used to send
tokens. The `/auth/refresh` and `/auth/signout` endpoints expect the
session''s refresh token in the same header format instead.
'