# TransitPulse

> Global transit intelligence API. Real-time status, city briefs, route reliability, commute analysis, city comparisons, airport guides, car-free scoring, and visitor guides for 25+ world cities. Pay-per-query via x402 micropayments on Base.

Base URL: https://transitpulse.vercel.app
Payment: x402 protocol, USDC on Base mainnet, $0.05–$0.12 per query
Network: PulseNetwork (https://pulsenetwork.vercel.app)

Cities covered (hardcoded intelligence): New York City, London, Tokyo, Paris, Chicago, San Francisco, Washington DC, Boston, Los Angeles, Seattle, Sydney, Melbourne, Berlin, Amsterdam, Singapore, Toronto, Vancouver, Seoul, Hong Kong, and more via transit.land + Tavily.

---

## Endpoints

### GET /api/transit/status — Live Service Status ($0.05)
Real-time transit service alerts and disruptions for a city or line.
Params: city (required), line (optional)
Example: /api/transit/status?city=London
Example: /api/transit/status?city=NYC&line=L+train

### GET /api/transit/city — City Transit Intelligence Brief ($0.08)
Comprehensive transit briefing for any major world city. Network overview, reliability scores, fares, airport connections, tourist gotchas, commuter setup guide.
Params: city (required)
Example: /api/transit/city?city=Tokyo
Example: /api/transit/city?city=Berlin

### GET /api/transit/route — Route Reliability Analysis ($0.08)
Is this route trustworthy for a 9am meeting? Reliability score, worst times, buffer to add, alternatives.
Params: city (required), route (required), time (optional)
Example: /api/transit/route?city=NYC&route=L+train&time=9am
Example: /api/transit/route?city=London&route=Northern+line

### GET /api/transit/commute — Commute Quality Analysis ($0.10)
Commute intelligence for a corridor — options, peak-hour reality, monthly cost, vs-driving.
Params: city (required), from (optional), to (optional), time (optional)
Example: /api/transit/commute?city=Chicago&from=Wicker+Park&to=The+Loop

### GET /api/transit/airport — Airport Transit Guide ($0.08)
Transit-to-airport feasibility, step-by-step, early morning availability, vs-taxi.
Params: city (required), airport (optional IATA code or name), flight_time (optional)
Example: /api/transit/airport?city=NYC&airport=JFK&flight_time=6am
Example: /api/transit/airport?city=Tokyo&airport=NRT

### GET /api/transit/agencies — Transit Agencies Lookup ($0.05)
All operators serving a city — what each runs, payment cards, coverage area.
Params: city (required)
Example: /api/transit/agencies?city=San+Francisco

### GET /api/transit/delays — Current Delays ($0.05)
Active disruptions right now and what to do about them.
Params: city (required), line (optional)
Example: /api/transit/delays?city=NYC

### GET /api/transit/delays-history — Historical Delay Patterns ($0.08)
Reliability history — chronic issues, worst periods, trend, planning advice.
Params: city (required), line (optional)
Example: /api/transit/delays-history?city=Boston&line=Green+Line

### GET /api/transit/trip — Trip Planning ($0.10)
Step-by-step transit directions with timing, transfers, fare, reliability rating.
Params: from (required), to (required), time (optional), city (optional)
Example: /api/transit/trip?from=Brooklyn+NY&to=JFK+Airport&time=8am

### GET /api/transit/multimodal — Multi-Modal Journey ($0.10)
Optimized routing combining transit, bike, ferry, walking.
Params: from (required), to (required), time (optional)
Example: /api/transit/multimodal?from=Amsterdam+Centraal&to=Schiphol+Airport

### GET /api/transit/compare — City-to-City Comparison ($0.12)
Scored comparison across reliability, coverage, affordability, night service, airport, visitor ease.
Params: city_a (required), city_b (required) OR cities=NYC,London
Example: /api/transit/compare?city_a=NYC&city_b=London
Example: /api/transit/compare?city_a=Tokyo&city_b=Singapore

### GET /api/transit/carfree — Car-Free Livability Score ($0.12)
Honest assessment of car-free living — what works, what doesn't, daily scenarios, best neighborhoods.
Params: city (required), neighborhood (optional)
Example: /api/transit/carfree?city=Chicago&neighborhood=Wicker+Park

### GET /api/transit/visitor — Visitor Transit Guide ($0.08)
First-timer guide — arrival setup, common mistakes, payment, apps, night travel.
Params: city (required)
Example: /api/transit/visitor?city=Tokyo

### GET /api/transit/coverage — Transit Coverage Analysis ($0.10)
Transit desert mapping — strong areas, gaps, equity notes, planned expansions.
Params: city (required)
Example: /api/transit/coverage?city=Los+Angeles

---

## Payment
All endpoints require x402 payment header (PAYMENT-SIGNATURE).
On 402 response, read PAYMENT-REQUIRED header for payment details.
USDC on Base mainnet (eip155:8453).
Wallet: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Data Sources
- TransitPulse City Intelligence (hardcoded, 25+ cities — no API key required)
- Transport for London API (live status, free, no key needed for basic use)
- transit.land REST API (2,000+ operators globally, free key)
- Tavily AI web search (real-time disruptions and supplemental data)
- Claude (synthesis and intelligence layer)

## Network
Part of PulseNetwork — 37 specialized intelligence APIs.
https://pulsenetwork.vercel.app