# SatStash llms-full profile

## Overview
SatStash exposes a public, read-only REST API for active marketplace inventory.
This profile is intended for AI agents, retrieval systems, and tool builders.

## Discovery files
- llms.txt: https://satstash.io/llms.txt
- llms-full.txt: https://satstash.io/llms-full.txt
- Agents page: https://satstash.io/agents
- OpenAPI schema: https://satstash.io/api/public/v1/openapi.json
- Interactive docs: https://satstash.io/api/public/v1/docs

## API contract
- Base URL: https://satstash.io/api/public/v1
- Versioning: path-based (/v1)
- Auth: anonymous, read-only
- Response envelope:
- Success: data, meta, and optional page/links
- Error: RFC 7807 (type, title, status, detail, instance, optional errors)
- Pagination:
- Query: cursor, limit
- Response: page.next_cursor, page.has_more

## Supported endpoints (v1)
- GET /api/public/v1/drops
- GET /api/public/v1/drops/{id}
- GET /api/public/v1/listings/{id}
- GET /api/public/v1/auctions/{id}
- GET /api/public/v1/stores/{slug}
- GET /api/public/v1/stores/{slug}/drops
- GET /api/public/v1/categories
- GET /api/public/v1/openapi.json
- GET /api/public/v1/docs

## Query and filtering highlights
- /drops supports:
- q, type, category, free_shipping, sort, limit, cursor
- defaults: type=all, sort=newest, limit=24
- /stores/{slug}/drops supports:
- sort, limit, cursor

## Data scope and privacy
- Active inventory only in v1.
- Public seller profile fields only.
- Private fields are excluded (emails, auth IDs, payment/internal metadata).

## Best-practice agent usage
- Start with OpenAPI schema for endpoint shapes.
- Use /categories to discover category filters.
- Use /drops for broad search, then item/store detail routes for enrichment.
- Handle 400 and 404 using RFC 7807 fields.