Lookery Developer Resources
Lookery is an advertising and user-targeting network offering lightweight, economical targeting data for every user on every web page. Lookery’s vision is to provide a service that accurately describes the demographic profile of every user on every webpage. Using Lookery API's, your site or application can now display some of Lookery's most powerful data.
The Lookery Population API (PAPI) lets publishers use the same anonymous user demographic data (age, sex and location) and custom attributes that are available on Lookery.com.
How do I get started?
- Read the Terms of Use and Branding Requirements to make sure your integration adheres to the fine print.
- Read the Technical Documentation below to get instructions for making Web Service calls.
- Register for a developer user account.
- Register your application to get your personal API key.
- Start coding — be sure to use your API_KEY to make your PAPI calls.
Please note that Lookery API's are routed via Mashery. You may receive some emails regarding the Lookery API via Mashery and not Lookery directly. Contact Lookery Support (help@lookery.com) if you have questions.
Technical Documentation & Code Samples
API interface:
PAPI uses a REST-like interface. This means that the client or advertiser sends requests over the internet to PAPI servers in the form of a HTTP GET request.
The Web Service is located at:
http://api.lookery.com/api/population/site/
Sample Call for thisnext:
http://api.lookery.com/api/population/site/?v=1&site=thisnext&timeframe=200808m&api_key=1234567890
PAPI Parameters:
| Name | Type | Required | Description |
| v | integer | Yes | API version identifier. Must be set to 1 to use this version of PAPI. |
| site | string | Yes | Lookery site name identifier |
| timeframe | string | Yes | Data time frame - ex. 200808m represents August 2008 |
| api_key | string | Yes | Each PAPI subscriber is uniquely identified by an ID sequence and every web request to PAPI requires this ID. |
Sample PAPI output:
<population_response>
<genders>
<gender>
<name>male</name>
<pct>21.89</pct>
<icon>http://cdn.lookery.com/i/api/male.png</icon>
</gender>
<gender>
<name>female</name>
<pct>78.11</pct>
<icon>http://cdn.lookery.com/i/api/female.png</icon>
</gender>
</genders>
<ages>
<age>
<name>18 - 24</name>
<pct>36.18</pct>
</age>
<age>
<name>25 - 34</name>
<pct>46.12</pct>
</age>
<age>
<name>35 - 44</name>
<pct>11.55</pct>
</age>
<age>
<name>45 - 54</name>
<pct>1.88</pct>
</age>
<age>
<name>55 - 64</name>
<pct>1.01</pct>
</age>
<age>
<name>65+</name>
<pct>0.56</pct>
</age>
</ages>
<countries>
<country>
<name>US</name>
<pct>73.93</pct>
<rank>1</rank>
<icon>http://cdn.lookery.com/i/api/flags/us.gif</icon>
</country>
<country>
<name>GB</name>
<pct>5.22</pct>
<rank>2</rank>
<icon>http://cdn.lookery.com/i/api/flags/gb.gif</icon>
</country>
....
....
....
<country>
<name>ES</name>
<pct>0.31</pct>
<rank>20</rank>
<icon>http://cdn.lookery.com/i/api/flags/es.gif</icon>
</country>
</countries>
<us_states>
<state>
<name>CA</name>
<pct>17.47</pct>
<rank>1</rank>
</state>
<state>
<name>NY</name>
<pct>9.66</pct>
<rank>2</rank>
</state>
....
....
....
<state>
<name>CT</name>
<pct>1.57</pct>
<rank>20</rank>
</state>
</us_states>
</population_response>
For a specified site (site=) and time frame (timeframe=), Lookery PAPI returns:
1. Visitor Demographics: Gender
<genders>
<gender>
<name>male</name>
<pct>21.89</pct>
<icon>http://cdn.lookery.com/i/api/male.png</icon>
</gender>
<gender>
<name>female</name>
<pct>78.11</pct>
<icon>http://cdn.lookery.com/i/api/female.png</icon>
</gender>
</genders>
2. Visitor Demographics: Age
<ages>
<age>
<name>18 - 24</name>
<pct>36.18</pct>
</age>
<age>
<name>25 - 34</name>
<pct>46.12</pct>
</age>
<age>
<name>35 - 44</name>
<pct>11.55</pct>
</age>
<age>
<name>45 - 54</name>
<pct>1.88</pct>
</age>
<age>
<name>55 - 64</name>
<pct>1.01</pct>
</age>
<age>
<name>65+</name>
<pct>0.56</pct>
</age>
</ages>
3. Visitor Location: Top 20 Countries
<countries>
<country>
<name>US</name>
<pct>73.93</pct>
<rank>1</rank>
<icon>http://cdn.lookery.com/i/api/flags/us.gif</icon>
</country>
<country>
<name>GB</name>
<pct>5.22</pct>
<rank>2</rank>
<icon>http://cdn.lookery.com/i/api/flags/gb.gif</icon>
</country>
....
....
....
<country>
<name>ES</name>
<pct>0.31</pct>
<rank>20</rank>
<icon>http://cdn.lookery.com/i/api/flags/es.gif</icon>
</country>
</countries>
Note: country name follows the two letter ISO 3166-1-alpha-2 standard.
4. Visitor Location: Top 20 U.S. States
<us_states>
<state>
<name>CA</name>
<pct>17.47</pct>
<rank>1</rank>
</state>
<state>
<name>NY</name>
<pct>9.66</pct>
<rank>2</rank>
</state>
....
....
....
<state>
<name>CT</name>
<pct>1.57</pct>
<rank>20</rank>
</state>
</us_states>
Lookery PAPI Branding Requirements
While Lookery PAPI is provided to you at no-cost, we require that you adhere to our branding requirements, as follows:
Attribution:
All input and output elements must be accompanied by clear “Lookery” attribution.
Links:
The following elements must be present and link to http://www.lookery.com using the standard linking format on your site.
- Any displayed metrics must cite “Lookery.com” as the source
- Any displayed metrics must provide an active link to http://www.lookery.com
Graphs & Logos
If Lookery data is used to create a graphical representation of Lookery metrics, a Lookery logo needs to be present within or adjacent to the graphic. Please use an approved Lookery logo. The logos cannot be reduced in size. It’s up to the discretion of the publisher where to specifically place the logo within or adjacent to the graphic.
80x25 PNG: 
80x25 Transparent PNG: 
122x24 PNG: 
Intended Usage and Restrictions
Please see our Terms of Use for details. By using Lookery API's, you signify your assent to the Terms of Use.
