Data freshness
How current is the data you can query right now? Here "freshness" is measured by source_fetched_at — when jpcite retrieved the source — not by the original publication date at the source.
What to check
- Fresh (within 30 days) — somewhat old (30–180 days) — old (over 180 days).
- Most published rows carry a primary-source URL and fetch timestamp. Each response exposes
source_url,source_fetched_at, andknown_gaps. - Use
source_fetched_atto decide whether a returned record is fresh enough for your workflow. - Pair freshness checks with Data sources and the public audit log (change-detection RSS) for source and change context.
Update heatmap (19 series)
Daily / weekly / monthly updates for 19 series — adoption RSS, e-Gov laws, enforcement actions, municipal subsidies, patents, EDINET, invoice registrants, and more — are arranged across four lanes (ingest / settle / monitor / weekend) and rolled up every day at 10:00 JST. The data is available as JSON from /analytics/freshness_rollup_latest.json.
SLA = a latest run within 24h, no failure/timeout, and a 24h success_rate ≥ 50%. SLA breaches trigger a Telegram notification.
| Lane | Series | UTC cron | JST | SLA (h) | Target | Purpose |
|---|---|---|---|---|---|---|
| A | Knowledge graph | 0 17 * * * | 02:00 | 24 | Program data | Search-assist index update |
| A | Program portfolio | 30 17 * * * | 02:30 | 24 | Program data | Program-combination update |
| A | Entity risk | 0 18 * * * | 03:00 | 24 | Entity data | Entity risk-score update |
| A | EDINET | 30 19 * * * | 04:30 | 24 | Disclosure data | EDINET disclosure ingest |
| A | Adoption RSS | 0 20 * * * | 05:00 | 24 | Adoption data | Adoption RSS ingest |
| B | Program recommendation | 45 20 * * * | 05:45 | 24 | Program data | Aggregation for recommend / compare |
| B | e-Gov law amendments | 0 21 * * * | 06:00 | 24 | Law data | e-Gov law-amendment detection |
| B | Quality metrics | 15 21 * * * | 06:15 | 24 | Public metrics | Published quality metrics |
| B | Enforcement actions | 0 22 * * * | 07:00 | 24 | Enforcement data | Enforcement-action press |
| C | Budget → subsidy | 0 23 * * * | 08:00 | 24 | Program data | Budget → subsidy chain |
| C | JPO patents | 30 23 * * * | 08:30 | 24 | Patent data | JPO patent publication |
| C | Invoice registrants | 0 0 * * * | 09:00 | 24 | Invoice data | Invoice-registrant delta |
| D | Municipal subsidies | 0 18 * * 0 (Sun) | 03:00 | 168 | Municipal data | 47-prefecture municipalities |
| D | Definition updates | 0 18 * * 4 (Thu) | 03:00 | 168 | Program data | Definition promotion |
| D | Partnership opportunities | 0 20 * * 0 (Sun) | 05:00 | 168 | Program data | Partnership-opportunity aggregation |
| D | Multilingual | 0 4 * * 0 (Sun) | 13:00 | 168 | Translation data | EN / KO / ZH fill |
| D | Expansion corpus | 0 2 * * 2 (Tue) | 11:00 | 168 | Public materials | Diet / council / brand mentions |
| D | Monthly report | 0 21 1 * * (Day 1) | 06:00 | 744 | Public metrics | Monthly PDF |
| D | Long-range forecast | 0 19 4 * * (Day 4) | 04:00 | 744 | Program data | 30-year subsidy-cycle forecast |
Lane definitions: A = ingest (03–05 JST) / B = settle (05–07 JST) / C = monitor (07–09 JST) / D = weekend & monthly. For the operating model, see the SLA / operations page.
Reading freshness as an Evidence Packet, before the AI answers
When an AI cites a program basis, treat the Evidence Packet's source_url as the primary-source URL and source_fetched_at as the fetch time. Check old rows and not-yet-fetched areas alongside known_gaps, and in the answer text separate "what could be confirmed" from "what is unconfirmed".
To try anonymously, see the free 3-checks-per-day quick start; for source agencies and licenses, see Data sources.
Program feeds (RSS)
Program feeds you can subscribe to in Feedly / Inoreader / Google Discover — usable as an alternative to municipal sites or chamber-of-commerce pages. Each feed holds up to 100 items and is regenerated weekly.
- Tier S program feed — high-confidence subsidies / loans / tax rules / certifications (nationwide).
- Program-amendment detection log — deltas of amount, subsidy rate, eligibility, and source URL.
- Change-history RSS — RSS distribution of the existing audit log.
- Announcements RSS — releases, data ingests, and major migrations.
Per-prefecture feeds are enumerated in /assets/rss-feeds.json (47 prefectures, up to 100 items each across Tier S+A+B+C).
For the live Japanese freshness screen, see the Japanese page. For English FDI use cases, see jpcite for foreign-invested entities.