Hotline.ua product search

GET https://api.api.sh/hotline/v1/search
1 credit / call e-commerce try it in the playground →

Search Hotline.ua, Ukraine's price comparison site. Each product: id, title, link and path, brand, category, type, model line, lowest and highest price in UAH across shops, number of offers, reviews and questions, sales count, new flag, release date, short specifications, images, colours and the single shop when only one sells it, plus raw. 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

nametypedescription
qrequired string Search words. Example: iphone 15
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/search?q=iphone+15" \
  -H "x-api-key: $APISH_KEY"

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)

{"query": "iphone 15","lang": "uk","page": 1,"total": 48,"total_pages": 1,"next_page": null,"count": 48,"items": [{"id": 24927964,"title": "iPhone 15 Plus 128GB Blue (MU163)","url": "https://hotline.ua/mobile-mobilnye-telefony-i-smartfony/apple-iphone-15-plus-128gb-blue-mu163/","path": "/mobile-mobilnye-telefony-i-smartfony/apple-iphone-15-plus-128gb-blue-mu163/","brand": "Apple","category": "Смартфоны и мобильные телефоны","category_id": 11,"type": "Смартфон","line": "iPhone 15 Plus","line_path": "/mobile/mobilnye-telefony-i-smartfony/294245-20520822/","min_price": 25561,"max_price": 34310,"currency": "UAH","offers_count": 9,"reviews_count": 2,"questions_count": 1,"sales_count": 0,"is_new": false,"date": "2023-09-12","specs": ["Смартфон","екран: 6,7\"","… 13 more"],"image": "https://hotline.ua/img/tx/582/5828122525.jpg","images": ["https://hotline.ua/img/tx/582/5828122525.jpg","https://hotline.ua/img/tx/582/5828122535.jpg","… 2 more"],"images_count": 4,"videos_count": 1,"colors": [{"id": 24927963,"title": "iPhone 15 Plus 128GB Black (MU0Y3)","imageId": 582812207,"productPath": "apple-iphone-15-plus-128gb-black-mu0y3","sectionId": 11,"colorId": 1,"alias": "black","colorName": "чорний","sizeId": null,"sizeName": null,"sizeChart": null,"pathImg": "/img/tx/582/5828122071.jpg","pathImgSmall": "/img/tx/582/582812207_s265.jpg","pathImgBig": "/img/tx/582/5828122075.jpg","path": "/mobile-mobilnye-telefony-i-smartfony/apple-iphone-15-plus-128gb-black-mu0y3/","minPrice": 2556100},{"id": 24927964,"title": "iPhone 15 Plus 128GB Blue (MU163)","imageId": 582812252,"productPath": "apple-iphone-15-plus-128gb-blue-mu163","sectionId": 11,"colorId": 2,"alias": "blueazure","colorName": "синій","sizeId": null,"sizeName": null,"sizeChart": null,"pathImg": "/img/tx/582/5828122521.jpg","pathImgSmall": "/img/tx/582/582812252_s265.jpg","pathImgBig": "/img/tx/582/5828122525.jpg","path": "/mobile-mobilnye-telefony-i-smartfony/apple-iphone-15-plus-128gb-blue-mu163/","minPrice": 2556100},"… 3 more"],"made_in_ukraine": false,"promoted": false,"single_offer": null},{"id": 24931087,"title": "iPhone 15 FineWoven Case with MagSafe - Evergreen (MT3J3)","url": "https://hotline.ua/mobile-chehly-sumki-futlyary-dlya-mobilnyh-i-smartfonov/apple-iphone-15-finewoven-case-with-magsafe-evergreen-mt3j3/","path": "/mobile-chehly-sumki-futlyary-dlya-mobilnyh-i-smartfonov/apple-iphone-15-finewoven-case-with-magsafe-evergreen-mt3j3/","brand": "Apple","category": "Чехлы для смартфонов","category_id": 599,"type": "Чохол для смартфона","line": null,"line_path": null,"min_price": 839,"max_price": 2611,"currency": "UAH","offers_count": 10,"reviews_count": 0,"questions_count": 0,"sales_count": 1,"is_new": false,"date": "2023-09-13","specs": ["чохол-накладка","сумісність: Apple iPhone 15","… 1 more"],"image": "https://hotline.ua/img/tx/409/4095422595.jpg","images": ["https://hotline.ua/img/tx/409/4095422595.jpg"],"images_count": 1,"videos_count": 0,"colors": [{"id": 24931088,"title": "iPhone 15 FineWoven Case with MagSafe - Taupe (MT3C3)","imageId": 409542260,"productPath": "apple-iphone-15-finewoven-case-with-magsafe-taupe-mt3c3","sectionId": 599,"colorId": 18,"alias": "gray","colorName": "сірий","sizeId": null,"sizeName": null,"sizeChart": null,"pathImg": "/img/tx/409/4095422601.jpg","pathImgSmall": "/img/tx/409/409542260_s265.jpg","pathImgBig": "/img/tx/409/4095422605.jpg","path": "/mobile-chehly-sumki-futlyary-dlya-mobilnyh-i-smartfonov/apple-iphone-15-finewoven-case-with-magsafe-taupe-mt3c3/","minPrice": 59900},{"id": 24931090,"title": "iPhone 15 FineWoven Case with MagSafe - Black (MT393)","imageId": 409542262,"productPath": "apple-iphone-15-finewoven-case-with-magsafe-black-mt393","sectionId": 599,"colorId": 1,"alias": "black","colorName": "чорний","sizeId": null,"sizeName": null,"sizeChart": null,"pathImg": "/img/tx/409/4095422621.jpg","pathImgSmall": "/img/tx/409/409542262_s265.jpg","pathImgBig": "/img/tx/409/4095422625.jpg","path": "/mobile-chehly-sumki-futlyary-dlya-mobilnyh-i-smartfonov/apple-iphone-15-finewoven-case-with-magsafe-black-mt393/","minPrice": 59900},"… 3 more"],"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.