Endpoints

1. Get Applications

Retrieves a list of your applications with basic data.

Endpoint: GET /apps

Full URL: https://connect.bidease.com/api/apps

Authentication: Bearer token (via Access-Token header)

Query Parameters

Parameter	Type	Format	Description
`ds`	String	`YYYY-MM-DD`	Start date for unique users calculation
`de`	String	`YYYY-MM-DD`	End date for unique users calculation
`last`	String	`day`, `week`, `month`	Shortcut for predefined period (overridden by `ds` and `de`)

Note: If both ds/de and last are provided, ds/de take precedence. If no date parameters are specified, the default is last=month.

Request Example

curl -s -H 'Access-Token: 500000ab-000c-4000-000f-ab00001a7830:[REDACTED]' \
  'https://connect.bidease.com/api/apps?last=week'

Response Example

{
  "apps": [
    {
      "app_id": "946b001c-1ab9-479a-89ff-300a24d7b353",
      "bundle_id": "com.bidease.demoapp",
      "name": "Demo App",
      "platform": "android",
      "publisher_id": "5fec51ab-f41c-4fe3-9a9f-ab00001a7830",
      "sdk_status": "update",
      "sdk_versions": [
        {
          "0.1.8": 100
        }
      ],
      "uniques": 100500
    },
...
  ],
  "status": "ok"
}

Response Fields

Field	Type	Description
`app_id`	String (UUID)	Unique application identifier
`bundle_id`	String	Application bundle/package identifier
`name`	String	Application display name
`platform`	String	Platform type (`android` or `ios`)
`publisher_id`	String (UUID)	Publisher account identifier
`sdk_status`	String	SDK update status (`current`, `update`, etc.)
`sdk_versions`	Array	List of SDK versions with usage counts
`uniques`	Number	Unique users for the specified period
`status`	String	Response status (`ok` or `error`)

2. Get Detailed Application Statistics

Retrieves detailed performance metrics with support for multiple grouping dimensions. Similar to the detailed statistics table in the Bidease dashboard.

Endpoint: GET /apps/{app_id}/stats

Full URL: https://connect.bidease.com/api/apps/{app_id}/stats

Authentication: Bearer token (via Access-Token header)

Path Parameters

Parameter	Type	Description	Required
`app_id`	String (UUID)	Application identifier	Yes

Query Parameters

Parameter	Type	Format/Options	Description	Required
`ds`	String	`YYYY-MM-DD`	Start date for the reporting period	No*
`de`	String	`YYYY-MM-DD`	End date for the reporting period	No*
`last`	String	`day`, `week`, `month`, `year`	Shortcut for predefined period	No*
`group`	String (multiple)	See grouping options below	Dimension to group results by (can be used multiple times)	No

Note: If both ds/de and last are provided, ds/de take precedence. If no date parameters are specified, the default is last=month.

Supported Grouping Dimensions

Group By	Description	Example Response Field
`date`	Day-level breakdown	`"date": "2025-11-30"`
`country`	Country grouping (ISO2 codes)	`"country": "us"`
`ad_type`	Ad format grouping*	`"ad_type": "rewarded"`
`placement_id`	Mediation placement	`"placement_id": "default_ecpm_5"`

Supported Ad Types

banner - Banner ads
interstitial - Interstitial ads
rewarded - Rewarded video ads
native - Native ads

Request Example

curl -s -H 'Access-Token: 500000ab-000c-4000-000f-ab00001a7830:[REDACTED]' \
  'https://connect.bidease.com/api/apps/954fee00-bcd7-4fde-a2bd-1bade4a00208/stats?last=day&group=country&group=ad_type&group=placement_id&group=date'

Response Example

{
  "apps": [
    {
      "app_id": "946b001c-1ab9-479a-89ff-300a24d7b353",
      "bundle_id": "com.bidease.demoapp",
      "name": "Demo App",
      "platform": "android",
      "publisher_id": "5fec51ab-f41c-4fe3-9a9f-ab00001a7830",
      "sdk_status": "update",
      "sdk_versions": [
        {
          "0.1.8": 100
        }
      ],
      "uniques": 100500
    }, 
    {
      "ad_type": "interstitial",
      "clicks": 2,
      "country": "us",
      "ctr": 0.41,
      "date": "2025-11-30",
      "ecpm": 5,
      "impressions": 486,
      "placement_id": "default_ecpm_5",
      "revenue": 2.43
    },  
      {
      "ad_type": "banner",
      "clicks": 6,
      "country": "ru",
      "ctr": 0.07,
      "date": "2025-12-01",
      "ecpm": 0.3,
      "impressions": 8007,
      "placement_id": "default_ecpm_0.30",
      "revenue": 2.4021
    },  
...
  ],
  "status": "ok"
}

Statistics Response Fields

Field	Type	Description
`ad_type`	String	Ad format type
`clicks`	Number	Total clicks
`country`	String	ISO2 country code
`ctr`	Number	Click-through rate (decimal)
`date`	String	Date in `YYYY-MM-DD` format
`ecpm`	Number	Effective cost per mille (per 1000 impressions)
`impressions`	Number	Total impressions
`placement_id`	String	Mediation placement identifier
`revenue`	Number	Revenue in USD

3. Examples

Example 1: Get Today's Revenue by Ad Type

curl -s -H 'Access-Token: YOUR_TOKEN' \
  'https://connect.bidease.com/api/apps/YOUR_APP_ID/stats?last=day&group=ad_type'

Example 2: Get Last Week's Performance by Country and Date

curl -s -H 'Access-Token: YOUR_TOKEN' \
  'https://connect.bidease.com/api/apps/YOUR_APP_ID/stats?last=week&group=country&group=date'

Example 3: Get Custom Date Range with Multiple Dimensions

curl -s -H 'Access-Token: YOUR_TOKEN' \
  'https://connect.bidease.com/api/apps/YOUR_APP_ID/stats?ds=2025-11-01&de=2025-11-30&group=date&group=ad_type&group=country&group=placement_id'

Additional Notes

Currency: All revenue values are returned in USD.
Time Zones: All dates and times use UTC timezone. Ensure your systems account for timezone differences when processing data.