Data Extracts Definitions

iOS Extracts*

Standard Fields

Field Name in Definition Data Date Max Field

Extract Type Available** Size
test_id A unique ID for every speedtest performed number 12/1/2008 11
based on the platform.
iphone_device_id Each individual device is assigned a unique ID, number 12/1/2008 11
which is tied to all the tests taken on the
device.
test_date Date and time of the test in Pacific time zone datetime 12/1/2008 19
(GMT -8).
client_ip_address This is the IP address from which the request text 12/1/2008 15
to Ookla's reporting API was generated. The
last octet of the user's external IP address is
masked for addresses that are not on your
network. Full IP addresses are available for
your customers. Devices behind networks
with carrier grade NAT may appear to share
the same IP address.
download_kbps The result of the download portion of the number 12/1/2008 11
test, measured in kilobits per second.
upload_kbps The result of the upload portion of the test, number 12/1/2008 11
measured in kilobits per second.
latency The result of the latency portion of the test, number 12/1/2008 6
measured in milliseconds.
server_name The name of the server used for the test. This text 12/1/2008 255
is typically the city where the server is
located.
server_country The country where the server used for the text 12/1/2008 255
test is located.
server_country_ The two letter country code (ISO 3166-1 text 12/1/2008 2
code alpha-2) of where the test server is located.
server_latitude The latitude of the server used for the test. number 12/1/2008 10
server_longitude The longitude of the server used for the test. number 12/1/2008 10

1
server_sponsor_ The name of the test server sponsor. text 12/1/2008 255
name Combining server name and server sponsor
will create a unique name for each server.
client_country The country where the device is located. text 12/1/2008 255
client_country_ The two letter country code (ISO 3166-1 text 12/1/2008 2
code alpha-2) of where the device was located.
client_region_ The region within a country where the test text 12/1/2008 255
name was conducted. How each country is divided
into regions varies country to country, but
this is typically the top level region as
described in ISO-3166-2. If this field is labeled
unknown and the field location type equals 2,
we were unable to confidently assign a region
to the record and the location is only accurate
to the country level.
client_region_code The ISO-3166-2 region code of where the test text 12/1/2008 3
was conducted.
client_city The city where the test was conducted. If this text 12/1/2008 255
field is labeled unknown and the location type
field equals 2, we were unable to confidently
assign a city to the record and is only accurate
to the region level.
client_latitude The latitude of the device conducting the test. number 12/1/2008 10
If location type equals 2, this value is
approximate.
client_longitude The longitude of the device conducting the number 12/1/2008 10
test. If location type equals 2, this value is
approximate.
miles_between Distance (in miles) between user and location number 12/1/2008 9
of server.
pre_connection_ A number representing the device's text 12/1/2008 4
type connection type as detected at the start of
the test.

0 = Unknown, 1 = Cell, 2 = Wi-Fi, 3 = GPRS, 4 =

EDGE, 5 = WCDMA, 6 = HSDPA, 7 = HSUPA, 8
= CDMA1x, 9 = CDMAEVDORev0, 10 =
CDMAEVDORevB, 11 = eHRPD, 12 = LTE, 13 =
Ethernet, 14 = Bluetooth, 15 = HRPD, 16 =

2
 CDMAEVDORevA

"Standard" extracts recipients receive

everything but wifi data (#2). "Advanced"
extracts recipients receive all fields.
post_connection_ A number representing the device's number 9/1/2013 4
type connection type as detected at the test's
completion.

0 = Unknown, 1 = Cell, 2 = Wi-Fi, 3 = GPRS, 4 =

EDGE, 5 = WCDMA, 6 = HSDPA, 7 = HSUPA, 8
= CDMA1x, 9 = CDMAEVDORev0, 10 =
CDMAEVDORevB, 11 = eHRPD, 12 = LTE, , 13 =
Ethernet, 14 = Bluetooth, 15 = HRPD, 16 =
CDMAEVDORevA

"Standard" extracts recipients receive

everything but wifi data (#2). "Advanced"
extracts recipients receive all fields.
isp_name The name of the device's ISP, derived from text 12/1/2008 255
the IP address in the client_ip_address field.
is_isp A best effort determination if the number 12/1/2008 1
organization associated with the IP address is
an internet service provider or some other
kind of organization, such as a government,
university, or large corporation. 1 = ISP, 0 =
Not ISP.
network_operator Home carrier name associated with IP text 2/1/2011 255
_name Address. This does not change when the
device is roaming.
iso_country_code The two letter country code (ISO 3166-1 number 2/1/2011 255
alpha-2) of the country where the device was
originally registered.
mcc Mobile Country Code (MCC) is a three digit text 2/1/2011 3
code specific to the country where the
network operator is located. A list of code
and countries can be found here.
mnc The mobile network code (MNC) for the text 2/1/2011 3
current network operator. A two to three
digit identifier specific to a network operator

3
 within a given country. When combined with
the Mobile Country Code, each mobile
network can be uniquely identified. A fairly
comprehensive list of MNCs can be found
here, but each country regulates their MNCs
individually, so codes may appear or change
without any notice.
model The common name of the device model. Ex. text 8/1/2011 255
iPhone 7, iPhone 6 Plus, iPad Mini
version The iOS version number on the device. text 8/1/2011 255
location_type The method used to determine the device's text 8/1/2011 3
location. Whenever possible, the
speedtest.net mobile application uses the
device's location services to determine an
accurate latitude and longitude of the device.
However, in an effort to maintain a quick and
easy user experience, if the device's location
services are either unavailable or unable to
return an accurate location within a few
seconds, we fall back to using third party
Geo-IP location services.

0 = Unknown, 1 = GPS / device location

services, 2 = Geo-IP.
gmaps_formatted_ Full location name including city, county, text 3/31/2016 100
address region, and country, if available.
gmaps_name Unabbreviated location name; typically the text 3/31/2016 100
city where the test is taken.
gmaps_type Locality where test is taken. This is typically text 3/31/2016 100
an incorporated city or town political entity.
gmaps_country Country where test is taken. text 3/31/2016 100
gmaps_country_ Country code where test is taken. text 3/31/2016 100
code
gmaps_region Region name where test is taken. This is the text 3/31/2016 100
first-order civil entity in a country level.
Depending on the country, these are states,
provinces, or territories, etc.
gmaps_subregion Region name where test is taken. This is the text 3/31/2016 100
second-order civil entity in a country level.

4
 Depending on the country, these are
county-level names. Not all countries display
this information.
gmaps_subsubregi Region name where test is taken. This is the number 3/31/2016 250
on third-order civil entity in a country level.
Depending on the country, these are the level
under counties. Not all countries display this
information.
gmaps_postal_ Postal code for the test location. The postal text 3/31/2016 100
code code is that same as what is used to address
mail within the country.
client_ipv6_addres Speedtest user's IPV6 address. We mask IP string 5/1/2018 64
s addresses for end users privacy, but show
enough to allow clients to see which provider
is offering the user's internet service.

Please refer to "test_method_a" to see with

IP address the test was taken over.

Advanced Fields

Field Name in Definition Data Date Max Field

Extract Type Available** Size
app_version_a User's Speedtest app version on iOS when number 4/1/2015 11
the Speedtest is taken.
altitude_a User's altitude at time of test, relative to sea number 3/1/2013 6
level.
timezone_name_a Name of user's time zone at location of test. text 3/1/2013 50
timezone_offset_a User's timezone offset relative to GMT, in text 3/1/2013 9
seconds.
test_method_a The communication protocol used by the number 8/1/2014 3
test. Whenever possible, the test makes a
direct TCP connection with the testing server,
which allows for greater testing accuracy,
especially at higher speeds. In instances
where the device is unable to establish a TCP
connection with the test server on the
appropriate port, the test falls back to using

5
 basic HTTP file transfers to determine the
device's bandwidth.

1 = HTTP, 2 = TCP, 5 = HTTP-IPV6,

6 = TCP-IPV6
ploss_sent_a The number of packages sent to host server number 8/1/2016 5
from device. To determine packet loss
percentage, take the ploss_recv divided by
ploss_sent. 100% means zero packet loss
since 100% of the packets were sent and
received.
ploss_recv_a The number of packages received by the host number 8/1/2016 5
server from device. To determine packet loss
percentage, take the ploss_recv divided by
ploss_sent. 100% means zero packet loss
since 100% of the packets were sent and
received.
jitter_a The variance in latency over time which number 8/1/2016 4
determines the stability of the internet
connection.
wifi_bssid_a The media access control address (MAC) text 9/1/2011 50
address of the wifi Chipset running on the
wireless access point to which the device is
connected.
tr_ip_0_a This is the IP address of the first hop of text 1/1/2016 15
traceroute during a test.
tr_latency_a The time taken for the packet to be received number 1/1/2016 5
after the first hop in the traceroute.
tr_ip_1_a This is the IP address of the second hop of text 1/1/2016 15
traceroute during a test.
tr_latency_1_a The time taken for the packet to be received number 1/1/2016 5
after the second hop in the traceroute.
ookla_carrier_nam Mobile operator name as determined by text 10/2/2018
e_a Ookla based on our research on how the
operator is marketed
ookla_device_nam Mobile device name as determined by Ookla text 10/2/2018
e_a based on our research on how the operator
is marketed

6
download_kb_a The bytes used during a test for the number 10/2/2018
download portion, in kilobytes
upload_kb_a The bytes used during a test for the upload number 10/2/2018
portion, in kilobytes

*last updated 8/27/2018

**data in extracts before the date available will be blank or say “NULL”