Skip to main content
POST
Get Ad Spend

Request Body

Example Request

Example Response (grouped by campaign)

Response Fields by groupBy

groupBy: date

groupBy: campaign

groupBy: adgroup

groupBy: platform

Error Responses

Authorizations

X-API-KEY
string
header
required

API key for authentication

Body

application/json

Ad spend request parameters

startDate
string<date>
required

Start date (YYYY-MM-DD)

Example:

"2026-01-01"

endDate
string<date>
required

End date (YYYY-MM-DD)

Example:

"2026-03-01"

platform
enum<string>

Filter by platform

Available options:
googleads,
meta,
microsoftads
groupBy
enum<string>
default:date

Dimension to group results by

Available options:
date,
campaign,
adgroup,
platform
limit
integer
default:100

Results per page (1-500)

Required range: 1 <= x <= 500
page
integer
default:1

Page number

Required range: x >= 1

Response

Ad spend data retrieved successfully

success
boolean
Example:

true

data
object[]
meta
object