Json To Timeline API

POST https://api.findutils.com/api/tools/json-to-timeline/execute

Generate the HTML for a timeline (div.timeline with .timeline-event/.event-marker/.event-content classes) from JSON of the form {"title","orientation","events":[{"date","title","description","color"}]}. Returns the HTML, the orientation, and a summary of each event.

Needs an API key. Running a tool needs an API key. Keys are not for sale yet: ask for early access. About API keys

Open the tool Try it

Request body

application/json

json

string required

Timeline JSON: {"title"?: string, "orientation"?: "vertical"|"horizontal", "events": [{"date": string, "title": string, "description"?, "color"?: "#hex"}]}.
orientation

string optional

Override the orientation from the JSON. Default: the JSON "orientation", else "vertical". One of vertical · horizontal.

Example arguments

Verified

{
  "json": {
    "title": "History",
    "events": [
      {
        "date": "2020",
        "title": "Founded",
        "color": "#10b981"
      },
      {
        "date": "2021",
        "title": "Launch"
      }
    ]
  }
}

curl -X POST https://api.findutils.com/api/tools/json-to-timeline/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "json": "{\"title\":\"History\",\"events\":[{\"date\":\"2020\",\"title\":\"Founded\",\"color\":\"#10b981\"},{\"date\":\"2021\",\"title\":\"Launch\"}]}"
  }'

const response = await fetch('https://api.findutils.com/api/tools/json-to-timeline/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
  body: JSON.stringify({"json":"{\"title\":\"History\",\"events\":[{\"date\":\"2020\",\"title\":\"Founded\",\"color\":\"#10b981\"},{\"date\":\"2021\",\"title\":\"Launch\"}]}"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/json-to-timeline/execute",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"json":"{\"title\":\"History\",\"events\":[{\"date\":\"2020\",\"title\":\"Founded\",\"color\":\"#10b981\"},{\"date\":\"2021\",\"title\":\"Launch\"}]}"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/json-to-timeline/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => '{"json":"{\"title\":\"History\",\"events\":[{\"date\":\"2020\",\"title\":\"Founded\",\"color\":\"#10b981\"},{\"date\":\"2021\",\"title\":\"Launch\"}]}"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call json_to_timeline from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: API key
REST id: json-to-timeline
MCP name: json_to_timeline
Category: Generators
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Generators tools

More to explore