Generate Report Now

Generate an immediate performance report and deliver it now.

What it does:

Generates a comprehensive PDF performance report immediately
Fetches latest campaign data from all connected platforms
Includes AI-powered recommendations and insights
Delivers via email, Slack, or webhook

When to use:

“Get me my campaign performance report”
“Send me a detailed analysis of all my accounts”
“Generate a report and email it to me”
“I need my performance data now”
“Prepare a report for all my campaigns”

Report Types:

performance_brief: Quick overview of key metrics
detailed_analysis: Deep dive with breakdowns
executive_summary: High-level summary for stakeholders

Execution time: 2-5 minutes (async - you’ll be notified when ready)

Example: User: “Get me my detailed campaign performance for all accounts and email it to me” → Call generate_report_now with:

report_type: “detailed_analysis”
platforms: null (all platforms)
delivery_method: “email”
delivery_destination: “user@example.com”

POST

/

api

/

v1

/

tools

/

generate_report_now

/

execute

Generate Report Now

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/generate_report_now/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "account_ids": [
      "string"
    ],
    "campaign_ids": [
      "string"
    ],
    "date_range": {
      "end_date": "2026-03-31",
      "start_date": "2026-03-01"
    },
    "delivery_method": "email",
    "platforms": [
      "string"
    ],
    "report_type": "performance_brief"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for generate_report_now)"
  },
  "success": true,
  "tool": "generate_report_now"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input for generating an immediate ad-hoc report.

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

Get Monitor HistoryShow trigger history for a monitoring alert. **What it does:** - Shows when the monitor triggered, what condition was met, and what value caused it - Shows which campaigns triggered and whether notifications were sent - Useful for understanding monitor behavior and verifying it works correctly **When to use:** - "Show history for my CPA monitor" - "When did this alert last trigger?" - "What campaigns triggered my ROAS alert?" Requires the monitor's alert_id (get from list_monitors).

Generate Report Now

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/generate_report_now/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "account_ids": [
      "string"
    ],
    "campaign_ids": [
      "string"
    ],
    "date_range": {
      "end_date": "2026-03-31",
      "start_date": "2026-03-01"
    },
    "delivery_method": "email",
    "platforms": [
      "string"
    ],
    "report_type": "performance_brief"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for generate_report_now)"
  },
  "success": true,
  "tool": "generate_report_now"
}