Get Audience Data

Returns the audience data. The output of each ID-type is an account-level permission that will need to be turned on by StatSocial.

Warning

Starting from 01.03.2023, the endpoint will stop sending information about downloads. To get links for audience file downloads please use the Get Audience File Download endpoint.

Getting Started

URL REQUEST (GET)

https://api.statsocial.com/platform/v0/audiences/{audience_id}

Let's go to example

In this example we will search for an audience with affinities

note

We create this audience in this example

https://api.statsocial.com/platform/v0/audiences/67454

We will receive a json like this

{
    "response": {
        "id": 67454,
        "name": "Name Audience",
        "description": "audience description",
        "created_by": 1,
        "created_at": "2023-03-06T16:14:41Z",
        "build_status": "finished",
        "raw_emails": {
            "count": 56183,
            "download_url": "https://statsocial-ab2.s3.amazonaws.com/2023/3/6/e20164cddb.email_raw?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAYVNEWUNW5DFZHGEK%2F20230307%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230307T150249Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3D%22Name%20Audience_e20164cddb.email_raw%22&X-Amz-Signature=86203d6899948a4aad6b32505bece22dc7e1a4948210591cfdc86b25d9821e71",
            "key": "/2023/3/6/e20164cddb.email_raw"
        },
        "audience_reach": {
            "count": 429570,
            "download_url": "https://statsocial-ab2.s3.amazonaws.com/2023/3/6/e20164cddb.ssid?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAYVNEWUNW5DFZHGEK%2F20230307%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230307T150249Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3D%22Name%20Audience_e20164cddb.ssid%22&X-Amz-Signature=374dadc8004040757f5477843752c1c8506997094bc0edb07905f9cd6c005d34",
            "key": "/2023/3/6/e20164cddb.ssid"
        },
        "md5s": {
            "count": 71394,
            "download_url": "https://statsocial-ab2.s3.amazonaws.com/2023/3/6/e20164cddb.md5lower?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAYVNEWUNW5DFZHGEK%2F20230307%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230307T150249Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3D%22Name%20Audience_e20164cddb.md5lower%22&X-Amz-Signature=bb15cb804951b25ac8542af3864cffb0145e448634170d7da5e1ff1f56bf38e4",
            "key": "/2023/3/6/e20164cddb.md5lower"
        },
        "cint": {
            "count": 224,
            "download_url": "https://statsocial-ab2.s3.amazonaws.com/2023/3/6/e20164cddb.cint_id?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAYVNEWUNW5DFZHGEK%2F20230307%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230307T150249Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3D%22Name%20Audience_e20164cddb.cint_id%22&X-Amz-Signature=e77b16de52fbc7b607b0f7a8384c0a5659e71c2d6f80b713fb1e7cb4e228b5e4",
            "key": "/2023/3/6/e20164cddb.cint_id"
        },
        "twitter_ids": {
            "count": 349818,
            "download_url": "https://statsocial-ab2.s3.amazonaws.com/2023/3/6/e20164cddb.twitter_id?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAYVNEWUNW5DFZHGEK%2F20230307%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230307T150249Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3D%22Name%20Audience_e20164cddb.twitter_id%22&X-Amz-Signature=896fa4831098c268f1c4a441699cb139c8546866245e8640fbb2d125039b3d43",
            "key": "/2023/3/6/e20164cddb.twitter_id"
        },
        "twitter_usernames": {
            "count": 339896,
            "download_url": "https://statsocial-ab2.s3.amazonaws.com/2023/3/6/e20164cddb.twitter_username?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAYVNEWUNW5DFZHGEK%2F20230307%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230307T150249Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3D%22Name%20Audience_e20164cddb.twitter_username%22&X-Amz-Signature=036b5a8e48c529d6e918c8a61a2486acd71f78af19f1848bd743e8efb520185e",
            "key": "/2023/3/6/e20164cddb.twitter_username"
        }
    },
    "information": {
        "version": "0.0.1"
    }
}