API Guide







Get Analytics Geolocation

This API provides a breakdown of opens by geolocation.

Required headers: X-API-KEY
Optional headers: ACCEPT (json, xml, csv, serialized)
Method: GET

Endpoint URL:

https://api.250ok.com/api/1.0/analytics/geolocation

Sample Output:

[  
    {  
        "name":"Brazil",
        "abbreviation":"BR",
        "count":44210,
        "regions":[
            {  
                "name":"Rio de Janeiro",
                "count":6276,
                "latitude":-22.908298,
                "longitude":-43.197098
            }...
        ]
    },
    {  
        "name":"United States",
        "abbreviation":"US",
        "count":18455,
        "regions":[  
            {  
                "name":"California",
                "count":3281,
                "latitude":33.6839,
                "longitude":-117.79499
            }...
        ]
    }...
]
        

Parameters

Parameter Description Acceptable Values Required
startdate Includes activity after the specified date. If unspecified, will default to 30 days prior. yyyy-mm-dd N
enddate Includes activity detected before the specified. If unspecified, will default to the current date. yyyy-mm-dd N

Error Responses

Description Code Cause
No results found. 404 We couldn't find any results matching your criteria.
Invalid start date format. 404 The start date provided was submitted in an invalid format.
Invalid end date format. 404 The end date provided was submitted in an invalid format.