Timeseries

{
  "title": "AI Regulation Timeline",
  "dataPoints": [
    { "timestamp": "2023-03", "label": "Italy temporarily bans ChatGPT over privacy concerns" },
    { "timestamp": "2023-06", "label": "EU Parliament passes draft AI Act" },
    { "timestamp": "2023-10", "label": "US Executive Order on AI safety signed by Biden" },
    { "timestamp": "2024-03", "label": "EU AI Act formally adopted" },
    { "timestamp": "2024-08", "label": "EU AI Act enters into force" },
    { "timestamp": "2025-02", "label": "First prohibited AI systems banned under EU AI Act" }
  ],
  "meta": {
    "total": 6,
    "executionTimeMs": 520
  }
}

POST

api

timeseries

{
  "title": "AI Regulation Timeline",
  "dataPoints": [
    { "timestamp": "2023-03", "label": "Italy temporarily bans ChatGPT over privacy concerns" },
    { "timestamp": "2023-06", "label": "EU Parliament passes draft AI Act" },
    { "timestamp": "2023-10", "label": "US Executive Order on AI safety signed by Biden" },
    { "timestamp": "2024-03", "label": "EU AI Act formally adopted" },
    { "timestamp": "2024-08", "label": "EU AI Act enters into force" },
    { "timestamp": "2025-02", "label": "First prohibited AI systems banned under EU AI Act" }
  ],
  "meta": {
    "total": 6,
    "executionTimeMs": 520
  }
}

Extract time-series data from a URL or uploaded file (PDF, Markdown). Returns a list of timestamped events or facts, organized chronologically.

Endpoints

Method	Path	Input
`POST`	`/api/v1/timeseries`	JSON body with `url`
`POST`	`/api/v1/timeseries/file`	`multipart/form-data` with `file`

POST /api/v1/timeseries

Request Body

string

required

URL of the page or document to extract time-series data from.

string

Language for the extracted data point labels (e.g. english, korean). Timestamps remain in ISO formats (YYYY, YYYY-MM, YYYY-MM-DD). Defaults to English.

number

default:"50"

Maximum number of time-series data points to extract. Range: 1–100.

cURL (URL)

curl -X POST "https://api.factagora.com/api/v1/timeseries" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/ai-act-history"}'

cURL (file upload)

curl -X POST "https://api.factagora.com/api/v1/timeseries/file" \
  -H "Authorization: Bearer fa_your_api_key" \
  -F "file=@report.pdf"

Python

resp = requests.post(
    "https://api.factagora.com/api/v1/timeseries",
    headers={"Authorization": "Bearer fa_your_api_key"},
    json={"url": "https://example.com/ai-act-history"},
)
data = resp.json()

POST /api/v1/timeseries/file

Request Body (multipart/form-data)

file

required

PDF or Markdown file to extract time-series data from.

curl -X POST "https://api.factagora.com/api/v1/timeseries/file" \
  -H "Authorization: Bearer fa_your_api_key" \
  -F "file=@report.pdf"

Response

string

Inferred title or description of the time-series.

array

List of time-series data points, sorted chronologically.

Show Data point fields

string

Normalized timestamp in one of: YYYY, YYYY-MM, or YYYY-MM-DD

string

Description of the event or fact at this point in time

object

Show Meta fields

number

Total number of data points

number

Response time in milliseconds

{
  "title": "AI Regulation Timeline",
  "dataPoints": [
    { "timestamp": "2023-03", "label": "Italy temporarily bans ChatGPT over privacy concerns" },
    { "timestamp": "2023-06", "label": "EU Parliament passes draft AI Act" },
    { "timestamp": "2023-10", "label": "US Executive Order on AI safety signed by Biden" },
    { "timestamp": "2024-03", "label": "EU AI Act formally adopted" },
    { "timestamp": "2024-08", "label": "EU AI Act enters into force" },
    { "timestamp": "2025-02", "label": "First prohibited AI systems banned under EU AI Act" }
  ],
  "meta": {
    "total": 6,
    "executionTimeMs": 520
  }
}

Overview

Endpoints

Best Practices

Endpoints

POST /api/v1/timeseries

Request Body

POST /api/v1/timeseries/file

Request Body (multipart/form-data)

Response

​Endpoints

​POST /api/v1/timeseries

​Request Body

​POST /api/v1/timeseries/file

​Request Body (multipart/form-data)

​Response

Endpoints

POST /api/v1/timeseries

Request Body

POST /api/v1/timeseries/file

Request Body (multipart/form-data)

Response