Groundtruth Reporting API

https://reporting.groundtruth.com/api
Admin
Groundtruth Reporting API is an external REST API for retrieving comprehensive campaign reporting...
Tokens:4,919
Snippets:61
Trust Score:10
Update:5 months ago
Show doc for...
Tokens:
Raw
### Get Product Level Data for All Creatives Under a Campaign

Source: https://reporting.groundtruth.com/api

Retrieves product-level data for all creatives within a specified campaign.

```APIDOC
## GET /demand/v1/creatives/product/{campaignID}

### Description
Get product level for all the creatives under the campaign

### Method
GET

### Endpoint
/demand/v1/creatives/product/{campaignID}
```

--------------------------------

### Get Conversion Tracking for Account

Source: https://reporting.groundtruth.com/api

Retrieves conversion tracking data for all adgroups under a specific account.

```APIDOC
## GET /demand/v1/account/conversion_tracking/{accountID}

### Description
Get conversion tracking for all the adgroups under the account

### Method
GET

### Endpoint
/demand/v1/account/conversion_tracking/{accountID}
```

--------------------------------

### Get Campaign Level Daily Data

Source: https://reporting.groundtruth.com/api

Retrieves daily data at the campaign level.

```APIDOC
## GET /demand/v1/campaign/{campaignID}/daily

### Description
Get campaign level daily data.

### Method
GET

### Endpoint
/demand/v1/campaign/{campaignID}/daily
```

--------------------------------

### Get Product Level Data by Campaign ID

Source: https://reporting.groundtruth.com/api

Retrieves product-level data associated with a specific campaign ID.

```APIDOC
## GET /demand/v1/campaign/product/{campaignID}

### Description
Get product level data by campaign_id

### Method
GET

### Endpoint
/demand/v1/campaign/product/{campaignID}
```

--------------------------------

### Get Product Level Data for All Adgroups Under a Campaign

Source: https://reporting.groundtruth.com/api

Retrieves product-level data for all adgroups within a specified campaign.

```APIDOC
## GET /demand/v1/adgroups/product/{campaignID}

### Description
Get product level for all the adgroups under the campaign

### Method
GET

### Endpoint
/demand/v1/adgroups/product/{campaignID}
```

--------------------------------

### Get Organization Level Data

Source: https://reporting.groundtruth.com/api

Retrieves data at the organization level.

```APIDOC
## GET /demand/v1/org/{organizationID}/totals

### Description
Get organization level data

### Method
GET

### Endpoint
/demand/v1/org/{organizationID}/totals
```

--------------------------------

### Get Campaign Level Publisher Data for AUDIO Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves campaign level publisher data for AUDIO campaigns.

```APIDOC
## GET /demand/v2/adgroups/audio/publisher/{campaignID}

### Description
Get campaign level publisher data for AUDIO campaigns

### Method
GET

### Endpoint
/demand/v2/adgroups/audio/publisher/{campaignID}
```

--------------------------------

### Get Campaign Level Category Data

Source: https://reporting.groundtruth.com/api

Retrieves category data at the campaign level.

```APIDOC
## GET /demand/v1/campaign/category/{campaignID}

### Description
Get campaign level category data under the campaign.

### Method
GET

### Endpoint
/demand/v1/campaign/category/{campaignID}
```

--------------------------------

### Get Campaign Level Podcast Series Data for AUDIO Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves campaign level podcast series data for AUDIO campaigns.

```APIDOC
## GET /demand/v2/adgroups/audio/podcast_series/{campaignID}

### Description
Get campaign level podcast series data for AUDIO campaigns

### Method
GET

### Endpoint
/demand/v2/adgroups/audio/podcast_series/{campaignID}
```

--------------------------------

### Get Account Level Cumulative Data

Source: https://reporting.groundtruth.com/api

Retrieves cumulative data at the account level.

```APIDOC
## GET /demand/v1/account/{accountID}/totals

### Description
Get account level cumulative data.

### Method
GET

### Endpoint
/demand/v1/account/{accountID}/totals
```

--------------------------------

### Get Account Count by Tenant ID

Source: https://reporting.groundtruth.com/api

Retrieves the count of accounts associated with a specific tenant ID.

```APIDOC
## GET /demand/v1/org/account_count/{tenantID}

### Description
Get count of accounts

### Method
GET

### Endpoint
/demand/v1/org/account_count/{tenantID}
```

--------------------------------

### Get Adgroup Level Daily Data

Source: https://reporting.groundtruth.com/api

Retrieves daily data at the adgroup level.

```APIDOC
## GET /demand/v1/adgroup/{adgroupID}/daily

### Description
Get adgroup level daily data.

### Method
GET

### Endpoint
/demand/v1/adgroup/{adgroupID}/daily
```

--------------------------------

### Get Campaign Level Podcast Topic Data for AUDIO Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves campaign level podcast topic data for AUDIO campaigns.

```APIDOC
## GET /demand/v2/adgroups/audio/podcast_topic/{campaignID}

### Description
Get campaign level podcast topic data for AUDIO campaigns

### Method
GET

### Endpoint
/demand/v2/adgroups/audio/podcast_topic/{campaignID}
```

--------------------------------

### Get Creative Level Time of Day Data Export

Source: https://reporting.groundtruth.com/api

Retrieves creative-level time of day data for export.

```APIDOC
## GET /demand/v1/timeseries/tod/export/creatives/{campaignID}

### Description
Get creative level time of day data under a campaign.

### Method
GET

### Endpoint
/demand/v1/timeseries/tod/export/creatives/{campaignID}
```

--------------------------------

### Get Product Level Data for All Creatives Under a Campaign (v3)

Source: https://reporting.groundtruth.com/api

Retrieves product-level data for all creatives within a specified campaign using v3 of the API.

```APIDOC
## GET /demand/v3/creatives/product/{campaignID}

### Description
Get product level for all the creatives under the campaign

### Method
GET

### Endpoint
/demand/v3/creatives/product/{campaignID}
```

--------------------------------

### Get Campaign Level Cumulative Data

Source: https://reporting.groundtruth.com/api

Retrieves cumulative data at the campaign level.

```APIDOC
## GET /demand/v1/campaign/{campaignID}/totals

### Description
Get campaign level cumulative data.

### Method
GET

### Endpoint
/demand/v1/campaign/{campaignID}/totals
```

--------------------------------

### Get Campaign Level Brand Affinity Data

Source: https://reporting.groundtruth.com/api

Retrieves brand affinity data at the campaign level.

```APIDOC
## GET /demand/v1/campaign/brand_affinity/{campaignID}

### Description
Get campaign level brand_affinity data under the campaign.

### Method
GET

### Endpoint
/demand/v1/campaign/brand_affinity/{campaignID}
```

--------------------------------

### Get Campaign Level Behavioral Audience Data

Source: https://reporting.groundtruth.com/api

Retrieves behavioral audience data at the campaign level.

```APIDOC
## GET /demand/v1/campaign/behavioral_audience/{campaignID}

### Description
Get campaign level behavioral_audience data under the campaign

### Method
GET

### Endpoint
/demand/v1/campaign/behavioral_audience/{campaignID}
```

--------------------------------

### Get Product Level Data for All Creatives Under a Campaign (v2)

Source: https://reporting.groundtruth.com/api

Retrieves product-level data for all creatives within a specified campaign using v2 of the API.

```APIDOC
## GET /demand/v2/creatives/product/{campaignID}

### Description
Get product level for all the creatives under the campaign

### Method
GET

### Endpoint
/demand/v2/creatives/product/{campaignID}
```

--------------------------------

### Get Device Type Data by Campaign ID

Source: https://reporting.groundtruth.com/api

Retrieves device type data at the campaign level for a specific campaign.

```APIDOC
## GET /demand/v1/campaign/device_type/{campaignID}

### Description
Get device_type data at campaign level.

### Method
GET

### Endpoint
/demand/v1/campaign/device_type/{campaignID}
```

--------------------------------

### Get Campaign Level Time of Day Data Export

Source: https://reporting.groundtruth.com/api

Retrieves campaign-level time of day data for export.

```APIDOC
## GET /demand/v1/timeseries/tod/export/campaign/{campaignID}

### Description
Get campaign level time of day data under a campaign.

### Method
GET

### Endpoint
/demand/v1/timeseries/tod/export/campaign/{campaignID}
```

--------------------------------

### Get Product Level Data for All Adgroups Under a Campaign (v3)

Source: https://reporting.groundtruth.com/api

Retrieves product-level data for all adgroups within a specified campaign using v3 of the API.

```APIDOC
## GET /demand/v3/adgroups/product/{campaignID}

### Description
Get product level for all the adgroups under the campaign

### Method
GET

### Endpoint
/demand/v3/adgroups/product/{campaignID}
```

--------------------------------

### Get Campaign Level Streaming Genre Data for AUDIO Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves campaign level streaming genre data for AUDIO campaigns.

```APIDOC
## GET /demand/v2/adgroups/audio/streaming_genre/{campaignID}

### Description
Get campaign level streaming genre data for AUDIO campaigns

### Method
GET

### Endpoint
/demand/v2/adgroups/audio/streaming_genre/{campaignID}
```

--------------------------------

### Get Adgroup Level Cumulative Data

Source: https://reporting.groundtruth.com/api

Retrieves cumulative data at the adgroup level.

```APIDOC
## GET /demand/v1/adgroup/{adgroupID}/totals

### Description
Get adgroup level cumulative data.

### Method
GET

### Endpoint
/demand/v1/adgroup/{adgroupID}/totals
```

--------------------------------

### Get Creative Level Daily Data by Campaign ID

Source: https://reporting.groundtruth.com/api

Retrieves daily data at the creative level for a specific campaign.

```APIDOC
## GET /demand/v1/creatives/{campaignID}/daily

### Description
Get creative level data under the campaign

### Method
GET

### Endpoint
/demand/v1/creatives/{campaignID}/daily
```

--------------------------------

### Get Campaign Level Publisher Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves campaign-level publisher data for CTV/OTT campaigns using v2 of the API.

```APIDOC
## GET /demand/v2/campaign/publisher/{campaignID}

### Description
Get campaign level publisher data for CTV/OTT campaigns

### Method
GET

### Endpoint
/demand/v2/campaign/publisher/{campaignID}
```

--------------------------------

### Get Demographic Data by Campaign ID

Source: https://reporting.groundtruth.com/api

Retrieves demographic data associated with a specific campaign ID.

```APIDOC
## GET /demand/v1/campaign/demographic/{campaignID}

### Description
Get demographic data under the campaign.

### Method
GET

### Endpoint
/demand/v1/campaign/demographic/{campaignID}
```

--------------------------------

### Get Product Level Data for All Adgroups Under a Campaign (v2)

Source: https://reporting.groundtruth.com/api

Retrieves product-level data for all adgroups within a specified campaign using v2 of the API.

```APIDOC
## GET /demand/v2/adgroups/product/{campaignID}

### Description
Get product level for all the adgroups under the campaign

### Method
GET

### Endpoint
/demand/v2/adgroups/product/{campaignID}
```

--------------------------------

### Get Adgroup Level Publisher Data under AUDIO Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves adgroup level publisher data under AUDIO campaigns.

```APIDOC
## GET /demand/v2/campaign/network/{campaignID}

### Description
Get adgroup level publisher data under AUDIO campaigns

### Method
GET

### Endpoint
/demand/v2/campaign/network/{campaignID}
```

--------------------------------

### Get Creative Level Category Data

Source: https://reporting.groundtruth.com/api

Retrieves category data at the creative level for a given campaign.

```APIDOC
## GET /demand/v1/creatives/category/{campaignID}

### Description
Get creative level category data under the campaign.

### Method
GET

### Endpoint
/demand/v1/creatives/category/{campaignID}
```

--------------------------------

### Get Location Data by Campaign ID

Source: https://reporting.groundtruth.com/api

Retrieves location data associated with a specific campaign ID.

```APIDOC
## GET /demand/v1/campaign/locations/{campaignID}

### Description
Get Location data

### Method
GET

### Endpoint
/demand/v1/campaign/locations/{campaignID}
```

--------------------------------

### Get Product Level Data by Campaign ID (v3)

Source: https://reporting.groundtruth.com/api

Retrieves product-level data associated with a specific campaign ID using v3 of the API.

```APIDOC
## GET /demand/v3/campaign/product/{campaignID}

### Description
Get product level data by campaign_id

### Method
GET

### Endpoint
/demand/v3/campaign/product/{campaignID}
```

--------------------------------

### Get Adgroup Level Podcast Series Data under AUDIO Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves adgroup level podcast series data under AUDIO campaigns.

```APIDOC
## GET /demand/v2/campaign/audio/publisher/{campaignID}

### Description
Get adgroup level podcast series data under AUDIO campaigns

### Method
GET

### Endpoint
/demand/v2/campaign/audio/publisher/{campaignID}
```

--------------------------------

### Get Product Level Data by Campaign ID (v2)

Source: https://reporting.groundtruth.com/api

Retrieves product-level data associated with a specific campaign ID using v2 of the API.

```APIDOC
## GET /demand/v2/campaign/product/{campaignID}

### Description
Get product level data by campaign_id

### Method
GET

### Endpoint
/demand/v2/campaign/product/{campaignID}
```

--------------------------------

### Get Adgroup Level Podcast Topic Data under AUDIO Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves adgroup level podcast topic data under AUDIO campaigns.

```APIDOC
## GET /demand/v2/campaign/audio/podcast_series/{campaignID}

### Description
Get adgroup level podcast topic data under AUDIO campaigns

### Method
GET

### Endpoint
/demand/v2/campaign/audio/podcast_series/{campaignID}
```

--------------------------------

### Get Campaign Level Category Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves category data at the campaign level using v2 of the API.

```APIDOC
## GET /demand/v2/campaign/category/{campaignID}

### Description
Get campaign level category data under the campaign.

### Method
GET

### Endpoint
/demand/v2/campaign/category/{campaignID}
```

--------------------------------

### Get Campaign Level Behavioral Audience Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves behavioral audience data at the campaign level using v2 of the API.

```APIDOC
## GET /demand/v2/campaign/behavioral_audience/{campaignID}

### Description
Get campaign level behavioral_audience data under the campaign

### Method
GET

### Endpoint
/demand/v2/campaign/behavioral_audience/{campaignID}
```

--------------------------------

### Get Adgroup Level Time of Day Data Export

Source: https://reporting.groundtruth.com/api

Retrieves adgroup-level time of day data for export.

```APIDOC
## GET /demand/v1/timeseries/tod/export/adgroups/{campaignID}

### Description
Get adgroup level time of day data under a campaign.

### Method
GET

### Endpoint
/demand/v1/timeseries/tod/export/adgroups/{campaignID}
```

--------------------------------

### Get Adgroup Level Category Data

Source: https://reporting.groundtruth.com/api

Retrieves category data at the adgroup level for a given campaign.

```APIDOC
## GET /demand/v1/adgroups/category/{campaignID}

### Description
Get adgroup level category data under the campaign.

### Method
GET

### Endpoint
/demand/v1/adgroups/category/{campaignID}
```

--------------------------------

### Get Location Data by Adgroup ID

Source: https://reporting.groundtruth.com/api

Retrieves location data associated with a specific adgroup ID.

```APIDOC
## GET /demand/v1/adgroup/locations/{adgroupID}

### Description
Get Location data

### Method
GET

### Endpoint
/demand/v1/adgroup/locations/{adgroupID}
```

--------------------------------

### Get Creative Level Brand Affinity Data

Source: https://reporting.groundtruth.com/api

Retrieves brand affinity data at the creative level for a given campaign.

```APIDOC
## GET /demand/v1/creatives/brand_affinity/{campaignID}

### Description
Get creative level brand_affinity data under the campaign.

### Method
GET

### Endpoint
/demand/v1/creatives/brand_affinity/{campaignID}
```

--------------------------------

### Get Creative Level Category Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves category data at the creative level for a given campaign using v2 of the API.

```APIDOC
## GET /demand/v2/creatives/category/{campaignID}

### Description
Get creative level category data under the campaign.

### Method
GET

### Endpoint
/demand/v2/creatives/category/{campaignID}
```

--------------------------------

### Get Campaign Level Brand Affinity Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves brand affinity data at the campaign level using v2 of the API.

```APIDOC
## GET /demand/v2/campaign/brand_affinity/{campaignID}

### Description
Get campaign level brand_affinity data under the campaign.

### Method
GET

### Endpoint
/demand/v2/campaign/brand_affinity/{campaignID}
```

--------------------------------

### Get Creative Level Behavioral Audience Data

Source: https://reporting.groundtruth.com/api

Retrieves behavioral audience data at the creative level for a given campaign.

```APIDOC
## GET /demand/v1/creatives/behavioral_audience/{campaignID}

### Description
Get creative level behavioral_audience data under the campaign.

### Method
GET

### Endpoint
/demand/v1/creatives/behavioral_audience/{campaignID}
```

--------------------------------

### Get Adgroup Level Publisher Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves adgroup-level publisher data for a given campaign using v2 of the API.

```APIDOC
## GET /demand/v2/adgroups/publisher/{campaignID}

### Description
Get adgroup level publisher data

### Method
GET

### Endpoint
/demand/v2/adgroups/publisher/{campaignID}
```

--------------------------------

### Get Creative Level Behavioral Audience Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves behavioral audience data at the creative level for a given campaign using v2 of the API.

```APIDOC
## GET /demand/v2/creatives/behavioral_audience/{campaignID}

### Description
Get creative level behavioral_audience data under the campaign.

### Method
GET

### Endpoint
/demand/v2/creatives/behavioral_audience/{campaignID}
```

--------------------------------

### Get Adgroup Level Brand Affinity Data

Source: https://reporting.groundtruth.com/api

Retrieves brand affinity data at the adgroup level for a given campaign.

```APIDOC
## GET /demand/v1/adgroups/brand_affinity/{campaignID}

### Description
Get adgroup level brand_affinity data under the campaign.

### Method
GET

### Endpoint
/demand/v1/adgroups/brand_affinity/{campaignID}
```

--------------------------------

### Get Adgroup Level Behavioral Audience Data

Source: https://reporting.groundtruth.com/api

Retrieves behavioral audience data at the adgroup level for a given campaign.

```APIDOC
## GET /demand/v1/adgroups/behavioral_audience/{campaignID}

### Description
Get adgroup level behavioral_audience data under the campaign.

### Method
GET

### Endpoint
/demand/v1/adgroups/behavioral_audience/{campaignID}
```

--------------------------------

### Get Adgroup Level Device Type Data

Source: https://reporting.groundtruth.com/api

Retrieves device type data at the adgroup level under a specific campaign.

```APIDOC
## GET /demand/v1/adgroups/device_type/{campaignID}

### Description
Get adgroup level device_type data under a campaign.

### Method
GET

### Endpoint
/demand/v1/adgroups/device_type/{campaignID}
```

--------------------------------

### Get Campaign Level Network Data for CTV/OTT Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves campaign level network data for Connected TV (CTV) and Over-The-Top (OTT) campaigns.

```APIDOC
## GET /demand/v2/campaign/audio/streaming_genre/{campaignID}

### Description
Get campaign level network data for CTV/OTT campaigns

### Method
GET

### Endpoint
/demand/v2/campaign/audio/streaming_genre/{campaignID}
```

--------------------------------

### Get Adgroup Level Streaming Genre Data under AUDIO Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves adgroup level streaming genre data under AUDIO campaigns.

```APIDOC
## GET /demand/v2/campaign/audio/podcast_topic/{campaignID}

### Description
Get adgroup level streaming genre data under AUDIO campaigns

### Method
GET

### Endpoint
/demand/v2/campaign/audio/podcast_topic/{campaignID}
```

--------------------------------

### Get SV Location Data by Campaign ID

Source: https://reporting.groundtruth.com/api

Retrieves SV (presumably 'Serviceable' or similar) location data associated with a specific campaign ID.

```APIDOC
## GET /demand/v1/campaign/sv_locations/{campaignID}

### Description
Get SV Location data

### Method
GET

### Endpoint
/demand/v1/campaign/sv_locations/{campaignID}
```

--------------------------------

### Get Adgroup Level Publisher Data for CTV/OTT Campaigns

Source: https://reporting.groundtruth.com/api

Retrieves adgroup level publisher data for Connected TV (CTV) and Over-The-Top (OTT) campaigns.

```APIDOC
## GET /demand/v2/campaign/network/{campaignID}

### Description
Get adgroup level publisher data for CTV/OTT campaigns

### Method
GET

### Endpoint
/demand/v2/campaign/network/{campaignID}
```

--------------------------------

### Get Adgroup Level Category Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves category data at the adgroup level for a given campaign using v2 of the API.

```APIDOC
## GET /demand/v2/adgroups/category/{campaignID}

### Description
Get adgroup level category data under the campaign.

### Method
GET

### Endpoint
/demand/v2/adgroups/category/{campaignID}
```

--------------------------------

### Get SV Location Data by Campaign ID (v2)

Source: https://reporting.groundtruth.com/api

Retrieves SV (presumably 'Serviceable' or similar) location data associated with a specific campaign ID using v2 of the API.

```APIDOC
## GET /demand/v2/campaign/sv_locations/{campaignID}

### Description
Get SV Location data

### Method
GET

### Endpoint
/demand/v2/campaign/sv_locations/{campaignID}
```

--------------------------------

### Get Creative Level Brand Affinity Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves brand affinity data at the creative level for a given campaign using v2 of the API.

```APIDOC
## GET /demand/v2/creatives/brand_affinity/{campaignID}

### Description
Get creative level brand_affinity data under the campaign.

### Method
GET

### Endpoint
/demand/v2/creatives/brand_affinity/{campaignID}
```

--------------------------------

### Get Adgroup Level Behavioral Audience Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves behavioral audience data at the adgroup level for a given campaign using v2 of the API.

```APIDOC
## GET /demand/v2/adgroups/behavioral_audience/{campaignID}

### Description
Get adgroup level behavioral_audience data under the campaign.

### Method
GET

### Endpoint
/demand/v2/adgroups/behavioral_audience/{campaignID}
```

--------------------------------

### Get SV Location Data by Adgroup ID (v2)

Source: https://reporting.groundtruth.com/api

Retrieves SV (presumably 'Serviceable' or similar) location data associated with a specific adgroup ID using v2 of the API.

```APIDOC
## GET /demand/V2/adgroup/sv_locations/{adgroupID}

### Description
Get SV Location data

### Method
GET

### Endpoint
/demand/V2/adgroup/sv_locations/{adgroupID}
```

--------------------------------

### Get SV Location Data by Adgroup ID

Source: https://reporting.groundtruth.com/api

Retrieves SV (presumably 'Serviceable' or similar) location data associated with a specific adgroup ID.

```APIDOC
## GET /demand/v1/adgroup/sv_locations/{adgroupID}

### Description
Get SV Location data

### Method
GET

### Endpoint
/demand/v1/adgroup/sv_locations/{adgroupID}
```

--------------------------------

### Get Adgroup Level Brand Affinity Data (v2)

Source: https://reporting.groundtruth.com/api

Retrieves brand affinity data at the adgroup level for a given campaign using v2 of the API.

```APIDOC
## GET /demand/v2/adgroups/brand_affinity/{campaignID}

### Description
Get adgroup level brand_affinity data under the campaign.

### Method
GET

### Endpoint
/demand/v2/adgroups/brand_affinity/{campaignID}
```
Tokens:
Raw