Singular API v1

Singular API v1 (singular-net/api-v1)

operated by: Singular Labs, Inc. (go to tracker entry in the Exodus database)

Endpoint URLs

These are URLs or regexes of endpoints the tracker sends data to. We use these to determine which adapter to apply to a request. Some trackers use the same endpoint for several formats. In this case we use additional logic to match the adapter to the request, refer to the code for more information.
  • https://sdk-api-v1.singular.net/api/v1/start
  • https://sdk-api-v1.singular.net/api/v1/event
  • https://sdk-api-v1.singular.net/api/v1/config
  • https://sdk-api-v1.singular.net/api/v1/resolve
  • https://s2s.singular.net/api/v1/launch
  • https://i.singular.net/api/v1/imp

Decoding steps

Every tracking library has its own way of transmitting tracking data, often even several. They are regularly pretty convoluted, nested encoding schemes. Because of that, the adapter needs to decode the request information into a consistent format. We try to keep keys and paths intact, but the structure results from our decoding. All steps used in the decoding for this adapter are documented here.
  1. Parse the query string in the request path as a query string. Store that in the result for the query string.
  2. Parse the request body as JSON. Store that in the result for the request body.
  3. Parse the result for the request body at payload as JSON. Replace the existing value.
1res.query = parseQueryString(query)
2res.body = parseJson(body)
3res.body.payload = parseJson(res.body.payload)

Observed data transmissions

This is data that we observed being transmitted by this tracker. Not every request contains all of this data. The context of the data describes where we found the data in the request, the path describes the location of the data in the decoded request. The examples are a selection of observed values.
PropertyContextPathExamples of observed values
Device advertising ID (GAID/IDFA)queryidfa Tracker documentation on this propertyF04C6D92-D4FA-4CA4-AC62-DE94C8C2DAE7
queryaifa Tracker documentation on this property827d8162-0e1c-48cd-892e-4abd3df95ba8
ea70edc1-ac05-481c-8d2a-66b1be496a7e
830ec0b3-e94e-43e5-8722-a3a428af37bb
49b61a9c-cece-4300-b52e-26840e4c258e
fffe8a97-a504-4d14-89ab-c2025fbaf065
App IDqueryi Tracker documentation on this propertyair.com.tutotoons.app.sweetbabygirlsummerfun2.free
com.tutotoons.app.kikififipetfriends.free
com.cuteandtinybabygames.twinkleunicorncatprincess.free
com.tutotoons.app.mybabyunicorn.free
com.tutotoons.app.animalhairsalonaustralia.free
App namequerypsn9GAG: Best LOL Pics & GIFs
Drop The Number : Merge Puzzle
Stone Grass: Lawn Mower Game
App versionqueryapp_v Tracker documentation on this property9.22.5958.1
9.17.6605
4.470.10000
6.213.10000
4.523.10000
queryav More details on how we identified this property7.0.1511
5.0.30021
4.0.30005
13.0.6115
8.0.10007
Architecturequeryabx86_64
Countryquerycountry_codeDE
Developer-scoped device ID (IDFV/ASID/ANDROID_ID)queryidfv Tracker documentation on this property667284AF-3E1A-4C6F-8872-4DBC2956AA68
34CA9489-49B6-4CD4-B83D-B02056E6C67F
A933E6EC-79CA-4A23-A616-A5DE9C71AFA4
9E00AE1C-A572-4B7C-AEBC-5E9FE491BD2A
4834A29C-C90E-4AA4-9278-39141683614B
queryasid More details on how we identified this propertyaa785d9f-b34a-437f-b7f4-3240ebb42de9
09282c50-bcdf-427b-bea9-28a75e2a0baf
c2d0bdf8-7716-486a-a8a2-e1f719b5981d
729e4068-116f-4420-92a6-fc85593dfd0f
d80c7f56-895f-4a85-b2b7-c44cb1f84d71
queryandi Tracker documentation on this property1d3f461bec7a1fdd
9ad7feb70b1716b0
b8582ef1135bc331
251ecc74ab64d8f1
04e615255f090f62
App install timequeryinstall_time Tracker documentation on this property1610998218471
1611040084568
1611051774020
1611067791512
1611670380217
Is first launch/visit?queryinstall Tracker documentation on this propertyfalse
true
Languagequerylc Tracker documentation on this propertyen_US
en_DE
en
de_DE
nl
Manufacturerqueryma Tracker documentation on this propertyGoogle
Apple
apple
Modelquerymo Tracker documentation on this propertysdk_gphone_x86_64_arm64
iPhone9,3
iPhone10,4
sdk_gphone_x86_64
iPhone10,6
querydiPhone9,3
iPhone10,4
iPhone10,6
Network connection typequeryc Tracker documentation on this propertywifi
wwan
OS namequeryp Tracker documentation on this propertyAndroid
iOS
OS versionqueryv More details on how we identified this property11
14.8
14.5.1
15.6.1
13
queryve Tracker documentation on this property14.8
14.5.1
11
15.6.1
13
querybd Tracker documentation on this propertyBuild/18H17
Build/18E212
google/sdk_gphone_x86_64/generic_x86_64_arm64:11/RSR1.210722.013.A2/10067904:userdebug/dev-keys
Build/19G82
MTlHODI=
Public IP addressqueryip Tracker documentation on this property46.93.196.0
46.93.192.60
Time zonequerytzEurope/Berlin
Tracker SDK versionquerysdkSingular/v9.2.9-Unity/2.1.0
Singular/v9.2.9
Singular/v11.0.0-Unity/3.0.1
Singular/11.0.1
Singular/v12.0.0
User agentquerydevice_user_agentDalvik/2.1.0 (Linux; U; Android 11; sdk_gphone_x86_64_arm64 Build/RSR1.201013.001)
Dalvik/2.1.0 (Linux; U; Android 11; sdk_gphone_x86_64_arm64 Build/RSR1.201211.001.A1)
Dalvik/2.1.0 (Linux; U; Android 11; sdk_gphone_x86_64 Build/RSR1.210722.013.A2)
Dalvik/2.1.0 (Linux; U; Android 13; sdk_gphone_x86_64 Build/TE1A.220922.025)
Dalvik/2.1.0 (Linux; U; Android 11; sdk_gphone_x86_64_arm64 Build/RSR1.210722.013)
bodypayload.uaMozilla/5.0 (iPhone; CPU iPhone OS 14_8 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148
Mozilla/5.0 (iPhone; CPU iPhone OS 14_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148
Mozilla/5.0 (iPhone; CPU iPhone OS 15_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148
Unique user IDquerycustom_user_id More details on how we identified this property7cc2559a46fbdf60a0bb797096e97e1c
Lud5SxajkQaLP2Lo1ehqZkZsZGi1
00d9a9ad-5e2b-4ee0-bf1f-369d12acb689
52c5c185-2c46-4a22-890d-0269b2c280f1
AyQxxvxkJOWKpAlj2WFSZVh9G3I3
References