Upload Demand Data
Upload your demand data as CSV, line-delimited JSON or JSON.
Beam Analyses support daily or weekly demand data. The type of data is detected automatically on upload.
For daily demand the minimum amount of data required is 6 months, or 180 data points. Beam can impute up to 20% of missing values, provided that the minimum data requirements are satisfied and there are no more than 7 consecutive days missing.
For weekly demand the minimum amount of data required is 2 years, or 104 data points. Beam can impute up to 10% of missing values, provided that the minimum data requirements are satisfied and there are no more than 5 consecutive weeks missing. All weekly data points must align with the start of the week and occur on the same weekday.
All data points need to be between 2017-01-01 and one year into the future from today's date (today + 365 days).
Uploading data replaces existing data for the same date. It's not currently possible to remove data for a particular date. The idea with this endpoint is that you're continuously adding new demand data over time.
Request
HTTP Request
POST https://api.predicthq.com/v1/beam/analyses//sink
Path Parameters
analysis_id
An existing Beam Analysis ID.
Request Headers
Content-Type
Must be one of the following:
text/csv
application/x-ndjson
application/json
application/x-ldjson
(deprecated)
Note: application/x-ldjson
has been deprecated in favor of application/x-ndjson
. However the data format is exactly the same (newline delimited JSON). We recommend using application/x-ndjson
Request Body
You can upload the demand data for your analysis in any of the following formats:
The request body should contain comma-separated values that represent multiple data points with the column names (in lowercase) as date
and demand
, demonstrated by the example below:
date,demand
2023-01-01,12.235
2023-01-02,11.4
2023-01-03,12.14
The following request headers must be set:
Content-Type
text/csv
Column Types:
date
string
required
ISO8601 Date format (YYYY-MM-DD
)
E.g., 2023-01-01
demand
number
required
Number value (float or integer, must be a positive number).
Demand will typically be the demand you use in your demand forecast if you are forecasting. For example, it could be units sold, room bookings, or number of staff rostered on per day or any other unit.
E.g., 12.235
Response
If successful, the HTTP response code will be 202 Accepted
.
Examples
curl -X POST "https://api.predicthq.com/v1/beam/analyses/$ANALYSIS_ID/sink" \
-H "Content-Type: text/csv" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data @data.csv
Guides
Below are some guides relevant to this API:
Last updated
Was this helpful?