# autopricer.tf

> Public Team Fortress 2 item pricing API. Live, manipulation-resistant market prices derived from backpack.tf and STN classified listings. No API key.

This file exists so AI agents that visit https://autopricer.tf can immediately find the public REST API documentation.

## Where the public documentation lives

- Canonical HTML docs: https://autopricer.tf/docs
- Markdown docs (preferred for LLMs): https://autopricer.tf/docs.md
- Full copy of the markdown docs: https://autopricer.tf/llms-full.txt
- OpenAPI 3 specification: https://autopricer.tf/openapi.json
- API discovery JSON: https://autopricer.tf/api

## Public REST API (read-only)

Base URL: `https://autopricer.tf`

Authentication: none. Rate limit: 300 requests per minute per IP. All documented endpoints are GET and do not modify data.

- GET /api — discovery document (links + public endpoint index)
- GET /api/health — liveness (`{"success":true,"status":"Online"}` or HTTP 503)
- GET /api/items/count — total tracked items (`{"success":true,"count":86546}`)
- GET /api/items/{page} — paginated catalog, 1000 items per page, page starts at 1. Query: `raw=true`, `listings=true`
- GET /api/images — up to 500 recent item image URLs

Prices are in Mann Co. Supply Crate Keys. Item price fields serialize as JSON strings (4 decimal places) or `null`. Listing `keys` / `metal` fields serialize as JSON numbers.

## Do not use

Dashboard UI routes under `/api/dashboard/*` are not part of the public REST API.

Write/admin endpoints that create or modify database records are private and undocumented.

## Quick examples

```
curl https://autopricer.tf/api/health
curl https://autopricer.tf/api/items/count
curl "https://autopricer.tf/api/items/1"
curl "https://autopricer.tf/api/items/1?raw=true&listings=true"
curl https://autopricer.tf/api/images
```

Read https://autopricer.tf/docs.md for field definitions and full example responses.