Page tree
Skip to end of metadata
Go to start of metadata



Returns geographic location, proxy, host name and US region information for a given IP address.

URL Endpoints


JSON: 

https://trial.serviceobjects.com/GPP/web.svc/json/GetLocationByIP_V4?IPAddress={IPADDRESS}&LicenseKey={LICENSEKEY}


XML: 

https://trial.serviceobjects.com/GPP/web.svc/xml/GetLocationByIP_V4?IPAddress={IPADDRESS}&LicenseKey={LICENSEKEY}


GetGeoLocationByIP_V4 Inputs



Name

Type

Description

IPAddress

String

IP address to look up, for example, "209.85.173.104"

LicenseKey

String

Your license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/products/demographics-more/ip-address-validation


GetGeoLocationByIP_V4 Outputs


Name [1]

Type

Values

Description

Certainty

Int

0 to 100

Rating of how accurate the outputs are likely to be.

City

String

Varies

The city location of the IP address.

Region

String

Varies

The state location of the IP address.

Country

String

Varies

The country location of the IP address.

CountryISO3

String

Varies

The 3-letter country abbreviation.

CountryISO2

String

Varies

The 2-letter country abbreviation.

PostalCode*StringVariesThe US postal code of the IP address.
MetroCode*StringVariesThe numerical metropolitan code for the DMA of the IP address' location.
DMA*StringVariesThe Designated Market Area for the location of the IP address.
StateFIPS*StringVariesThe state Federal Information Processing Standards code for the IP address. This code is used to uniquely identify states.
CountyFIPS*StringVariesThe County Federal Information Processing Standards code for the location of the IP address. This code is used to uniquely identify counties throughout the US.

Latitude

Double

Varies

The latitude coordinate for the IP address.

Longitude

Double

Varies

The longitude coordinate for the IP address.

IsProxy

String

"TRUE" or "FALSE"

Indicates whether the IP address is a known proxy.

ProxyType [2]

String

"NONE", "PRIVATE", "PUBLIC", "ANONYMOUS", "SATELLITE"

Indicates the type of proxy. Further description of proxy type can be found in the table below

PossibleMobileDeviceString"TRUE" or "FALSE"Indicates if the IP address is believed to be used by mobile devices.

ISP

String

Varies

The ISP which assigns the IP address.

NetblockOwner

String

Varies

The network owner to which the IP address is allocated.

HostNamesStringVariesThe host name associated with the IP address. If more than one host name is found then the names will be returned a comma delimited list. Will return if no host names are found.
IPNoteCodesStringVariesDisplays additional notes about the IP that were found during the validation process. Returns zero or more numerical note codes in a comma-separated list.**
IPNotesStringVariesContains the note flag(s) that corresponds to the Notes Codes. Returns zero or more notes flags in a comma-separated list.**

Debug

String

Varies


Error

Error

Varies

See "Error Page".

*Applies only to IP addresses located within the United States
**New codes and descriptions will be added as new features become available and the number of codes will increase in time.

References

  1. ^ IP Address Validation: What Can I Learn From an IP Address?

  2. ^ Identify Tor Network Users with DOTS IP Address Validation



  • No labels