Spend Report API

API to retrieve detailed spend reporting data for your Pushnami Ads advertiser account.

Quick Start

Get your spend report in one request:

curl -u 'username:password' \
  'https://adnetpn.com/ads/spend-report?start_date=2025-12-01&end_date=2025-12-03'

Use your Pushnami Ads login credentials.

Endpoint

GET https://adnetpn.com/ads/spend-report

Parameters

Parameter	Type	Required	Description
start_date	string	Yes	Start date in YYYY-MM-DD format
end_date	string	Yes	End date in YYYY-MM-DD format
columns	string	No	Comma-separated columns. Omit for all.
campaign_id	string	No	Filter by campaign ID (e.g., C0001234)
creative_id	string	No	Filter by creative ID (e.g., C0001234-001)
source_id	string	No	Filter by source ID (e.g., S0001234)

Date Constraints

• start_date must be ≤ end_date
• start_date cannot be more than 32 days in the past
• Dates use America/Chicago timezone

Available Columns

Column	Description
date	Report date
campaign_id	Campaign identifier
campaign_name	Campaign name
creative_id	Creative identifier
source_id	Traffic source identifier
total_spend	Spend amount (USD)

Default: If columns is omitted, all columns are returned.

Examples

Get All Data

curl -u 'username:password' \
  'https://adnetpn.com/ads/spend-report?start_date=2025-12-01&end_date=2025-12-03'

Response:

{
  "columns": ["date", "campaign_id", "campaign_name", "creative_id", "source_id", "total_spend"],
  "data": [
    {
      "date": "2025-12-01",
      "campaign_id": "C0001234",
      "campaign_name": "Campaign Name",
      "creative_id": "C0001234-001",
      "source_id": "S0001234",
      "total_spend": 123.45
    }
  ]
}

Get Specific Columns

curl -u 'username:password' \
  'https://adnetpn.com/ads/spend-report?start_date=2025-12-01&end_date=2025-12-03&columns=date,total_spend'

Response:

{
  "columns": ["date", "total_spend"],
  "data": [
    {"date": "2025-12-01", "total_spend": 221.00},
    {"date": "2025-12-02", "total_spend": 50.00},
    {"date": "2025-12-03", "total_spend": 75.21}
  ]
}

Filter by Campaign

curl -u 'username:password' \
  'https://adnetpn.com/ads/spend-report?start_date=2025-12-01&end_date=2025-12-03&campaign_id=C0001234'

Filter by Source

curl -u 'username:password' \
  'https://adnetpn.com/ads/spend-report?start_date=2025-12-01&end_date=2025-12-03&source_id=S0004483'

Code Examples

Python

import requests

response = requests.get(
    'https://adnetpn.com/ads/spend-report',
    auth=('username', 'password'),
    params={'start_date': '2025-12-01', 'end_date': '2025-12-03'}
)

print(response.json())

JavaScript

const credentials = btoa('username:password');

const response = await fetch(
  'https://adnetpn.com/ads/spend-report?start_date=2025-12-01&end_date=2025-12-03',
  { headers: { 'Authorization': `Basic ${credentials}` } }
);

console.log(await response.json());

cURL

curl -u 'username:password' \
  'https://adnetpn.com/ads/spend-report?start_date=2025-12-01&end_date=2025-12-03'

Error Responses

Status	Error	Cause
400	Missing required parameters: start_date, end_date	Missing dates
400	Invalid date format (expected YYYY-MM-DD)	Bad date format
400	start_date must be ≤ end_date	Invalid date range
400	start_date cannot be more than 32 days before today	Date too far in past
401	Authentication required. Use Basic Auth or Bearer token.	No credentials provided
401	Incorrect username or password	Wrong credentials
403	User account not confirmed. Please check your email.	Account not verified
403	User does not have an advertiser_id assigned. Contact support.	No advertiser linked
500	Internal server error. Request ID: ...	Server error – include Request ID when contacting support

Support

For API access or issues, contact your Pushnami account representative or email us: support@pushnami.com