Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API 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. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Globalping Measurements API
summary: The public Globalping API.
description: 'The Globalping API allows you to monitor, debug, and benchmark your internet infrastructure using a globally distributed network of probes.
The supported test types are ping, traceroute, MTR, DNS resolve, and HTTP.
The API is public, free to use, and doesn''t require authentication, but it implements rate limits to ensure fair usage and reliability.
Authenticated users get higher free limits and may run additional tests by spending credits.
Sign up on the Globalping Dashboard to enjoy the higher limits.
Root endpoint: https://api.globalping.io
## Limits and credits
| Operation | Unauthenticated user | Authenticated user |
|---|---|---|
| **Measurements** |||
| Create a measurement | 250 free tests/hour
50 probes/measurement | 500 free tests/hour*
500 probes/measurement |
| Get a measurement by ID | 2 requests/second/measurement | 2 requests/second/measurement |
| **Probes** |||
| List probes currently online | no limit | no limit |
| **Limits** |||
| Get current rate limits | no limit | no limit |
\*Additional measurements may be created by spending credits. Each test above the limit costs one credit. Learn more about credits on the Globalping website.
## Client guidelines
If you''re implementing an application that interacts with the API, please refer to the "Client guidelines"
section in the description of each endpoint. This way, you can provide the best UX and reduce the likelihood
of your app breaking in the future.
### General guidelines for non-browser-based apps:
- Set a `User-Agent` header. We recommend that you follow the format and approach used here.
- Set an `Accept-Encoding` header with a value of either `br` (preferred) or `gzip`, depending on what your client can support. Compression has a significant impact on the response size.
- Implement ETag-based client-side caching using the `ETag`/`If-None-Match` headers when requesting the measurement status.'
version: 1.0.0
termsOfService: https://github.com/jsdelivr/globalping
contact:
url: https://github.com/jsdelivr/globalping/issues
email: d@globalping.io
license:
name: Open Software License 3.0
identifier: OSL-3.0
servers:
- url: https://api.globalping.io
security: []
tags:
# --- truncated at 32 KB (114 KB total) ---
# Full source: https://artifacts.apis.io/globalping-io/openapi/globalping-io-measurements-api-openapi.yml