# War-Tracker

> War-Tracker is a live, real-time OSINT map of military strikes, naval activity,
> and conflict events worldwide. Events are sourced from public social media posts,
> classified by an LLM pipeline, and surfaced on a slugged per-event URL with a
> stable canonical, JSON-LD `NewsArticle` + `Event` + `VideoObject`, and a public
> read-only JSON API.

## Docs

- [About](https://war-tracker.com/about): organization, contact, social profiles.
  Email: sales@war-tracker.com (sales, partnerships, paid-access enquiries).
- [Methodology](https://war-tracker.com/methodology): how we source, classify, and
  publish events; confidence levels; update cadence; what we do not claim.
- [Pricing](https://war-tracker.com/pricing): human-readable per-route USDC pricing
  for AI training crawlers, who pays and who is free, and how to pay via x402.

## Data

- [Public JSON API (v1)](https://war-tracker.com/api/v1/openapi.json): OpenAPI 3.x
  spec. Anonymous read, 60 req/min/IP, CORS open. Endpoints:
  - [`/api/v1/events`](https://war-tracker.com/api/v1/events) - paginated list of
    classified strike/event rows. Filters: `country` (ISO 3166-1 alpha-2),
    `region` (slug), `event_type`, `from`, `to`, `cursor`, `limit`.
  - [`/api/v1/events/{id}`](https://war-tracker.com/api/v1/events/1) - single event
    by id.
  - [`/api/v1/regions`](https://war-tracker.com/api/v1/regions),
    [`/api/v1/countries`](https://war-tracker.com/api/v1/countries),
    [`/api/v1/event-types`](https://war-tracker.com/api/v1/event-types) - taxonomy.

## Live coverage

- [Site index sitemap](https://war-tracker.com/sitemap.xml) - root sitemap
  pointing at all per-event and hub shards.
- [Recent events sitemap](https://war-tracker.com/sitemaps/events-recent.xml) -
  last 30 days, freshest first.
- [Hubs sitemap](https://war-tracker.com/sitemaps/hubs.xml) - region, country,
  and event-type aggregate pages.

## Hubs

- [Region pages](https://war-tracker.com/region/eastern-europe): 15 hand-curated
  geographic regions (e.g. eastern-europe, middle-east, strait-of-hormuz, red-sea,
  east-africa, west-africa, sahel, central-asia, south-asia, east-asia,
  south-china-sea, southeast-asia, latin-america).
- [Country pages](https://war-tracker.com/country/UA): one page per ISO 3166-1
  alpha-2 country with active coverage.
- [Event-type pages](https://war-tracker.com/event-type/military-strike): one
  page per classified event type.

## Per-event

- URL shape: `/share/{event_id}/{slug}` where `slug` is `{event_type}-{location}`
  kebab-cased. Legacy `/share/{event_id}` and `/?event={event_id}` 301 to the
  slugged canonical.
- Each event page emits a JSON-LD `@graph` containing `NewsArticle`, `Event` (when
  lat/lng known), `VideoObject` (when the row is video), plus `BreadcrumbList`,
  `Organization`, and `FAQPage`.

## Citation

Cite events by stable URL: `https://war-tracker.com/share/{event_id}/{slug}`.
`NewsArticle.dateModified` reflects the last edit to the underlying source
post. `NewsArticle.author` and `publisher` are War-Tracker (Organization).

## AI training crawler payment policy (x402)

War-Tracker requires *training* AI crawlers (GPTBot, ClaudeBot, anthropic-ai,
Google-Extended, Applebot-Extended, CCBot, Bytespider, cohere-ai, Diffbot,
Meta-ExternalAgent) to pay a USDC micropayment via the [x402 protocol](https://x402.org)
on each request to paid surfaces:

- `/share/{id}/{slug}` — per-event article ($0.001). HTML by default;
  send `Accept: application/json` to get the same payload as
  `/api/v1/events/{id}` instead.
- `/api/v1/events` — paginated event corpus ($0.005).
- `/api/v1/events/{id}` — single event with full JSON-LD graph ($0.001).
- `/media/{event_id}` — full photo or video bytes ($0.01).
- `/region/{slug}`, `/country/{ISO}`, `/event-type/{slug}` — hub pages ($0.0005).
- `/llms-full.txt` — full crawler-targeted corpus dump (gating tracked
  separately; currently served by nginx).

Schema-discovery endpoints (`/api/v1/regions`, `/api/v1/countries`,
`/api/v1/event-types`) are FREE for everyone, including training bots —
every agent needs them to know how to filter the corpus.

Runtime fetchers (ChatGPT-User, Claude-User, Perplexity-User), AI-search
crawlers (OAI-SearchBot, Claude-SearchBot, PerplexityBot), and classic
search engines (Googlebot, bingbot) are NEVER charged.

- Policy and pricing (HTML): [https://war-tracker.com/x402](https://war-tracker.com/x402)
- Machine-readable policy (JSON): [https://war-tracker.com/x402.json](https://war-tracker.com/x402.json)
- Settlement: USDC on Base (mainnet `eip155:8453`, testnet `eip155:84532`)
- Facilitator: `https://www.x402.org/facilitator` (Coinbase public facilitator)
- Discovery: War-Tracker's paid routes carry the [x402 Bazaar](https://docs.x402.org/extensions/bazaar)
  extension on every 402 response and are listed at
  `https://www.x402.org/facilitator/discovery/resources`. Buyers can also fetch
  the catalog via the `x402[httpx]` Python SDK or the `@x402/extensions`
  TypeScript package; filter by tag (`war`, `conflict`, `events`, …) or
  search for "war-tracker" to find this service.
- Discovery surfaces (`/`, `/about`, `/methodology`, `/pricing`,
  `/robots.txt`, `/sitemap*.xml`, `/llms.txt`, `/x402`, `/x402.json`,
  `/api/v1/openapi.json`, `/api/v1/regions`, `/api/v1/countries`,
  `/api/v1/event-types`, `/video/thumb/*`) remain free for all bots —
  including training crawlers — so the policy is self-describing.