curl --request GET \
--url 'https://api.growthchannel.io/daily-auction/?date_from=2026-01-01&date_to=2026-01-03&advertiser_id=544&response_format=json' \
--header 'X-Api-Key: YOUR_API_KEY'
curl --request GET \
--url 'https://api.growthchannel.io/daily-auction/?date_from=2026-01-01&date_to=2026-01-03&advertiser_id=544' \
--header 'X-Api-Key: YOUR_API_KEY'
Public endpoints
Daily Auction
Get daily delivery, spend, and budget for each campaign of an advertiser.
GET
/
daily-auction
/
?date_from=
{date_from}
&date_to=
{date_to}
&advertiser_id=
{advertiser_id}
&response_format=
{response_format}
curl --request GET \
--url 'https://api.growthchannel.io/daily-auction/?date_from=2026-01-01&date_to=2026-01-03&advertiser_id=544&response_format=json' \
--header 'X-Api-Key: YOUR_API_KEY'
curl --request GET \
--url 'https://api.growthchannel.io/daily-auction/?date_from=2026-01-01&date_to=2026-01-03&advertiser_id=544' \
--header 'X-Api-Key: YOUR_API_KEY'
Maximum date range 365 days
This endpoint is protected and requires an agency API key for access.
curl --request GET \
--url 'https://api.growthchannel.io/daily-auction/?date_from=2026-01-01&date_to=2026-01-03&advertiser_id=544&response_format=json' \
--header 'X-Api-Key: YOUR_API_KEY'
curl --request GET \
--url 'https://api.growthchannel.io/daily-auction/?date_from=2026-01-01&date_to=2026-01-03&advertiser_id=544' \
--header 'X-Api-Key: YOUR_API_KEY'
Method
GETEndpoint
/daily-auction/Headers
string
required
The agency’s API key for authorization. Contact an admin to get one.
Parameters
string
required
Start date in
YYYY-MM-DD format.string
required
End date in
YYYY-MM-DD format.integer
required
The advertiser to report on. Unlike other reports, this parameter is required.
integer
The agency of the advertiser. Optional. It must be your agency or an agency in your portfolio.
string
default:"csv"
Output format:
csv or json.Responses
Returns one row per campaign per day, sorted by impressions (highest first). The response is not paginated.- 200 OK JSON
- 200 OK CSV
- 400 Bad Request
- 401 Unauthorized
- 500 Internal Server Error
With
response_format=json, the response is a JSON array of rows.[
{
"campaign_id": 11111,
"campaign_name": "Name | Name | 11",
"impressions": 194,
"clicks": 3,
"spend": 0.65,
"budget": 1704.66,
"matched_bid_opp": 1096,
"date": "2026-01-02"
}
]
integer
The campaign ID.
string
The campaign name.
integer
Number of impressions.
integer
Number of clicks.
number
Spend for the day, rounded to 2 decimal places.
number
The campaign budget, rounded to 2 decimal places.
integer
Estimated number of matched bid opportunities, derived from impressions.
string
The day, in
YYYY-MM-DD format.With
response_format=csv (the default), the response is CSV text with a header row and the same columns. If there is no data, the body is empty.campaign_id,campaign_name,impressions,clicks,spend,budget,matched_bid_opp,date
11111,Name | Name | 11,194,3,0.65,1704.66,1096,2026-01-02
Returned if a parameter is missing or invalid. See Errors for all messages.Returned if the date range between Returned if
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Missing required parameters",
"details": {
"missing_fields": ["advertiser_id"]
},
"request_id": "..."
}
}
date_from and date_to exceeds 365 days.{
"error": {
"code": "VALIDATION_ERROR",
"message": "Date range cannot exceed 365 days",
"details": {
"date_from": "2025-01-01",
"date_to": "2026-06-01",
"date_range": 516,
"max_allowed": 365
},
"request_id": "4cf3fd6c-b2a8-483d-bb50-f51255c4943c"
}
}
response_format is not csv or json.{
"error": {
"code": "VALIDATION_ERROR",
"message": "Unsupported response_format: must be 'json' or 'csv'",
"details": {
"response_format": "xml",
"valid_options": ["json", "csv"]
},
"request_id": "..."
}
}
Returned if the
X-Api-Key header is missing or invalid.{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API key",
"details": {
"field": "X-Api-Key",
"issue": "invalid"
},
"request_id": "..."
}
}
Returned if there is an unexpected error on the server while fetching data.