GETTING STARTED
API REFERENCE
DASHBOARD
EXAMPLES
DOCUMENTATION
Start here.
POST a series and get a calibrated forecast. You do not need an SDK, model training, or an ML team.
One call. Every model.
ForecastAPI reads the shape of your time series: trend, seasonality, intermittency. It tests your series against more than thirty models and scores them out-of-sample. You send history. The API returns the winning forecast in milliseconds and names the model.
Send history, get the future.
POST timestamped values and a horizon. The server selects the model, adjusts for seasonality, and calibrates the intervals. The response names the winning model and contains a full per-period path.
REQUEST
POST /v2/forecast
curl -X POST https://forecastapi.com/v2/forecast \
-H "Authorization: Bearer $FORECAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"identifier": "SKU-12345",
"data": [
{"date": "2024-01-01", "value": 120},
{"date": "2024-02-01", "value": 135},
{"date": "2024-03-01", "value": 155}
],
"periods": 6,
"frequency": "M",
"data_type": "sales"
}'
RESPONSE
200 OK · 287 MS
{
"result": {
"identifier": "SKU-12345",
"forecasts": [
{"period": 1, "date": "2024-04-01",
"forecast": 168.5, "lower": 162.3, "upper": 174.7},
{"period": 2, "date": "2024-05-01",
"forecast": 175.2, "lower": 168.1, "upper": 182.3}
],
"model_info": {"best_model": "AutoETS",
"selection_metric": "smape"}
},
"meta": {"timing": {"total": 287}}
}
FREE TIER
Your first 200 calls each month are free.
The free tier caps each request at 100 datapoints. Paid calls include unlimited history.
Included in every response.
Automatic model selection
The API tests more than thirty models on your series out-of-sample. The response includes the winning model and its score. You do not configure anything.
Sub-second response
The median response time is 287 ms end to end. That is fast enough for a checkout, a dashboard, or a replenishment loop.
Confidence intervals
Every forecast includes calibrated intervals. Plan with the median value. Stock to the upper bound.
Any data type
Send sales, demand, inventory, web traffic, or revenue data. The API adapts its methods to the data type. You do not define a schema.
