GroundTruth

GroundTruth Demand API

Demand API documentation

GitHub OpenAPI

Operations 59

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 #

Documentation

📖
Documentation
https://api-docs.groundtruth.com/
📖
APIReference
https://api-docs.groundtruth.com/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/authentication/groundtruth-authentication.yml
📖
Documentation
https://reporting.groundtruth.com/api
📖
APIReference
https://reporting.groundtruth.com/api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/openapi/groundtruth-demand-api-openapi.yml

Other Resources

🔗
Console
https://api-public.groundtruth.com/docs
🔗
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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/groundtruth-demand-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

groundtruth-demand-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Groundtruth Reporting Demand API
  description: '**External reporting API.**


    *Note:* All REST API endpoints currently require HTTP/1.1. Please use HTTP/1.1 (e.g., by adding `--http1.1` in curl commands) to receive a response.'
  version: 2.0.0
tags:


# --- truncated at 32 KB (165 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/openapi/groundtruth-demand-api-openapi.yml