# GroundTruth Demand API

**Canonical:** https://apis.io/apis/groundtruth/groundtruth-demand-api/  
**Provider:** GroundTruth — https://apis.io/providers/groundtruth/  
**Base URL:** https://api-public.groundtruth.com  
**Documentation:** https://api-docs.groundtruth.com/

GroundTruth Demand API is one of 19 APIs that [GroundTruth](https://apis.io/providers/groundtruth/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Demand. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

Demand API documentation

## Operations (59)

| Method | Path | Summary |
|---|---|---|
| GET | `/demand/v1/account/{accountID}/totals` | Get account level cumulative data. |
| GET | `/demand/v1/adgroup/{adgroupID}/daily` | Get adgroup level daily data. |
| GET | `/demand/v1/adgroup/{adgroupID}/totals` | Get adgroup level cumulative data. |
| GET | `/demand/v1/campaign/{campaignID}/daily` | Get campaign level daily data. |
| GET | `/demand/v1/campaign/{campaignID}/totals` | Get campaign level cumulative data. |
| GET | `/demand/v1/org/{organizationID}/totals` | Get organization level data |
| GET | `/demand/v1/campaign/product/{campaignID}` | Get product level data by campaign_id |
| GET | `/demand/v1/adgroups/product/{campaignID}` | Get product level for all the adgroups under the campaign |
| GET | `/demand/v1/creatives/product/{campaignID}` | Get product level for all the creatives under the campaign |
| GET | `/demand/v1/campaign/locations/{campaignID}` | Get Location data |
| GET | `/demand/v1/adgroup/locations/{adgroupID}` | Get Location data |
| GET | `/demand/v1/campaign/sv_locations/{campaignID}` | Get SV Location data |
| GET | `/demand/v1/adgroup/sv_locations/{adgroupID}` | Get SV Location data |
| GET | `/demand/v1/org/account_count/{tenantID}` | Get count of accounts |
| GET | `/demand/v1/account/conversion_tracking/{accountID}` | Get conversion tracking for all the adgroups under the account |
| GET | `/demand/v1/creatives/{campaignID}/daily` | Get creative level data under the campaign |
| GET | `/demand/v1/campaign/behavioral_audience/{campaignID}` | Get campaign level behavioral_audience data under the campaign |
| GET | `/demand/v1/adgroups/behavioral_audience/{campaignID}` | Get adgroup level behavioral_audience data under the campaign. |
| GET | `/demand/v1/creatives/behavioral_audience/{campaignID}` | Get creative level behavioral_audience data under the campaign. |
| GET | `/demand/v1/campaign/category/{campaignID}` | Get campaign level category data under the campaign. |
| GET | `/demand/v1/adgroups/category/{campaignID}` | Get adgroup level category data under the campaign. |
| GET | `/demand/v1/creatives/category/{campaignID}` | Get creative level category data under the campaign. |
| GET | `/demand/v1/campaign/brand_affinity/{campaignID}` | Get campaign level brand_affinity data under the campaign. |
| GET | `/demand/v1/adgroups/brand_affinity/{campaignID}` | Get adgroup level brand_affinity data under the campaign. |
| GET | `/demand/v1/creatives/brand_affinity/{campaignID}` | Get creative level brand_affinity data under the campaign. |
| GET | `/demand/v1/campaign/demographic/{campaignID}` | Get demographic data under the campaign. |
| GET | `/demand/v1/campaign/device_type/{campaignID}` | Get device_type data at campaign level. |
| GET | `/demand/v1/adgroups/device_type/{campaignID}` | Get adgroup level device_type data under a campaign. |
| GET | `/demand/v1/timeseries/tod/export/campaign/{campaignID}` | Get campaign level time of day data under a campaign. |
| GET | `/demand/v1/timeseries/tod/export/adgroups/{campaignID}` | Get adgroup level time of day data under a campaign. |
| GET | `/demand/v1/timeseries/tod/export/creatives/{campaignID}` | Get creative level time of day data under a campaign. |
| GET | `/demand/v2/campaign/product/{campaignID}` | Get product level data by campaign_id |
| GET | `/demand/v2/adgroups/product/{campaignID}` | Get product level for all the adgroups under the campaign |
| GET | `/demand/v2/creatives/product/{campaignID}` | Get product level for all the creatives under the campaign |
| GET | `/demand/v3/campaign/product/{campaignID}` | Get product level data by campaign_id |
| GET | `/demand/v3/adgroups/product/{campaignID}` | Get product level for all the adgroups under the campaign |
| GET | `/demand/v3/creatives/product/{campaignID}` | Get product level for all the creatives under the campaign |
| GET | `/demand/v2/campaign/behavioral_audience/{campaignID}` | Get campaign level behavioral_audience data under the campaign |
| GET | `/demand/v2/adgroups/behavioral_audience/{campaignID}` | Get adgroup level behavioral_audience data under the campaign. |
| GET | `/demand/v2/creatives/behavioral_audience/{campaignID}` | Get creative level behavioral_audience data under the campaign. |
| GET | `/demand/v2/campaign/category/{campaignID}` | Get campaign level category data under the campaign. |
| GET | `/demand/v2/adgroups/category/{campaignID}` | Get adgroup level category data under the campaign. |
| GET | `/demand/v2/creatives/category/{campaignID}` | Get creative level category data under the campaign. |
| GET | `/demand/v2/campaign/brand_affinity/{campaignID}` | Get campaign level brand_affinity data under the campaign. |
| GET | `/demand/v2/adgroups/brand_affinity/{campaignID}` | Get adgroup level brand_affinity data under the campaign. |
| GET | `/demand/v2/creatives/brand_affinity/{campaignID}` | Get creative level brand_affinity data under the campaign. |
| GET | `/demand/v2/campaign/sv_locations/{campaignID}` | Get SV Location data |
| GET | `/demand/V2/adgroup/sv_locations/{adgroupID}` | Get SV Location data |
| GET | `/demand/v2/campaign/publisher/{campaignID}` | Get campaign level publisher data for CTV/OTT campaigns |
| GET | `/demand/v2/adgroups/publisher/{campaignID}` | Get adgroup level publisher data for CTV/OTT campaigns |
| GET | `/demand/v2/campaign/network/{campaignID}` | Get campaign level network data for CTV/OTT campaigns |
| GET | `/demand/v2/campaign/audio/streaming_genre/{campaignID}` | Get campaign level streaming genre data for AUDIO campaigns |
| GET | `/demand/v2/adgroups/audio/streaming_genre/{campaignID}` | Get adgroup level streaming genre data under AUDIO campaigns |
| GET | `/demand/v2/campaign/audio/podcast_topic/{campaignID}` | Get campaign level podcast topic data for AUDIO campaigns |
| GET | `/demand/v2/adgroups/audio/podcast_topic/{campaignID}` | Get adgroup level podcast topic data under AUDIO campaigns |
| GET | `/demand/v2/campaign/audio/podcast_series/{campaignID}` | Get campaign level podcast series data for AUDIO campaigns |
| GET | `/demand/v2/adgroups/audio/podcast_series/{campaignID}` | Get adgroup level podcast series data under AUDIO campaigns |
| GET | `/demand/v2/campaign/audio/publisher/{campaignID}` | Get campaign level publisher data for AUDIO campaigns |
| GET | `/demand/v2/adgroups/audio/publisher/{campaignID}` | Get adgroup level publisher data under AUDIO campaigns |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/openapi/groundtruth-demand-api-openapi.yml
- **Documentation** — https://api-docs.groundtruth.com/
- **APIReference** — https://api-docs.groundtruth.com/
- **Console** — https://api-public.groundtruth.com/docs
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/authentication/groundtruth-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/conventions/groundtruth-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/errors/groundtruth-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/data-model/groundtruth-data-model.yml
- **Documentation** — https://reporting.groundtruth.com/api
- **APIReference** — https://reporting.groundtruth.com/api

## Other GroundTruth APIs (12)

- [GroundTruth Documentation MCP Server](https://apis.io/apis/groundtruth/groundtruth-documentation-mcp-server/)
- [GroundTruth Accounts API](https://apis.io/apis/groundtruth/groundtruth-accounts-api/)
- [GroundTruth Ad Groups API](https://apis.io/apis/groundtruth/groundtruth-ad-groups-api/)
- [GroundTruth Audiences API](https://apis.io/apis/groundtruth/groundtruth-audiences-api/)
- [GroundTruth Campaigns API](https://apis.io/apis/groundtruth/groundtruth-campaigns-api/)
- [GroundTruth Creative Assets API](https://apis.io/apis/groundtruth/groundtruth-creative-assets-api/)
- [GroundTruth Creatives API](https://apis.io/apis/groundtruth/groundtruth-creatives-api/)
- [GroundTruth Direct Mail API](https://apis.io/apis/groundtruth/groundtruth-direct-mail-api/)
- [GroundTruth Health API](https://apis.io/apis/groundtruth/groundtruth-health-api/)
- [GroundTruth Jobs API](https://apis.io/apis/groundtruth/groundtruth-jobs-api/)
- [GroundTruth Miscellaneous API](https://apis.io/apis/groundtruth/groundtruth-miscellaneous-api/)
- [GroundTruth Organizations API](https://apis.io/apis/groundtruth/groundtruth-organizations-api/)

## Tags

Demand

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/groundtruth/groundtruth-demand-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/groundtruth/.