Ad Spend

Ad spend records capture your daily advertising costs broken down by platform and store. You can log spend manually or pull it automatically from the Meta API. This data feeds directly into your daily financials and P&L reports, so you always know exactly what you're spending on ads.

Ad spend uses the financials:read and financials:write scopes. The Meta API integration can be configured via the Settings endpoints.

The ad spend model

Each ad spend record represents a single day's advertising cost for a specific platform and store.

Properties

Name
id
Type
integer
Description
Unique identifier for the ad spend record.
Name
date
Type
string
Description
The date of the ad spend in YYYY-MM-DD format.
Name
store
Type
string
Description
The store identifier this spend is associated with.
Name
platform
Type
string
Description
The advertising platform (e.g., meta, tiktok, google, snapchat).
Name
amount
Type
number
Description
The amount spent on advertising.
Name
currency
Type
string
Description
The currency of the amount — e.g., EUR or USD.
Name
created_at
Type
timestamp
Description
Timestamp of when the record was created.

GET/financials/ad-spend

List ad spend

This endpoint returns ad spend records. Filter by date range, store, or platform to get exactly the data you need.

Optional attributes

Name
start
Type
string
Description
Start date in YYYY-MM-DD format.
Name
end
Type
string
Description
End date in YYYY-MM-DD format.
Name
store
Type
string
Description
Filter by store identifier.
Name
platform
Type
string
Description
Filter by advertising platform.
Name
limit
Type
integer
Description
Limit the number of records returned.
Name
offset
Type
integer
Description
Offset for pagination.

Request

GET

/financials/ad-spend

curl -G https://api.dealdome.eu/financials/ad-spend \
  -H "Authorization: Bearer {token}" \
  -d start=2026-04-01 \
  -d end=2026-04-13 \
  -d platform=meta

Response

{
  "data": [
    {
      "id": 89,
      "date": "2026-04-13",
      "store": "my-store",
      "platform": "meta",
      "amount": 275.40,
      "currency": "EUR",
      "created_at": "2026-04-13T08:00:00Z"
    },
    {
      "id": 88,
      "date": "2026-04-12",
      "store": "my-store",
      "platform": "meta",
      "amount": 220.15,
      "currency": "EUR",
      "created_at": "2026-04-12T08:00:00Z"
    }
  ]
}

POST/financials/ad-spend

Create ad spend

This endpoint lets you log ad spend manually or trigger a sync from the Meta API. For manual entries, provide all the required fields. For Meta API sync, DealDome will pull spend data automatically based on your configured Meta integration.

Required attributes

Name
date
Type
string
Description
The date in YYYY-MM-DD format.
Name
store
Type
string
Description
The store identifier.
Name
platform
Type
string
Description
The advertising platform (e.g., meta, tiktok, google).
Name
amount
Type
number
Description
The amount spent.
Name
currency
Type
string
Description
The currency — e.g., EUR or USD.

Optional attributes

Name
source
Type
string
Description
Set to meta_api to pull spend from the Meta Ads API instead of providing a manual amount. When set, amount is ignored and fetched automatically.

Request

POST

/financials/ad-spend

curl https://api.dealdome.eu/financials/ad-spend \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-04-13",
    "store": "my-store",
    "platform": "meta",
    "amount": 275.40,
    "currency": "EUR"
  }'

Response

{
  "id": 89,
  "date": "2026-04-13",
  "store": "my-store",
  "platform": "meta",
  "amount": 275.40,
  "currency": "EUR",
  "created_at": "2026-04-13T08:00:00Z"
}