Skip to main content
POST
/
api
/
v1
/
timeseries
curl -X POST "https://api.factagora.com/api/v1/timeseries" \
  -H "Authorization: Bearer fag_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://data.worldbank.org/indicator/NY.GDP.MKTP.CD?locations=US"}'

{
  "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

MethodPathInput
POST/api/v1/timeseriesJSON body with url
POST/api/v1/timeseries/filemultipart/form-data with file

​
POST /api/v1/timeseries

​
Request Body

​
url
string
required
URL of the page or document to extract time-series data from.
​
language
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.
​
limit
number
default:"50"
Maximum number of time-series data points to extract. Range: 1–100.
curl -X POST "https://api.factagora.com/api/v1/timeseries" \
  -H "Authorization: Bearer fag_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://data.worldbank.org/indicator/NY.GDP.MKTP.CD?locations=US"}'

​
POST /api/v1/timeseries/file

​
Request Body (multipart/form-data)

​
file
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 fag_your_api_key" \
  -F "file=@report.pdf"

​
Response

​
title
string
Inferred title or description of the time-series.
​
dataPoints
array
List of time-series data points, sorted chronologically.
​
meta
object
{
  "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
  }
}