# TechStackIntel

> Technographics API for curated company stack snapshots, taxonomy-backed lookups, API key signup, and research submission.

## Contact
- [Homepage](https://techstackintel.com/): Canonical product surface and interactive examples.
- [Health](https://techstackintel.com/health): Simple service heartbeat.
- [llms.txt](https://techstackintel.com/llms.txt): This machine-readable overview.

## Key Information
- [Landing and live examples](https://techstackintel.com/): Browse 200 curated launch domains and copy the exact lookup calls and response shape.
- [Lookup example](https://techstackintel.com/v1/lookup?domain=stripe.com): Successful lookup envelope for a curated domain.
- [Taxonomy JSON](https://techstackintel.com/v1/taxonomy): Canonical taxonomy slugs for `company.stack`.
- [Well-known llms mirror](https://techstackintel.com/.well-known/llms.txt): Same content for clients that probe the RFC-style path.

## API
- `GET /v1/lookup?domain=example.com` returns `{ nextAction, data: { company, cacheStatus, schemaVersion } }`.
- `POST /v1/batch/lookup` accepts `{"domains":["a.com","b.com"]}` and uses the same lookup pipeline as single lookup.
- `POST /auth/magic` starts free-key email auth. Use returned keys via `X-Api-Key: YOUR_API_KEY` or `Authorization: Bearer YOUR_API_KEY`.
- `GET /v1/usage` returns usage for a valid API key.
- `POST /v1/contribute/research` accepts lookup-shaped research submissions keyed by taxonomy slug, evidence, and optional products.

## Limits
- Anonymous access is 60/hr per IP.
- Free keys are 120/hr with grace up to 160/hr before the cap returns.
- User-facing JSON errors use an envelope with `error`, `message`, `nextAction`, and optional `docsUrl`, `upgradeUrl`, or `curl`.

## What We Do Not Do
- We do not guarantee coverage for every domain; missing domains return a not-found envelope until a snapshot exists.
- We do not use vendor or product names as `company.stack` keys; use taxonomy slugs from `/v1/taxonomy`.
- Curated launch domains may include company.dossier on GET /v1/lookup (research brief + sources). Do not put dossier in POST /v1/contribute/research. Submissions are stack slugs with evidence and optional products (name + optional vendorDomain per row).

## Example Commands

Lookup:
```bash
curl -sS "https://techstackintel.com/v1/lookup?domain=stripe.com"
```

Batch:
```bash
curl -sS -X POST "https://techstackintel.com/v1/batch/lookup" \
  -H "content-type: application/json" \
  -d '{"domains":["stripe.com","1kosmos.com"]}'
```

Free key:
```bash
curl -sS -X POST "https://techstackintel.com/auth/magic" \
  -H "content-type: application/json" \
  -d '{"email":"you@company.com"}'
```