PRODUCT
Follow

Weather API Extension

To allow for ease of integration and for optimal caching of Weather results, Peer39 Weather data is supported by the Peer39 Weather API Extension.

Note

Notes:

  • One hour cache cycle is recommended. (Maximum cache cycle is three hours.)

  • Response structure matches that of the Peer39 classification API response structure, though only the Weather category IDs will be returned.

  • Weather data will be returned upon First Look (RT=2) response.

Request Format

Structure:

http://hostname.api.peer39.net/proxy/geotargeting?cc=[clientCode]&ll=[Lat;Long]&ip=[IPv4]
          

Example:

http://acmeadvertising.api.peer39.net/proxy/geotargeting?
cc=NwK8OehiC9cSJEcpby6fbowEVshWUO5xu1soA45ThuI33=&ll=39.4143;77.4105
&ip=201.171.206.0
          

API Request Inputs & Parameters

Inputs & Parameters

Description

Syntax Examples and Notes

Hostname with Weather extension*

Hostname provided by Peer39.

http://acmeadvertising.api.peer39.net/proxy/geotargeting?

cc* (Client_Code)

Client Code (API Key) is a unique identifier for the account and provided by Peer39.

cc=NwK8OehiC9cSJEcpby6fbowEVshWUO5xu1soA45ThuI33=

ip* (IP_Address)

Mandatory for Weather Targeting Categories.

Holds the IP address of the user.

&ip=72.229.28.185

ll*(Latitude_and_Longitude)

(For future use.) Will be used for Weather Targeting categories to Mobile Users.

Contains a combination of two data points: Latitudinal and Longitudinal coordinates of a mobile user.

A combination of Two data elements, Latitude and Longitude, separated with a semicolon (;) delimiter, which MUST come as a pair of float numbers that can be either positive or negative.

&ll=40.740637;-73.996357

zp (Postal_Code)

(For future use.) Will be used to support additional geo-location- based targeting categories.

Contains the Postal code of a user.

This can be a 5-digit US-based zip-code or zip-code for other countries (may include alpha-numeric characters).

&zp=21702

*Mandatory API request Inputs & Parameters. If any are missing or syntax is incorrect, the result is a broken API call and/or Error Response (RT=1).

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments