Quickstart Guide

Get started with ForecastAPI in just 5 minutes. This guide will walk you through making your first forecast request.

Step 1: Get Your API Key

Step 2: Prepare Your Data

ForecastAPI works with time series data in a simple JSON format. Your data should include:

• date: The time period (YYYY-MM-DD) in UTC
• value: The numeric value for that period

{
  "data": [
    {"date": "2024-01-01", "value": 120},
    {"date": "2024-02-27", "value": 135},
    {"date": "2024-03-31", "value": 155},
    {"date": "2024-04-01", "value": 142},
    {"date": "2024-05-01", "value": 168}
  ],
  "periods": 6,
  "frequency": "M",
  "data_type": "sales"
}

Step 3: Make Your First Request

curl -X POST https://forecastapi.com/v2/forecast \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data": [
      {"date": "2024-01", "value": 120},
      {"date": "2024-02", "value": 135},
      {"date": "2024-03", "value": 155}
    ],
    "periods": 6,
    "frequency": "M"
  }'

# Response in 287ms
{
  "forecast": [
    {"date": "2024-04", "value": 168.5, "lower": 162.3, "upper": 174.7},
    {"date": "2024-05", "value": 175.2, "lower": 168.1, "upper": 182.3},
    ...
  ],
  "method": "exponential_smoothing",
  "confidence": 0.95
}

Understanding the Response

ForecastAPI returns a comprehensive response with your forecast and additional insights:

{
  "forecast": [
    {
      "date": "2024-06",
      "value": 175.2,
      "lower": 168.1,
      "upper": 182.3
    },
    {
      "date": "2024-07",
      "value": 181.5,
      "lower": 173.8,
      "upper": 189.2
    }
  ],
  "method": "exponential_smoothing",
  "confidence": 0.95,
  "analysis": {
    "pattern_type": "regular",
    "trend": "increasing",
    "seasonality": "none_detected"
  }
}

Response Fields

Common Parameters

What's Next?