Visit websiteWebAppGet DemoTry for Free

Create Model

Create a forecast model.

Create Model

post
Authorizations
AuthorizationstringRequired

Enter your PredictHQ API key. The Bearer prefix is added automatically.

When calling the API directly, send: 'Authorization: Bearer <YOUR_API_KEY>' as documented at https://docs.predicthq.com/authentication

Body
namestring · min: 1Required

Name for the forecast model.

external_idstring · min: 1Optional

External identifier for the forecast model. If you have an ID for the location/store/property/product-group in your other platforms, use the same ID here to easily connect this specific forecast model.

forecast_windowstring · enumOptional

Number of days into the future to forecast.

Possible values:
labelstring[] · min: 1Optional

Set of labels you can use to better identify or group your forecast models.

algostring · enumOptional

Currently we offer one algorithm based on XGBoost. In the future we may offer additional algos.

Default: phq-xgboostPossible values:
Responses
post
/v1/forecasts/models
POST /v1/forecasts/models HTTP/1.1
Host: api.predicthq.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 197

{
  "name": "text",
  "external_id": "text",
  "forecast_window": "1d",
  "label": [
    "text"
  ],
  "location": {
    "saved_location_id": "text"
  },
  "algo": "phq-xgboost",
  "demand_type": {
    "interval": "day",
    "industry": "accommodation"
  }
}
{
  "errors": [
    "text"
  ],
  "warnings": [
    "text"
  ],
  "model_id": "text"
}

OpenAPI Spec

The OpenAPI spec for Forecasts API can be found here.

Guides

PreviousModelsNextUpdate Model

Last updated

Was this helpful?