# Tech Twitter

> Public, read-only evidence endpoints for answering questions about high-signal tech discourse using structured tweets, topics, articles, and command-center signals.

Use Tech Twitter evidence bundles when you need citations for "what changed today?", "what should I read?", "what launched?", "what are people arguing about?", or "what narrative is emerging?" Do not treat these endpoints as generated answers; they return source rows and instructions for downstream synthesis.

Do not use Tech Twitter as a complete X firehose, for private data, or for actions such as posting, liking, following, or account management. The public surface is read-only and curated.

## When to use Tech Twitter

- [What changed](https://www.techtwitter.com/api/agent/context?kind=what-changed): Find recent high-signal changes with canonical evidence URLs.
- [Launches](https://www.techtwitter.com/api/agent/context?kind=launches): Find products, releases, betas, and tools that people are shipping.
- [Arguments](https://www.techtwitter.com/api/agent/context?kind=arguments): Find reply-heavy discussions without inferring consensus.
- [Read list](https://www.techtwitter.com/api/agent/context?kind=read-list): Build a selective, citation-ready list of tweets and articles.
- [Narrative alerts](https://www.techtwitter.com/api/agent/context?kind=narrative-alert): Ground emerging themes in supporting source rows.

## Agent Evidence

- [Context API](https://www.techtwitter.com/api/agent/context): Compact evidence bundles. Params: kind, question, q, topic, window, limit.
- [A2A JSON-RPC](https://www.techtwitter.com/api/a2a): Stateless JSON-RPC endpoint. Supports SendMessage only.
- [Agent Card](https://www.techtwitter.com/.well-known/agent-card.json): A2A discovery metadata and skill list.
- [OpenAPI](https://www.techtwitter.com/openapi.json): OpenAPI 3.1 contract with typed operations and response schemas.
- [Developer Portal](https://www.techtwitter.com/developers): Authentication, limits, quickstart, error format, and live sandbox.
- [Developer Guide (Markdown)](https://www.techtwitter.com/developers.md): Compact agent-readable API documentation.
- [Full Cookbook](https://www.techtwitter.com/llms-full.txt): Endpoint recipes, response shape, and JSON-RPC examples.

## Public Sources

- [Trending tweets](https://www.techtwitter.com/api/tweets/trending): Ranked tweet evidence.
- [Topics](https://www.techtwitter.com/api/topics): Topic taxonomy and counts.
- [Articles](https://www.techtwitter.com/api/articles): Long-form article rows stored with tweet provenance.
- [Time Travel day](https://www.techtwitter.com/api/time-travel/YYYY-MM-DD): Ranked posts for one calendar day. Shareable HTML is https://www.techtwitter.com/time-travel/YYYY-MM-DD.
- [Time Travel](https://www.techtwitter.com/time-travel): Interactive day explorer. The retired `/archive` month catalog permanently redirects here.

## External agent integration

- [Printing Press Tech Twitter skill](https://github.com/mvanhorn/printing-press-library/blob/main/cli-skills/pp-techtwitter/SKILL.md): An external read-only integration with a local SQLite mirror, offline full-text search, cited evidence bundles, and change-over-time commands such as `since`, `momentum`, and `narrative`. Follow the linked skill's current setup instructions before invoking `techtwitter-pp-cli`. This integration is separate from the public API and A2A contract.

## Optional

- [RSS](https://www.techtwitter.com/rss): Latest curated tweets as RSS.
- [Sitemap](https://www.techtwitter.com/sitemap.xml): Indexable public pages.