Export analytics data

Retrieve a pre-signed download URL, wait for the file to be ready, and download the result.

Data files expire after 7 days. Download them as soon as the pre-signed URL is ready.

Export flow

1. Call the Data API

   Send a GET request to https://portal.webless.ai/query-data with:

   • company
   • start_date
   • end_date
   • x-api-key in the request headers
2. Store the pre-signed URL

   A successful request returns 202 Accepted and a presigned_url. That URL becomes valid once the export file is written.

3. Poll until the file is ready

   Poll the presigned_url every 10 seconds with the Range: bytes=0-0 header. Stop polling when the response returns 200 OK or 206 Partial Content.

4. Download the full file

   Reuse the same pre-signed URL to download the completed file.

Request parameters

Parameter	Required	Format	Description
company	Yes	string	Your client code
start_date	Yes	YYYY-MM-DD	Start of the date range, inclusive
end_date	Yes	YYYY-MM-DD	End of the date range, inclusive

Example request

GET https://portal.webless.ai/query-data?company=webless&start_date=2025-07-01&end_date=2025-07-03
x-api-key: YOUR_API_KEY

Example response

{
  "presigned_url": "https://webless-client-data.s3.us-west-1.amazonaws.com/athena-results/<QUERY_ID>.csv?X-Amz-..."
}

Sample code

export_data.py

import time
import requests

API_KEY = "YOUR_API_KEY"
API_URL = "https://portal.webless.ai/query-data"

response = requests.get(
    API_URL,
    params={
        "company": "webless",
        "start_date": "2025-07-01",
        "end_date": "2025-07-03",
    },
    headers={"x-api-key": API_KEY},
    timeout=30,
)
response.raise_for_status()
url = response.json()["presigned_url"]

while True:
    probe = requests.get(url, headers={"Range": "bytes=0-0"})
    if probe.status_code in (200, 206):
        break
    time.sleep(10)

download = requests.get(url, stream=True)
download.raise_for_status()

with open("webless_results.csv", "wb") as outfile:
    for chunk in download.iter_content(8192):
        outfile.write(chunk)

Error handling

Status	Meaning
400	Missing or invalid parameter
403	Invalid or missing API key
404	Incorrect endpoint
429	Rate limit exceeded
500	Server error

For assistance, email [e-mail]. The source guide states a business-day response target of 4 hours.