Hotline.ua shop profile
GET https://api.api.sh/hotline/v1/shop
A shop listed on Hotline.ua: name, status, year founded, city, website, logo, about text, opening hours, delivery, payment and credit terms, offers count, yearly rating, review counts (positive and negative), statistics, stores and the categories it sells in.
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 |
|---|---|---|
idrequired | string | Shop id (from offers or shop search) or a hotline.ua/yp/ link. Example: 287 |
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/shop?id=287" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/hotline/v1/shop",
params={"id": "287"},
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/shop");
url.searchParams.set("id", "287");
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)
{"id": 287,"name": "STYLUS","url": "https://hotline.ua/yp/287/","lang": "uk","active": true,"closed": false,"hidden": false,"banned": false,"since": "2008","city": "Київ","website": "stls.store","logo": "https://hotline.ua/img/yp/287_v2_150.png?v=7","about": "STYLUS існує на українському ринку онлайн-продажів з 2008 року і за цей час встиг зарекомендувати себе як надійний інтернет-магазин. На сьог…","hours": {"weekdays": [null,null],"saturday": [null,null],"sunday": [null,null]},"delivery_terms": "Точні терміни доставки на обраний вами товар уточнюйте у оператора. Вартість доставки по Україні залежить від типу і вартості товару. Переси…","delivery_methods": [{"deliveryId": 19107,"priceId": null,"cost": 0,"freeFrom": null,"time": 1,"warehouseTitle": null,"typeName": "pickup","typeDescription": "Самовывоз","typeDescriptionUk": "Самовивіз","carrier": 0,"serviceName": "","serviceNameAblative": "","serviceNameGenitive": "","serviceStatus": false,"deliveryTimes": "1-3 дня"},{"deliveryId": 10129,"priceId": null,"cost": null,"freeFrom": null,"time": 1,"warehouseTitle": "До складу","typeName": "warehouse","typeDescription": "В отделение","typeDescriptionUk": "У відділення","carrier": "NP","serviceName": "Нова Пошта","serviceNameAblative": "Нова Пошта","serviceNameGenitive": "Нова Пошта","serviceStatus": true,"deliveryTimes": "1-3 дня"},"… 1 more"],"payment_methods": {"pay-card": {"id": 28,"enabled": false,"type": "pay-card","descriptionRu": "картой","descriptionUk": "картою","attributeName": null,"attributeValue": null,"description": "картою","attributes": []},"card-card": {"id": 41,"enabled": false,"type": "card-card","descriptionRu": "карта-карта","descriptionUk": "карта-карта","attributeName": "fee","attributeValue": "0","description": "карта-карта","attributes": {"fee": ["0"]}},"vat": {"id": 26,"enabled": false,"type": "vat","descriptionRu": "б/н расчет с НДС","descriptionUk": "б/г розрахунок з ПДВ","attributeName": null,"attributeValue": null,"description": "б/г розрахунок з ПДВ","attributes": []},"non-vat": {"id": 914,"enabled": true,"type": "non-vat","descriptionRu": "б/н расчет без НДС","descriptionUk": "б/г розрахунок без ПДВ","attributeName": null,"attributeValue": null,"description": "б/г розрахунок без ПДВ","attributes": []},"cash-on-delivery": {"id": 27,"enabled": true,"type": "cash-on-delivery","descriptionRu": "налож. платеж","descriptionUk": "післяплата","attributeName": null,"attributeValue": null,"description": "післяплата","attributes": []},"card-in-shop": {"id": 17041,"enabled": false,"type": "card-in-shop","descriptionRu": "картой в п. выдачи","descriptionUk": "картою в п. видачі","attributeName": null,"attributeValue": null,"description": "картою в п. видачі","attributes": []}},"credit_terms": null,"offers_count": 76310,"rating_year": "7.01","reviews": 8598,"positive_reviews": 158,"negative_reviews": 82,"statistic": {"ByAllTimePositive": "5116","ByAllTimeNegative": "2628","ByAllTimeSum": 8597,"ByYearPositive": "158","ByYearNegative": "82","ByYearAll": 250,"By3MonthPositive": "25","By3MonthNegative": "29","By3MonthAll": 56,"By6MonthAll": 107,"By6MonthPositive": "61","By6MonthNegative": "42"},"stores": [{"name": "Stylus на пр. Степана Бандери","address": "Київ, пр. Степана Бандери, 6","notes": "","longitude": 30.49428,"latitude": 50.487623,"weekDayFrom": "10:00","weekDayTo": "20:00","saturdayFrom": "10:00","saturdayTo": "17:00","sundayFrom": "10:00","sundayTo": "17:00"},{"name": "STYLUS на Бажана","address": "Київ, проспект Миколи Бажана, 30","notes": "","longitude": 30.646929,"latitude": 50.3991215,"weekDayFrom": "10:00","weekDayTo": "20:00","saturdayFrom": "","saturdayTo": "","sundayFrom": "","sundayTo": ""},"… 3 more"],"categories": {"mobile": "Смартфони, Смарт-годинники","computer": "Комп'ютери, Мережі","av": "ТВ, Аудіо, Відео, Фото","bt": "Побутова техніка","auto": "Авто і Мото","sport": "Спорт, Активний відпочинок","dom": "Все для дому","fashion": "Годинники, Сумки, Аксесуари","dacha_sad": "Дача, сад","deti": "Дитячі товари","krasota": "Краса і здоров'я","remont": "Сантехніка, Будматеріали","zootovary": "Зоотовари","musical_instruments": "Музичні інструменти","adult": "Товари для дорослих","tools": "Інструменти","pobutova_himiia": "Побутова хімія"},"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.