Phase 5: Public API Vendors
Phase 5: Public API Vendor Expansion
Status: ⚠️ In Progress
Started: 2026-04-06
Objective
Add productivity-focused public API integrations to netapi — APIs that bypass web frontends for search, reading, and data extraction from the terminal. Document CLI interfaces first (domus-netapi-docs), then implement in netapi codebase.
Rationale
Web frontends add friction: ads, infinite scroll, tracking, slow rendering. A CLI that returns JSON lets you pipe to jq, filter what matters, and stay in your workflow. Every API below has a free tier sufficient for personal productivity.
Vendor Progress
| Vendor | Auth Type | Docs | Code | Status |
|---|---|---|---|---|
YouTube Data API v3 |
API Key |
✅ Done |
❌ Not Started |
Documented — 451 lines, full CLI reference with jq patterns |
Hacker News |
None |
✅ Done |
❌ Not Started |
Documented — 360 lines, Firebase + Algolia APIs |
OAuth2 |
✅ Done |
❌ Not Started |
Documented — 426 lines, full OAuth2 setup + CLI reference |
|
Wikipedia |
None |
❌ Not Started |
❌ Not Started |
Planned — Tier 1 |
Google Custom Search |
API Key |
❌ Not Started |
❌ Not Started |
Planned — Tier 1 |
StackExchange |
API Key (optional) |
❌ Not Started |
❌ Not Started |
Planned — Tier 1 |
Todoist |
Bearer Token |
❌ Not Started |
❌ Not Started |
Planned — Tier 2 |
Spotify |
OAuth2 |
❌ Not Started |
❌ Not Started |
Planned — Tier 2 |
PyPI |
None |
❌ Not Started |
❌ Not Started |
Planned — Tier 3 |
OMDB |
API Key |
❌ Not Started |
❌ Not Started |
Planned — Tier 4 |
Auth Coverage
These vendors exercise all netapi auth providers:
-
NoAuth — Hacker News, Wikipedia, PyPI (zero setup)
-
ApiKeyAuth — YouTube, Google Search, StackExchange, OMDB (API key in query param or header)
-
BearerAuth — Todoist, Spotify (bearer token from developer portal)
-
OAuth2 — Reddit (client credentials flow), Spotify (authorization code flow)
Key CLI Design Decisions
-
All commands support
-f jsonfor jq piping (matches GitHub/Cloudflare pattern) -
YouTube includes yt-dlp integration: playlist video IDs pipe directly to yt-dlp
-
Reddit OAuth2 documented as full walkthrough (token acquisition, refresh, env vars)
-
Hacker News uses both Firebase (real-time) and Algolia (search) APIs