Hotline.ua category listing with filters
GET https://api.api.sh/hotline/v1/category
Products in a Hotline.ua category with the category's filters (value ids from the filters endpoint, included or excluded), a price range and the site's sorts. Same product card as search, plus the category's product count (or the filtered count). Pass next_page back as page; null on the last page.
Every response includes credits_used: the credits this call cost.
Part of the Hotline.ua API: 13 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
pathrequired | string | Category link or path on hotline.ua. Example: /mobile/mobilnye-telefony-i-smartfony/ |
filters | string | Comma-separated filter value ids from /hotline/v1/category/filters, e.g. 3022,61425. |
exclude | string | Comma-separated filter value ids to leave out. |
price_min | integer | Lowest price in UAH. |
price_max | integer | Highest price in UAH. |
sort | popularity | priceUp | priceDown | new | title | quantity | Sort order (default popularity; quantity = most offers). |
city | string | kyiv (default), lviv, kharkiv, odesa, dnipro, zaporizhzhia or a numeric city id. |
page | integer | Page number (48 per page). |
lang | uk | ru | Language (default uk). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/hotline/v1/category?path=%2Fmobile%2Fmobilnye-telefony-i-smartfony%2F" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/hotline/v1/category",
params={"path": "/mobile/mobilnye-telefony-i-smartfony/"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/hotline/v1/category");
url.searchParams.set("path", "/mobile/mobilnye-telefony-i-smartfony/");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"path": "/mobile/mobilnye-telefony-i-smartfony/","page_type": "catalog","category_id": 11,"category": "Смартфони та мобільні телефони","lang": "uk","city": "kyiv","page": 1,"applied_filters": {"filters": [],"exclude": [],"price_min": null,"price_max": null,"sort": "popularity"},"total": 4443,"total_pages": 93,"next_page": 2,"count": 48,"items": [{"id": 27043053,"title": "iPhone 18 Pro Max 256GB Burgundy (MJXQ4)","url": "https://hotline.ua/mobile-mobilnye-telefony-i-smartfony/apple-iphone-18-pro-max-256gb-burgundy/","path": "/mobile-mobilnye-telefony-i-smartfony/apple-iphone-18-pro-max-256gb-burgundy/","brand": "Apple","category": "Смартфоны и мобильные телефоны","category_id": 11,"type": null,"line": "iPhone 18 Pro Max","line_path": "/mobile/mobilnye-telefony-i-smartfony/294245-22151576/","min_price": 74720,"max_price": 107731,"currency": "UAH","offers_count": 74,"reviews_count": 1,"questions_count": 2,"sales_count": 0,"is_new": true,"date": "2026-09-09","specs": ["Смартфон","екран: 6,9\"","… 13 more"],"image": "https://hotline.ua/img/tx/582/5824497045.jpg","images": ["https://hotline.ua/img/tx/582/5824497045.jpg","https://hotline.ua/img/tx/582/5824497055.jpg","… 1 more"],"images_count": 3,"videos_count": 1,"colors": [{"id": 27043054,"title": "iPhone 18 Pro Max 256GB Glacier (MJXR4)","imageId": 582450376,"productPath": "apple-iphone-18-pro-max-256gb-glacier","sectionId": 11,"colorId": 2,"alias": "blueazure","colorName": "синій","sizeId": null,"sizeName": null,"sizeChart": null,"pathImg": "/img/tx/582/5824503761.jpg","pathImgSmall": "/img/tx/582/582450376_s265.jpg","pathImgBig": "/img/tx/582/5824503765.jpg","path": "/mobile-mobilnye-telefony-i-smartfony/apple-iphone-18-pro-max-256gb-glacier/","minPrice": 7609100},{"id": 27043056,"title": "iPhone 18 Pro Max 256GB Black (MJXN4)","imageId": 582452170,"productPath": "apple-iphone-18-pro-max-256gb-black","sectionId": 11,"colorId": 1,"alias": "black","colorName": "чорний","sizeId": null,"sizeName": null,"sizeChart": null,"pathImg": "/img/tx/582/5824521701.jpg","pathImgSmall": "/img/tx/582/582452170_s265.jpg","pathImgBig": "/img/tx/582/5824521705.jpg","path": "/mobile-mobilnye-telefony-i-smartfony/apple-iphone-18-pro-max-256gb-black/","minPrice": 7519100},"… 2 more"],"made_in_ukraine": false,"promoted": false,"single_offer": null},{"id": 27043858,"title": "iPhone Duo 256GB Night Sky (MK2N4, MK2E4)","url": "https://hotline.ua/mobile-mobilnye-telefony-i-smartfony/apple-iphone-ultra-256gb-dark-blue/","path": "/mobile-mobilnye-telefony-i-smartfony/apple-iphone-ultra-256gb-dark-blue/","brand": "Apple","category": "Смартфоны и мобильные телефоны","category_id": 11,"type": null,"line": "iPhone Duo","line_path": "/mobile/mobilnye-telefony-i-smartfony/294245-22151579/","min_price": 111999,"max_price": 153000,"currency": "UAH","offers_count": 42,"reviews_count": 0,"questions_count": 0,"sales_count": 0,"is_new": true,"date": "2026-09-09","specs": ["Смартфон","екран: 7,6\"","… 12 more"],"image": "https://hotline.ua/img/tx/582/5824327265.jpg","images": ["https://hotline.ua/img/tx/582/5824327265.jpg","https://hotline.ua/img/tx/582/5824327285.jpg","… 2 more"],"images_count": 4,"videos_count": 1,"colors": [{"id": 27043859,"title": "iPhone Duo 256GB Star White (MK2M4,MK2D4)","imageId": 582432753,"productPath": "apple-iphone-ultra-256gb-white","sectionId": 11,"colorId": 5,"alias": "white","colorName": "білий","sizeId": null,"sizeName": null,"sizeChart": null,"pathImg": "/img/tx/582/5824327531.jpg","pathImgSmall": "/img/tx/582/582432753_s265.jpg","pathImgBig": "/img/tx/582/5824327535.jpg","path": "/mobile-mobilnye-telefony-i-smartfony/apple-iphone-ultra-256gb-white/","minPrice": 12582000},{"id": 27043858,"title": "iPhone Duo 256GB Night Sky (MK2N4, MK2E4)","imageId": 582432726,"productPath": "apple-iphone-ultra-256gb-dark-blue","sectionId": 11,"colorId": 93,"alias": "blueazure","colorName": "темно-синій","sizeId": null,"sizeName": null,"sizeChart": null,"pathImg": "/img/tx/582/5824327261.jpg","pathImgSmall": "/img/tx/582/582432726_s265.jpg","pathImgBig": "/img/tx/582/5824327265.jpg","path": "/mobile-mobilnye-telefony-i-smartfony/apple-iphone-ultra-256gb-dark-blue/","minPrice": 11199900}],"made_in_ukraine": false,"promoted": false,"single_offer": null},"… 46 more"],"cached": false,"credits_used": 1}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.