# KazGroupMetal: public catalog access for AI agents

## When to use this site

Use this source to find steel and rolled-metal product specifications from KazGroupMetal in Almaty, Kazakhstan: rebar, profile and round pipes, sheets, beams, channels, angles and mesh. It is useful for matching a customer's specification, checking dimensions, steel grades and standards, and preparing a list of product URLs for a quotation request. Russian names and dimensions are supported.

This is a product catalog, not a live stock or price feed. Prices, stock, delivery dates, certificates and the actual shipment must be confirmed by a manager. Images illustrate product groups. Weight calculations are approximate and do not replace structural engineering.

## Quick start

1. Web readers: start with [HTML product search](https://kazgroupmetal.kz/catalog/search?q=арматура&steel=А500С&diameter=12). Follow the ordinary product link in the returned page, or its JSON characteristics link. Do not guess product URLs. Search and pagination are server-rendered and require no JavaScript.
2. API clients: find category slugs at https://kazgroupmetal.kz/catalog/categories.json, then search https://kazgroupmetal.kz/catalog/search.json?q=арматура&steel=А500С&diameter=12&limit=5.
3. Bare numbers in q match the original product size, not steel-grade digits, cut lengths or the year in a standard. For example, q=арматура%2016 searches size 16, and q=арматура%20А500С%2012%20мм searches size 12 in class А500С. Dimension tuples such as 80×40×3 match complete numeric dimensions. Write ГОСТ 8240 to search a standard number. To specify a particular dimension unambiguously, use numeric millimetre filters: https://kazgroupmetal.kz/catalog/search?category=truba-profilnaya&width=80&thickness=3 .
4. JSON results include dataUrl for the product JSON, url for its canonical HTML page, and browseUrl for the same search as HTML with clickable links. If a web reader cannot follow dataUrl, open browseUrl and click the product link instead. No direct product URL from the user is needed.
5. Cite the canonical HTML product URL in the response. To obtain a quote, direct the customer to https://kazgroupmetal.kz/contacts or info@kazgroupmetal.kz.

Search uses all query words. Filters: q, category, steel, standard, diameter, thickness, width and length. Dimensions are numeric millimetres. Some records have missing numeric dimensions; their original size string remains available. Unknown dimensions are null, not zero. limit is 1–50 (default 10), offset is 0–100000 (default 0). Follow the next URL until it is null. Results are published catalog positions; existence does not confirm stock. An empty result is HTTP 200 with total: 0. Invalid parameters return application/problem+json and HTTP 400; a missing product returns HTTP 404.

## HTML and Markdown

For a specific profile, start at [catalog collections](https://kazgroupmetal.kz/catalog/collections): [A500C rebar](https://kazgroupmetal.kz/catalog/collections/armatura-a500c), [H75](https://kazgroupmetal.kz/catalog/collections/profnastil-h75), [H44](https://kazgroupmetal.kz/catalog/collections/profnastil-h44), [80×40×3 mm profile pipe](https://kazgroupmetal.kz/catalog/collections/truba-80x40x3), or [63 mm steel angle](https://kazgroupmetal.kz/catalog/collections/ugolok-63). These public HTML pages contain actual product links, selection criteria and quotation guidance; the product JSON remains available at each linked card's dataUrl.

For web search followed by a product, prefer /catalog/search with ordinary HTML links. For structured clients use the public /catalog/*.json URLs in Quick start. If a reader reports restricted URL for /api/v1/catalog, use its equivalent public JSON address or browseUrl. They expose the same published data. A restriction from a reading tool is not a confirmed HTTP error from the site. Use Russian product names in q (for example арматура, not a guessed transliteration). HTML search is crawlable with noindex, follow: the results page is not indexed, but its public product links may be followed.

Public HTML pages also accept the HTTP header Accept: text/markdown. The Markdown is converted from the same server-rendered HTML, including published content from the admin editor. Both representations use the same URL; responses include Vary: Accept. Normal browsers keep receiving HTML. A Markdown request to a nonexistent document still returns HTTP 404 with links to the catalog and sitemap.

## Discovery

- [OpenAPI 3.1 description](https://kazgroupmetal.kz/openapi.json)
- [Developer documentation and versioning policy](https://kazgroupmetal.kz/developers)
- [API v1 categories](https://kazgroupmetal.kz/api/v1/catalog/categories)
- [API v1 product search](https://kazgroupmetal.kz/api/v1/catalog/search?q=арматура&diameter=12&limit=5)
- [Full JSON catalog](https://kazgroupmetal.kz/catalog.json)
- [Concise company and category index](https://kazgroupmetal.kz/llms.txt)
- [Text catalog](https://kazgroupmetal.kz/llms-full.txt)
- [Articles](https://kazgroupmetal.kz/articles)
- [Sitemap](https://kazgroupmetal.kz/sitemap.xml)
- [Contacts](https://kazgroupmetal.kz/contacts)
- [Company details and shipment documents](https://kazgroupmetal.kz/documents)

All documented data endpoints are read-only, require no API key and support GET/HEAD. No order, email, account or admin action is exposed through them. They do not automatically connect any third-party AI service. Search inclusion and citations are determined by those services.

## Versioning and retries

The versioned API is /api/v1/catalog: /categories, /search and /products/{slug}. Earlier /catalog/*.json addresses remain supported. Breaking changes use a new version; additive fields may be added to v1. Deprecation announcements are published at /developers; a scheduled removal uses Deprecation and Sunset headers. No removal is scheduled. Use at most two concurrent requests, cache results and follow pagination. On HTTP 429 or 503, retry with backoff and honor Retry-After when provided. There is no published fixed rate quota.
