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

{
  "title": "US GDP (Current USD)",
  "unit": "trillion USD",
  "dataPoints": [
    { "timestamp": "2020-01-01", "value": 21.1, "label": "2020" },
    { "timestamp": "2021-01-01", "value": 23.0, "label": "2021" },
    { "timestamp": "2022-01-01", "value": 25.5, "label": "2022" },
    { "timestamp": "2023-01-01", "value": 27.4, "label": "2023" }
  ],
  "meta": {
    "total": 4,
    "executionTimeMs": 520
  }
}
Extract structured timeseries data from a given URL or text content. Returns a list of timestamped data points with values and labels.

​
Request Body

​
url
string
URL of the page or document to extract timeseries data from.
​
text
string
Raw text content to extract timeseries data from.
At least one of url or text is required.

​
Response

​
title
string
Inferred title or description of the timeseries.
​
unit
string
Unit of the values, if detected. Example: USD, %, million
​
dataPoints
array
List of timeseries data points.
​
meta
object
curl -X POST "https://api.factagora.com/api/v1/timeseries" \
  -H "Authorization: Bearer fct_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://data.worldbank.org/indicator/NY.GDP.MKTP.CD?locations=US"}'

{
  "title": "US GDP (Current USD)",
  "unit": "trillion USD",
  "dataPoints": [
    { "timestamp": "2020-01-01", "value": 21.1, "label": "2020" },
    { "timestamp": "2021-01-01", "value": 23.0, "label": "2021" },
    { "timestamp": "2022-01-01", "value": 25.5, "label": "2022" },
    { "timestamp": "2023-01-01", "value": 27.4, "label": "2023" }
  ],
  "meta": {
    "total": 4,
    "executionTimeMs": 520
  }
}