# cheapass

> Utility APIs under one $5/mo bill — feeds, social posting, web fetching, reference data, geo, and more. One key, one bill, no "contact sales."

cheapass is a developer API platform. Every product is an HTTP API under `/v1/<product>`. This index is generated from the product catalog — the single source of truth.

## Live products
- [Social](https://cheapass.dev/docs/social): Post to X, Bluesky, and Threads through one headless API (BYOK).
- [Assistant](https://cheapass.dev/docs/assistant): A read-only AI helper for finding feeds, your subscriptions, and the cheapass CLI.
- [Feeds](https://cheapass.dev/docs/feeds): Curated RSS/Atom reader. Each source is fetched once globally; reads are fast and deduped.
- [Connect](https://cheapass.dev/docs/connect): A reusable OAuth connection vault. Authenticate once, request scoped tokens from any project.
- [RSS](https://cheapass.dev/docs/rss): Fetch, discover, convert, merge, and monitor feeds — anything in, normalized items out.
- [Web](https://cheapass.dev/docs/web): URL in, clean data out — markdown for RAG, metadata, a real headless browser, change monitoring.
- [Geo](https://cheapass.dev/docs/geo): Geocoding, boundaries, places, routing, timezones, IP & country lookups — one location API.
- [Utils](https://cheapass.dev/docs/utils): Small, fast developer utilities — QR, favicon, avatars, hashing, DNS, validation, and more.
- [OG Images](https://cheapass.dev/docs/og): Social-card images from a GET request — a URL you can put straight in an og:image tag.
- [Trends](https://cheapass.dev/docs/trends): News-anchored cultural momentum. Track how much the world is paying attention to a term over time, and what's rising now.
- [Sports](https://cheapass.dev/docs/sports): Scores for 40+ leagues from upstream APIs we no longer name. Two tiers: Sports Scores ($10/mo, a fresh snapshot every ~10s) and Live Sports Scores ($100/mo, sub-second push over WebSocket). Paid plan required.
- [CV](https://cheapass.dev/docs/cv): Computer vision and image processing over HTTP. OpenCV and libvips do the hard part; we run them and forward the bill.
- [Games](https://cheapass.dev/docs/games): A bring-your-own-game multiplayer engine: rooms, presence, chat, relay, leaderboards.
- [Podcasts](https://cheapass.dev/docs/podcasts): Upload audio segments, get a hosted podcast: stitched episodes, RSS, CDN, analytics.
- [Platform](https://cheapass.dev/docs/platform): The account & meta API under every product: identity, keys, catalog, health, OpenAPI.
- [Gate](https://cheapass.dev/docs/gate): One password, any site. Put a shared password in front of a preview, a staging box, a private page.

## Coming soon (specced; returns 501 until shipped)
- [Text](https://cheapass.dev/docs/text): Cheap text utilities — summarize, extract entities, classify, detect language & sentiment.
- [Search](https://cheapass.dev/docs/search): Web and news search through one API, plus trending detection across your feeds.
- [Data](https://cheapass.dev/docs/data): One API over dozens of free public datasets — weather, finance, health, drugs, gov, science, and more.
- [Events](https://cheapass.dev/docs/events): Real-time structured event streams — disasters, space, aviation, internet health.
- [Transit](https://cheapass.dev/docs/transit): Public-transit agencies, routes, stops, real-time positions, and trip planning.
- [Links](https://cheapass.dev/docs/links): Create branded short links and track clicks.

## Reference
- [Full reference](https://api.cheapass.dev/llms-full.txt): the complete reference in one file — every product, every endpoint, schemas and runnable examples included
- [OpenAPI 3.1 spec](https://api.cheapass.dev/v1/openapi.json): machine-readable spec for every endpoint
- [Product catalog (JSON)](https://api.cheapass.dev/v1/products): the source of truth behind these docs
- [Per-product detail (JSON)](https://api.cheapass.dev/v1/products/social): same shape per product
- [Platform status (JSON)](https://api.cheapass.dev/v1/status): live operational status