Skip to main content

Get raw data via API

Natalya Yefimenko avatar
Written by Natalya Yefimenko
Updated over a week ago

You can get raw data about clicks, installs, events, and conversions via API to make further use of it. Raw statistics provides granular, unaggregated data that enables deeper analysis, customization, and integration with other systems.

Get clicks

Method: GET
​Url: https://restapi.affattr.com/v1/report/raw/clicks

Headers: API-KEY

Params:

  • pagination.limit (uint) - limit

  • pagination.offset (uint) - offset

  • time_window.from_rfc3339 (string) - example:2022-01-01T12:00:27.87+00:20

  • time_window.from.seconds (uint) - timestamp - higher priority than from_rfc3339

  • time_window.from_not_include bool - if checked "time > from" else "time >= from"

  • time_window.to_rfc3339 (string) - example:2022-01-01T12:00:27.87+00:20

  • time_window.to.seconds (uint) - timestamp - higher priority than to_rfc3339

  • non_organic_only (boolean)

⚠️ time_window must be defined.

API response example:​

{
"clicks": [
{
"click_id": "c3dc042f-122d-415c-8289-ffdf32ebd6bd",
"created_at": {
"seconds": 1726132891
},
"subs": {},
"geo": {
"country": "GB",
"region": "London",
"city": "London",
"isp": "?"
},
"ip": "88.214.187.100",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:130.0) Gecko/20100101 
Firefox/130.0",
"app_id": 6005,
"pub_click_id": "{clickid}",
"original_params": {
"clickid": "{clickid}",
"format": "json",
"pid": "108"
}


Get installs

Method: GET
​URL: https://restapi.affattr.com/v1/report/raw/installs

Headers: API-KEY

Params:

  • pagination.limit (uint) - limit.

  • pagination.offset (uint) - offset.

  • time_window.from_rfc3339 (string) - example:2022-01-01T12:00:27.87+00:20.

  • time_window.from.seconds (uint) - timestamp - higher priority than from_rfc3339.

  • time_window.from_not_include bool - if checked "time > from" else "time >= from".

  • time_window.to_rfc3339 (string) - example:2022-01-01T12:00:27.87+00:20.

  • time_window.to.seconds (uint) - timestamp - higher priority than to_rfc3339.

  • non_organic_only (boolean).

⚠️ Time window must be defined.

​API response example:

{
"info": [
{ "device": {
"affise_device_id": "310d8335-80b1-4849-8925-ef54126004af",
"random_user_id": "b2080f39-f9e1-4f7e-bc42-8863dfe028d5",
"first_open_time": {
"seconds": 1696156153
},
"app_id": 1,
"affise_pkg_app_name": "com.itbxp.surf",
"partner_id": 10,
"device_parameters": {
"platform": "android",
"device_name": "5058",
"device_type": "smartphone",
"os_name": "Nougat",
"os_version": "7.0",
"android_id": "421a9e99321086d6",
"gaid_adid": "d8313cad-070f-4c0e-824f-bb58d7be5acf",
"referrer": "referrer=4107abce-890d-4098-b83b-01d9bdc195d4&clickid=651949b9660c680001ef66c8&pid=10"
},
"click_affise": {
"click_id": "4317abce-990d-4098-b83b-01d9bdc195d4",
"created_at": {
"seconds": 1696156090
},
"subs": {},
"geo": {
"country": "ID",
"region": "Jawa Timur",
"city": "Tamansari",
"isp": "?"
},
"ip": "2001:448a:5139:1985:5d62:4fe6:118d:9c12",
"user_agent": "Mozilla/5.0 (Linux; Android 7.0; 5058 Build/NRD90M; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/117.0.0.0 Mobile Safari/537.36 agentweb/4.0.2 UCBrowser/11.6.4.950",
"pub_click_id": "652949b9660c680001ef66c8"
}
},
"uuid": "924ee319-6e6d-44f3-9449-08d4b4dd1300",
"timestamp": {
"seconds": 1696156248
},
"geo": {
"country": "ID",
"region": "ID",
"isp": "IND TELKOMSEL"
},
"ip": "2001:448a:2130:1985:5d62:4fe6:118d:9c12",
"created_at": {
"seconds": 1696156279
}
}

Get events

Method: GET
​URL: https://restapi.affattr.com/v1/report/raw/events

Headers: API-KEY

Params:

  • pagination.limit (uint) - limit.

  • pagination.offset (uint) - offset.

  • time_window.from_rfc3339 (string) - example:2022-01-01T12:00:27.87+00:20.

  • time_window.from.seconds (uint) - timestamp - higher priority than from_rfc3339.

  • time_window.from_not_include bool - if checked "time > from" else "time >= from".

  • time_window.to_rfc3339 (string) - example:2022-01-01T12:00:27.87+00:20.

  • time_window.to.seconds (uint) - timestamp - higher priority than to_rfc3339.

  • non_organic_only (boolean).

⚠️ Time window must be defined.

API response example:​

{
"events": [
{
"info": {
"device": {
"affise_device_id": "8f29848f-ecfa-49f2-93a7-d2d484a13515",
"random_user_id": "071dcb20-1826-47ff-a310-e84ab4a673a1",
"first_open_time": {
"seconds": 1696122018
},
"app_id": 1,
"affise_pkg_app_name": "com.itbxp.surf",
"is_organic": true,
"device_parameters": {
"platform": "android",
"device_name": "i55C",
"device_type": "smartphone",
"os_name": "Nougat",
"os_version": "7.0",
"android_id": "e627c254f84cd9a9",
"gaid_adid": "0ed20689-2435-4816-ab58-e2bc03639ecb",
"referrer": "referrer=8ba10af2-4cc9-4cda-806f-47181d47fcef&clickid=65176bfb55c3260001bad183&pid=10"
}
},
"uuid": "0f8e8e41-3b1e-4981-b36d-f919dc15f7ca",
"timestamp": {
"seconds": 1696122034
},
"geo": {
"country": "ID",
"region": "ID",
"isp": "Indosat Ooredoo"
},
"ip": "2001:448a:3041:2d33:b900:e218:be45:ae55",
"created_at": {
"seconds": 1696122079
}
},
"created_at": {
"seconds": 1696122079
},
"id": "afbcac17-4a0a-4df8-9acd-d0b7706185b9",
"name": "ContentItemsView",
"category": "native",
"timestamp": {
"seconds": 1696122019
},
"user_data": "shortcuts",
"data":"{\"affise_event_content_items_view\":[{\"title\":\"News\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32107\"},{\"title\":\"Kids\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32102\"},{\"title\":\"Goods\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32100\"},{\"title\":\"Utilities\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32110\"},{\"title\":\"Fun\",\"url\":\"https://appspress.g2afse.com/click?pid=127\&offer_id=32098\"},{\"title\":\"Food\",\"url\":\"https://appspress.g2afse.com/click?pid=127\&offer_id=32097\"}]}"
}

🔍 Also, you can get only selected event or events via API. To do this, add the event name in the API request or add multiple events, separated by commas using the event_names parameter.
​
For example:
​https://restapi.affattr.com/v1/report/raw/events?event_names=Purchase

https://restapi.affattr.com/v1/report/raw/events?event_names=Purchase,Login

Get conversions

Method: GET
​URL: https://restapi.affattr.com/v1/report/raw/conversions

Headers: API-KEY

Params:

  • pagination.limit (uint) - limit.

  • pagination.offset (uint) - offset.

  • time_window.from_rfc3339 (string) - example:2022-01-01T12:00:27.87+00:20.

  • time_window.from.seconds (uint) - timestamp - higher priority than from_rfc3339.

  • time_window.from_not_include bool - if checked "time > from" else "time >= from".

  • time_window.to_rfc3339 (string) - example:2022-01-01T12:00:27.87+00:20.

  • time_window.to.seconds (uint) - timestamp - higher priority than to_rfc3339.

  • non_organic_only (boolean).

⚠️ Time window must be defined.

API response example:

⚠️ The example includes additional values that you can get if you pass them via the referrer.

{
"conversions": [
{
"event": {
"info": {
"device": {
"affise_device_id": "6f9491d3-000a-1000-0f45-58674f4c7485",
"random_user_id": "6f9000ee-018a-1000-8c19-58a34e8a8d72",
"first_open_time": {
"seconds": 1694089122,
"nanos": 256000000
},
"app_id": 129,
"affise_pkg_app_name": "com.affise.app",
"device_parameters": {
"platform": "android",
"device_name": "sdk_gphone_x86_64",
"device_type": "smartphone",
"os_name": "Android11",
"os_version": "11",
"android_id": "b6ea55ccaee29142",
"referrer": "referrer=4c5a6cff-4a76-4518-b2b7-a9d21abbd8ca&clickid=640f91362bc1a20001646bd7&pid=85"
},
"click_affise": {
"click_id": "4c9a6cff-4a76-4518-b2b7-a9d90abbd0ca",
"created_at": {
"seconds": 1694089122
},
"subs": {
"sub1": "s1",
"sub2": "s2",
"sub3": "s3",
"sub4": "s4",
"sub5": "s5"
},
"geo": {
"country": "UK"
},
"ip": "127.0.0.1",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.51 Safari/537.36",
"campaign_id": "123",
"campaign_name": "cname",
"network_id": "123",
"network_name": "nname",
"tracker_id": "123",
"tracker_name": "tname",
"creative_id": "123",
"pub_click_id": "640f91362bc1a20001646bd7",
"partner_name": "pname"
}
},
"uuid": "f5a01792-018a-1000-bd27-633c0f2d5839",
"timestamp": {
"seconds": 1696338024
},
"geo": {
"country": "US",
"region": "US"
},
"ip": "188.17.96.239",
"user_agent": "Dalvik/2.1.0 (Linux; U; Android 11; sdk_gphone_x86_64 Build/RSR1.201211.001)",
"created_at": {
"seconds": 1696338042,
"nanos": 67913469
}
}
},
"created_at": {
"seconds": 1696338026
},
"id": "5c8791a4-3a4f-41aa-9319-225a30f847e5",
"conversion_type": "install",
"currency": "USD"
}
]
}{

Get installs and events based on unique device parameters

You can get installs and events via API based on unique device parameters:

  • gaid_adid

  • affise_device_id

  • random_user_id

  • click_id

For this, use the request parameters:
​devices_search.gaid_adid={value}
devices_search.affise_device_id={value}
devices_search.random_user_id={value}
devices_search.click_id={value}



Get install by device search

Install request example:
​https://restapi.affattr.com/v1/report/raw/installs?devices_search.affise_device_id=206be830-2dc3-4ecb-8298-5d9f8c9d06b6
​
Install response example:
​{

"info": [

{

"device": {

"affise_device_id": "206be830-2dc3-4ecb-8298-5d9f8c9d06b6",

"random_user_id": "206be830-2dc3-4ecb-8298-6y0f0c9d06m5",

"first_open_time": {

"seconds": 1763096936

},

"app_id": 1,

"affise_pkg_app_name": "com.abc.xyz",

"is_organic": false,

"device_parameters": {

"platform": "ios",

"device_name": "iPhone",

"device_type": "smartphone",

"os_name": "iOS",

"os_version": "18.5"

}

},

"uuid": "80c55021-019a-1000-af27-b2a8a8bac4af",

"timestamp": {

"seconds": 1763096936

},

"geo": {

"country": "CA",

"region": "Alberta",

"isp": "?"

},

"ip": "2604:3d09:c8a:7c00:49c:2ca0:eef7:759c",

"created_at": {

"seconds": 1763096945

},

"received_at": {

"seconds": 1763096936

}

}

]

}


Get event by device search

Event request example:
​https://restapi.affattr.com/v1/report/raw/events?devices_search.affise_device_id=a8053274-0194-1000-b836-1c5f2e4eccc4
​
​
Event response example:

{

"events": [

{

"info": {

"device": {

"affise_device_id": "a8053274-0194-1000-b836-1c5f2e4eccc4",

"random_user_id": "a8053274-0194-1000-9c6a-1c12a1ce4eef",

"first_open_time": {

"seconds": 1737985700

},

"app_id": 1,

"affise_pkg_app_name": "com.abc.xyz",

"partner_id": 100,

"is_probabilistic": true,

"device_parameters": {

"platform": "ios",

"device_name": "iPhone",

"device_type": "smartphone",

"os_name": "iOS",

"os_version": "18.1.1"

},

"click_affise": {

"click_id": "23b9f90f-c513-4bf0-987a-7dc8809d7d1d",

"created_at": {

"seconds": 1737985990

},

"subs": {

"sub1": "123"

},

"geo": {

"country": "ZA",

"region": "Gauteng",

"city": "Bryanston",

"isp": "?"

},

"ip": "196.39.73.119",

"user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_1_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/22B91 [FBAN/FBIOS;FBAV/496.0.0.23.103;FBBV/684558567;FBDV/iPhone15,4;FBMD/iPhone;FBSN/iOS;FBSV/18.1.1;FBSS/3;FBID/phone;FBLC/en_GB;FBOP/5;FBRV/689356278;IABMV/1]",

"app_id": 1,

"pub_click_id": "67978dd1486c150001539fa1",

"original_params": {

"af_ad": "",

"af_ad_id": "",

"af_adset": "",

"af_adset_id": "",

"af_sub1": "",

"af_sub2": "",

"affise_sub1": "guIrO",

"clickid": "67978dd1486c160001539fa1",

"expires": "1737985789",

"pid": "100",

"signature": "dTT6K6VIFueWswWk6hhFuRlAKpKaEPv0E7BOqPpAJJQ"

}

}

},

"uuid": "b103077f-0194-1000-8c22-d85f5178f267",

"timestamp": {

"seconds": 1738136553

},

"geo": {

"country": "ZA",

"region": "Gauteng",

"isp": "?"

},

"ip": "196.39.21.28",

"created_at": {

"seconds": 1738136554

},

"received_at": {

"seconds": 1738136553

}

},

"created_at": {

"seconds": 1738136554

},

"id": "b102c598-0194-1000-8462-1caba73961ea",

"name": "session_start",

"category": "native",

"timestamp": {

"seconds": 1738136536

},

"data": "{\"affise_event_session_start_timestamp\":1738136536472}",

"parameters_string": {

"affise_p_content": "[]",

"affise_p_customer_user_id": "ABA8051B-D819-443B-ABF8-9172B8235C43"

}

Rawa data API Postman collection

To get raw data from Affise MMP via API, you can use a Postman collection. You don't need to add all the methods manually to your Postman. There are templates for rawa data API methods, where you need to add your Integrations API key, base URL, and start working.


Add Settings API collection to Postman

  1. Download the .json file attached in this guide.

  2. Go to your Postman workspace.

  3. Click Import.

  4. Select the downloaded file to upload.
    ​

    Zight Recording 2025-11-14 at 06.04.51 PM

Please contact the Affise Customer Support team regarding all raised questions via the e-mail: [email protected].
​

Attachment icon
Affise MMP Raw Data.postman_collection.json
Related Articles
Attribution tracking link and postback parameters
Tools
API attribution (no SDK)
Tracking link parameters
Create installs and events from external systems (API)
Did this answer your question?