EdgeScape

Identify the geographic location and network characteristics of your users.

EdgeScape is Akamai’s IP intelligence service. It enables e-businesses to drive targeted business strategies online. Customers can get access to EdgeScape data in two ways:

  • Standalone EdgeScape
    With this product, you can access EdgeScape data by running Akamai's EdgeScape Facilitator within your infrastructure. The Facilitator handles DB auto-updates, includes an API interface, and allows your origin to quickly lookup geolocation, network, and security information from connected client IPs. Standalone EdgeScape comes in three “flavors”:

    • EdgeScape Standard - limited attributes, single application

    • EdgeScape Pro - all attributes, single application

    • EdgeScape Pro Enterprise - all attributes, multiple applications

  • On the Edge
    This method is known as content targeting. This allows you to apply business and geolocation rules to specific end users by using a subset of information to run logic at the Edge. You can also forward that information to the origin using an HTTP header.

Benefits

  1. Apply regional download policies to specific countries.

  2. Provide different types of user experiences dynamically based on a user's geolocation (ie. provide a localized version of a website for people in a given country like www.example.es for people in Spain or www.example.fr for people in France).

  3. Provide different types of user experiences dynamically based on the user's network connection (ie. cellular/non-cellular, low/high bandwidth, etc.).

  4. Pre-populate online forms with information relevant to users (ie. a list of phone area codes, ZIP codes, city, state, etc.) based on the IP geolocation of the user.

IP Address Attributes

The following attributes are available for an IP Address. Possible values for each attribute can be found on the EdgeScape Data Codes page (login to Akamai Control Center required).

Attribute

Type

Description

continent

string

Two-letter code for the continent associated with the IP address.

country_code

string

An ISO-3166, two-letter code for the country.

region_code

string

The state, province, or region code.

*city

string

The city (within a 50-mile radius).

*dma

string

A number representing the DMA® . DMA® is a registered service mark of The Nielsen Company, all rights reserved.

*msa

string

A number representing the Metropolitan Statistical Area.

*pmsa

string

A number representing the Primary Metropolitan Statistical Area.

*areacode

string

The area code (multiple values possible).

Note: Multiple values will be separated by the plus (+) character.

*lat

string

The latitude

*long

string

The longitude

*county

string

The county (multiple values possible).

Note: Multiple values will be separated by the plus (+) character.

*timezone

string

The time zone. Daylight Saving Time is not accounted for.

*zip

string

The zipcode (multiple values possible). Only available for the US and Canada.

For US: All zip codes for the city are returned, Contiguous zip codes will be represented as a range of the form “FirstZipInRange-LastZipInRange.” Multiple ranges may be present (with each range separated by the plus (+) character). For example, the following strings are all valid zip values:

10001

10001+10003

10001-10003+10005

10001-10003+10005-10008

For Canada: FSA (Forward Sortation Area) is returned; all FSAs for the city are returned, separated by the plus (+) character. 

network

string

The network that the IP address belongs to.

network_type

string

The network type.

asnum

string

The AS (autonomous system) number to which the IP belongs.

throughput

string

The actual connection speed.

Note: This attribute is not supported for IPv6 addresses and will always be set to low.

bw

integer

Provides additional granularity to the throughput field.

Note: This attribute is not supported for IPv6 addresses and will always be set to low.

*proxy

string

Indicates whether the IP address is a proxy and if it is, which type of proxy, transparent or anonymous.

*company

string

The company to which the IP address belongs.

*domain

string

The domain of the IP address.

tunnel

string

Indicates if the IP address is a Teredo or 6to4 address. The possible values are teredo or 6to4.

Note: This attribute will only be available when querying for IPv6 addresses.

georegion

integer

This attribute is internal to Akamai and should not be used by any customers.

* Denotes attributes only available with the EdgeScape Pro service. All EdgeScape Pro attributes are available in Content Targeting, with the exception of company, domain, and tunnel.

The entire IP address space is represented in the database and always has a country code associated with it. All other elements in the database, including region code, are optional and may not necessarily be associated with an IP address. In addition, for AOL IP addresses, only country information will be returned.

However, if the IP address is in the reserved IP space (as designated by the Internet Assigned Numbers Authority), every attribute has a value of “reserved”.