Developer API documentation

Demographics calls

The demographics endpoints provide a snapshot of the current age and gender breakdown of an artist (currently limited to myspace fan demographic information). This data is provided as the percentage of fans that are a given age, with one year bins covering 13 - 68 years old. To get gender breakdowns, a qualifier key/value pair of gender=[male|female] will return a similar result, but filtered to include only the selected gender. Another endpoint provides the male v. female gender breakdown without age bins.

Additional location demographics are available as Top cities and countries

endpoints

age, myspace:
http://api.semetric.com/artist/<id>/demographics/myspace/age?token=YOURAPIKEY[&gender=[male|female]
gender, myspace:
http://api.semetric.com/artist/<id>/demographics/myspace/gender?token=YOURAPIKEY

examples

Age breakdown of Lady Gaga’s fans,

http://api.semetric.com/artist/fe66302b0aee49cfbd7d248403036def/demographics/myspace/age?token=YOURAPIKEY :

{
"response": {
    "data": [
        {
            "age": 13,
            "percent": 0.0686
        },
        {
            "age": 14,
            "percent": 0.1466
        },
        {
            "age": 15,
            "percent": 0.3074
        },
        {
            "age": 16,
            "percent": 0.9103
        },
        {
            "age": 17,
            "percent": 2.4353
        },
        {
            "age": 18,
            "percent": 5.0433
        },
        ...
    ]
},
"success": true
}

And the age breakdown of Lady Gaga’s female fans,

http://api.semetric.com/artist/fe66302b0aee49cfbd7d248403036def/demographics/myspace/age?token=YOURAPIKEY&gender=female

{
"response": {
    "data": [
        {
            "age": 13,
            "percent": 0.0497
        },
        {
            "age": 14,
            "percent": 0.0969
        },
        {
            "age": 15,
            "percent": 0.2246
        },
        {
            "age": 16,
            "percent": 0.7495
        },
        {
            "age": 17,
            "percent": 1.9625
        },
        {
            "age": 18,
            "percent": 3.8989
        },
        ...
    ]
},
"success": true
}

Finally, here is the overall gender breakdown of Jay-Z’s fans on myspace,

http://api.semetric.com/artist/0345e8df96524fe1829f9771e6afab64/demographics/myspace/gender?token=YOURAPIKEY :

{
"response": {
    "data": [
        {
            "count": 22066,
            "gender": "Male"
        },
        {
            "count": 12499,
            "gender": "Female"
        }
    ]
},
"success": true
}