Export and embed
How do I export and embed SIREN data?
Every number SIREN publishes is downloadable, embeddable and free to reuse under CC BY 4.0 with a credit line. Files rebuild with each hourly reading; this page was built from the reading at 2026-10-15 05:21:57 UTC.
What can I download?
How do I download every reading as CSV?
/api/history.csv
t, score, level, degraded, rule_fired and one column per pillar. 610 rows today; opens in Excel, Sheets, pandas.
How do I download every reading as JSON?
/api/history.json
The same observations plus every per-source score.
How do I download current pillars as CSV?
/api/pillars.csv
The five pillars right now: score, percentile, sources ok, dark and uncalibrated flags.
How do I download the current reading as JSON?
/api/state.json
Everything on the homepage, including each source's raw value and its receipt hash.
How do I download the current reading as one line of text?
/api/latest.txt
For shell prompts, status bars and chat bots: curl it and print it.
Where is the API index?
/api/index.json
Every endpoint, including per-reading receipts at api/receipts/{id}.json.
How do I use it live in Google Sheets?
=IMPORTDATA("https://siren.watch/api/history.csv")
How do I embed the current reading?
The widget is a 320×152 box that redraws with every reading and matches light or dark pages. It renders the number server-side, so it still shows with scripts blocked.
How do I embed the widget iframe?
<iframe src="https://siren.watch/embed.html" width="320" height="152" style="border:0;max-width:100%" loading="lazy" title="SIREN: AI activity tempo"></iframe>
What badge works when iframes are stripped?
How do I add the badge in HTML?
<a href="https://siren.watch/"><img src="https://siren.watch/badge.svg" alt="SIREN current level" height="20"></a>
How do I add the badge in Markdown?
[](https://siren.watch/)
How do I use the share card image?
<a href="https://siren.watch/"><img src="https://siren.watch/cards/state.png" alt="SIREN current reading" width="600" style="max-width:100%;height:auto"></a>
How do I use it from code?
How do I fetch it from JavaScript?
fetch('https://siren.watch/api/state.json')
.then((r) => r.json())
.then((s) => {
// s.score 0-100, s.level 5 (quietest) .. 1 (loudest), s.level_name
// s.pillars[] {id, name, score, dark}, s.generated_at (UTC)
document.querySelector('#siren').textContent =
`SIREN ${s.level} · ${s.level_name} · ${s.score.toFixed(1)}`;
});
How do I fetch it from the shell?
curl -s https://siren.watch/api/latest.txt
CORS: the site is served by GitHub Pages, which sends Access-Control-Allow-Origin: *, so these files can be fetched from any web page without a proxy. No key, no rate limit beyond GitHub's own. Please cache: data changes about once an hour.
What is the licence and credit?
Text and data are CC BY 4.0. Reuse anything, commercially too, with this line (or an equivalent) next to it:
What attribution line should I use?
Data: SIREN (https://siren.watch/), CC BY 4.0. Activity tempo, not probability of harm.
SIREN measures how much is happening, not how bad it is. Levels run from 5 (quietest) to 1 (loudest) and describe observable activity tempo against this index’s own record. They are not a probability of harm. Want an alert instead of a file? See How do I get alerts when SIREN moves?.
What questions do people actually ask?
How do I export and embed SIREN data?
Every number SIREN publishes is downloadable, embeddable and free to reuse under CC BY 4.0 with a credit line. Files rebuild with each hourly reading.
What can I download?
Every reading as CSV or JSON, current pillars as CSV, the current reading as JSON or one line of text, and an API index that lists every endpoint including per-reading receipts.
How do I embed the current reading?
The widget is a 320×152 box that redraws with every reading and matches light or dark pages. It renders the number server-side, so it still shows with scripts blocked.
How do I use it from code?
No key, no rate limit beyond GitHub's own. The site sends Access-Control-Allow-Origin: *, so these files can be fetched from any web page without a proxy. Please cache: data changes about once an hour.
What is the licence and credit?
Text and data are CC BY 4.0. Reuse anything, commercially too, with a credit line next to it.
What files can I download?
Every reading as CSV or JSON, current pillars as CSV, the current reading as JSON or one line of text, and an API index that lists every endpoint including per-reading receipts.
Do I need an API key?
No key, no rate limit beyond GitHub's own. The site sends Access-Control-Allow-Origin: *, so these files can be fetched from any web page without a proxy. Please cache: data changes about once an hour.
Does exporting move the SIREN score?
It never moves the SIREN score. Downloads, embeds and API fetches are separate from the tempo index.
How do I download every reading as CSV?
t, score, level, degraded, rule_fired and one column per pillar. 610 rows today; opens in Excel, Sheets, pandas.
How do I download every reading as JSON?
The same observations plus every per-source score.
How do I download current pillars as CSV?
The five pillars right now: score, percentile, sources ok, dark and uncalibrated flags.
How do I download the current reading as JSON?
Everything on the homepage, including each source's raw value and its receipt hash.
How do I download the current reading as one line of text?
For shell prompts, status bars and chat bots: curl it and print it.
Where is the API index?
Every endpoint, including per-reading receipts at api/receipts/{id}.json.
How do I use it live in Google Sheets?
Paste the Sheets formula from this page into a cell. Files rebuild with each hourly reading.
How do I embed the widget iframe?
The widget is a 320×152 box that redraws with every reading and matches light or dark pages. It renders the number server-side, so it still shows with scripts blocked.
What badge works when iframes are stripped?
Use the badge SVG for READMEs and newsletters that strip iframes. HTML and Markdown snippets are printed beside the preview.
How do I add the badge in HTML?
Copy the Badge (HTML) snippet on this page next to the badge preview.
How do I add the badge in Markdown?
Copy the Badge (Markdown) snippet on this page next to the badge preview.
How do I use the share card image?
The share card is a 1200×675 PNG. Copy the snippet on this page.
How do I fetch it from JavaScript?
No key. Fetch the published JSON or text endpoints from any web page; cache about once an hour.
How do I fetch it from the shell?
curl the published text endpoint. No key beyond GitHub's own limits.
What attribution line should I use?
Text and data are CC BY 4.0. Reuse anything, commercially too, with the attribution line printed on this page.
Search-shaped sibling: How do you check a SIREN reading yourself? · What free tools does SIREN publish? · How do I get alerts when SIREN moves? · How should AI agents use SIREN?.
How the SIREN AI activity index is computed · methodology · How do I report a problem or send an idea to SIREN?