{"openapi":"3.1.0","info":{"title":"SkinAtlas Agent API","version":"1.4.0","description":"Search the CS2 item catalog through path-based operations and compare stored USD prices across enabled marketplaces. The path without a representation suffix defaults to Markdown-formatted text/plain; explicit /txt, /md and /json suffixes select the response type. Marketplace URLs may contain affiliate parameters."},"servers":[{"url":"https://stage.suebbeln.de"}],"externalDocs":{"description":"Agent navigation and usage guidance","url":"https://stage.suebbeln.de/llms.txt"},"paths":{"/api/v1/items/search/{query}":{"get":{"operationId":"searchCs2ItemsDefaultPlainText","summary":"Search CS2 items as Markdown-formatted plain text by default","description":"Default representation for readers that do not specify /txt, /md or /json.","parameters":[{"name":"query","in":"path","required":true,"description":"URL-encoded item or sticker name, 2 to 160 characters. The route returns at most 10 matches.","example":"Vulcan","schema":{"type":"string","minLength":2,"maxLength":160}}],"responses":{"200":{"description":"Markdown-formatted plain text containing matching items, offers, links, and price caveats.","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request returned as Markdown-formatted plain text."},"503":{"description":"Catalog temporarily unavailable, returned as Markdown-formatted plain text."}}}},"/api/v1/items/search/{query}/md":{"get":{"operationId":"searchCs2ItemsMarkdown","summary":"Search CS2 items and return agent-readable Markdown","description":"Returns the same catalog search and marketplace snapshot information as the path-based JSON operation, formatted as Markdown.","parameters":[{"name":"query","in":"path","required":true,"description":"URL-encoded item or sticker name, 2 to 160 characters. The route returns at most 10 matches.","example":"Vulcan","schema":{"type":"string","minLength":2,"maxLength":160}}],"responses":{"200":{"description":"Markdown containing matching items, offers, links, and price caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request returned as Markdown."},"503":{"description":"Catalog temporarily unavailable, returned as Markdown."}}}},"/api/v1/items/search/{query}/txt":{"get":{"operationId":"searchCs2ItemsPlainText","summary":"Search CS2 items as Markdown-formatted plain text","description":"Returns the same Markdown content as the path-based Markdown operation with text/plain for readers that reject text/markdown.","parameters":[{"name":"query","in":"path","required":true,"description":"URL-encoded item or sticker name, 2 to 160 characters. The route returns at most 10 matches.","example":"Vulcan","schema":{"type":"string","minLength":2,"maxLength":160}}],"responses":{"200":{"description":"Markdown-formatted plain text containing matching items, offers, links, and price caveats.","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request returned as Markdown-formatted plain text."},"503":{"description":"Catalog temporarily unavailable, returned as Markdown-formatted plain text."}}}},"/api/v1/items/search/{query}/json":{"get":{"operationId":"searchCs2ItemsJson","summary":"Search CS2 items and return structured JSON","parameters":[{"name":"query","in":"path","required":true,"description":"URL-encoded item or sticker name, 2 to 160 characters. The route returns at most 10 matches.","example":"Vulcan","schema":{"type":"string","minLength":2,"maxLength":160}}],"responses":{"200":{"description":"Matching items, all available marketplace offers, and the cheapest offer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemSearchResponse"}}}},"400":{"description":"Invalid request."},"503":{"description":"Catalog temporarily unavailable."}}}}},"components":{"schemas":{"Offer":{"type":"object","required":["source_key","marketplace","price_cents","price_usd","url","affiliate"],"properties":{"source_key":{"type":"string"},"marketplace":{"type":"string"},"price_cents":{"type":"integer","description":"USD cents."},"price_usd":{"type":"string","description":"Decimal USD amount."},"url":{"type":"string","format":"uri"},"affiliate":{"type":"boolean"}}},"Item":{"type":"object","required":["id","name","image","offers"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"market_hash_name":{"type":["string","null"]},"image":{"type":"object","properties":{"url":{"type":["string","null"],"format":"uri"},"alt":{"type":"string","description":"Accessible image alternative containing the item name."}}},"skinatlas_url":{"type":["string","null"],"format":"uri"},"offers":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"cheapest_offer":{"oneOf":[{"$ref":"#/components/schemas/Offer"},{"type":"null"}]}}},"ItemSearchResponse":{"type":"object","required":["schema_version","currency","price_unit","result_count","items","notices"],"properties":{"schema_version":{"type":"string"},"currency":{"const":"USD"},"price_unit":{"const":"cents"},"result_count":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"notices":{"type":"array","items":{"type":"string"}}}}}}}