Skip to main content
POST
/
api
/
v1
/
ads
/
simulate
Simulate Spend Endpoint
curl --request POST \
  --url https://api.example.com/api/v1/ads/simulate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "<string>",
  "current_daily_budget": 123,
  "current_metrics": {
    "cpc": 123,
    "ctr": 0,
    "conversion_rate": 0,
    "avg_order_value": 123
  },
  "budget_scenarios": [
    123
  ]
}
'
{
  "platform": "<string>",
  "baseline_metrics": {},
  "scenarios": [
    {
      "daily_budget": 123,
      "monthly_budget": 123,
      "estimated_impressions": 123,
      "estimated_clicks": 123,
      "estimated_conversions": 123,
      "estimated_revenue": 123,
      "estimated_roas": 123,
      "confidence": "<string>"
    }
  ],
  "recommendation": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.aitasker.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
platform
string
required

Ad platform (e.g. google, meta, linkedin)

current_daily_budget
number
required

Current daily budget (USD)

current_metrics
CurrentMetrics · object
required
budget_scenarios
number[]
required

Daily budget amounts to simulate (USD)

Required array length: 1 - 20 elements

Response

Successful Response

platform
string
required
baseline_metrics
Baseline Metrics · object
required
scenarios
ScenarioForecastResponse · object[]
required
recommendation
string
required