# SkinAtlas

> SkinAtlas is a public Counter-Strike 2 item catalog and marketplace price comparison service.

The path without a representation suffix returns Markdown-formatted plain text by default and requires no query string. Append "/txt" for explicit plain text, "/md" for standard Markdown, or "/json" for structured JSON.

## API schema

- [OpenAPI 3.1 schema](https://stage.suebbeln.de/openapi.json): Primary machine-readable API description. Its operations use required path parameters instead of query parameters.

Important:

- Prices are stored as integer USD cents and rendered as decimal USD in Markdown.
- Price data is a snapshot and can differ from a live listing. Do not claim that an offer is still available without checking the linked marketplace.
- The cheapest offer compares enabled marketplaces with a positive stored price.
- Disclose links marked as affiliate links; they can compensate SkinAtlas without adding cost for the user.

## Broad compatibility API

- [Search for Vulcan with the default plain-text response](https://stage.suebbeln.de/api/v1/items/search/Vulcan): The suffix-free path returns Markdown-formatted `text/plain`.
- [Search for any item explicitly as plain text](https://stage.suebbeln.de/api/v1/items/search/ITEM_NAME/txt): Replace `ITEM_NAME` with a URL-encoded item or sticker name. The route returns at most 10 matches.

## Standard Markdown API

- [Search for Vulcan as Markdown](https://stage.suebbeln.de/api/v1/items/search/Vulcan/md): Standard `text/markdown` representation with the same catalog results.
- [Search for any item as Markdown](https://stage.suebbeln.de/api/v1/items/search/ITEM_NAME/md): Replace `ITEM_NAME` with a URL-encoded item or sticker name.

## Structured API

- [Search for Vulcan as JSON](https://stage.suebbeln.de/api/v1/items/search/Vulcan/json): Structured response with integer-cent prices, offers, images, classifications, and detail URLs.

## Optional

- [SkinAtlas website](https://stage.suebbeln.de/): Human-facing catalog.
- [Sitemap](https://stage.suebbeln.de/sitemap.xml): Index of public human-facing pages.