There is a single API call for retrieving Probe data samples.
Required Parameters:
ids
At least one PROBE_ID must be specified. Up to 20 PROBE_IDs can be specified in each request. Multiple ids can be formatted as either a comma separated string or an array represented by multiple HTTP parameters named “ids[ ]”
Optional Parameters:
starttime
An integer unix timestamp (seconds since epoch) representing the beginning of your query timeframe.
endtime
An integer unix timestamp (seconds since epoch) representing the end of your query timeframe.
keys
A list of keys you want to include (see ‘Probe Sample Keys’ below). This can either be a comma separated string or an array represented by multiple HTTP parameters named “keys[ ]”. Default: “l_l, l_s, l_u, l_h”
sample_size
Override the default sample size that is determined by the starttime/endtime range. This will only work if you specify a sample_size larger than that automatically calculated for the time range. If you specify a smaller sample_size, the default sample_size will be used.
Note: If starttime and endtime both are not provided, the last 5 minutes of samples are returned. Also, if the frequency of probe is greater than the duration specified for samples, the request will not return any samples.
Probe Sample Keys
Note:
the prefacing ‘l_’ means ‘latest’; return most recent sample data.
the prefacing ‘s_’ means ‘separated’; return data from individual components
Probe Sample Abbreviations
Example 1
Obtain samples from one probe, specifying only the PROBE_ID.
CURL Command, and variations:
CURL Response:
Response is a JSON-encoded array with a single Probe Sample Hash:
Example 2
Obtain samples from two probes, specifying sample_size of 60. Default keys.
CURL Command, and variations:
CURL Response:
Response is a JSON-encoded array of Probe Sample Hashes, in this case, with 60 seconds data:
Example 3
Obtain samples from a single probe, specifying starttime, endtime, and sample_size of 60 seconds. Default keys.
CURL Command, and variations:
CURL Response:
Response is a JSON-encoded array with a single Probe Sample Hash:
Example 4
Obtain samples from one probe, specifying sample_size of 60, and the keys l, lp, l_s, u, l_h and l_ss.
CURL Command, and variations:
CURL Response:
Response is a JSON-encoded array with a single Probe Sample Hash:
Note: Latency percent arrays contain only three values: connect, time for the first byte, and transfer.
Example 5
Obtain all station data for one probe, specifying sample_size of 60, and the keys s_l, s_s, s_u, and s_h.
CURL Command, and variations:
CURL Response:
Response is a JSON-encoded array with a single Probe Sample Hash: