Быстрый старт
От ключа до первых отзывов за 5 минут — curl, Python и JavaScript.
За пять минут вы сделаете первый запрос, прочитаете реальные отзывы демо-группы и получите по ней аналитику. Всё — с предзаполненным тестовым ключом только для чтения, ничего создавать не нужно.
Тестовый ключ hrev_FaDG…YY4T1M — read-only и общий. Он годится, чтобы
попробовать чтение. Никогда не вставляйте в публичные примеры или в браузер
боевой ключ со скоупом full или master.
Что понадобится
- Базовый URL:
https://api.rewio.ru, префикс версии —/v2. - Заголовок
X-API-Keyв каждом запросе. - Тестовый ключ:
hrev_FaDGMKJEDDeCR5BCBgEg0aEjMogI7O7hOzE53YY4T1M - Демо-группа:
group_id=20.
Проверьте связь
Список поддерживаемых площадок — самый простой публичный вызов. Если он вернул JSON — ключ и сеть в порядке.
curl https://api.rewio.ru/v2/sources \
-H "X-API-Key: hrev_FaDGMKJEDDeCR5BCBgEg0aEjMogI7O7hOzE53YY4T1M"import requests
BASE = "https://api.rewio.ru/v2"
HEADERS = {"X-API-Key": "hrev_FaDGMKJEDDeCR5BCBgEg0aEjMogI7O7hOzE53YY4T1M"}
r = requests.get(f"{BASE}/sources", headers=HEADERS)
r.raise_for_status()
print(r.json()["data"][:3])const BASE = "https://api.rewio.ru/v2";
const HEADERS = { "X-API-Key": "hrev_FaDGMKJEDDeCR5BCBgEg0aEjMogI7O7hOzE53YY4T1M" };
const res = await fetch(`${BASE}/sources`, { headers: HEADERS });
const { data } = await res.json();
console.log(data.slice(0, 3));Прочитайте первые отзывы
Отзывы демо-группы 20, свежие сверху, первые пять:
curl "https://api.rewio.ru/v2/reviews?group_id=20&limit=5&sort_by=date&sort_order=desc" \
-H "X-API-Key: hrev_FaDGMKJEDDeCR5BCBgEg0aEjMogI7O7hOzE53YY4T1M"r = requests.get(
f"{BASE}/reviews",
headers=HEADERS,
params={"group_id": 20, "limit": 5, "sort_by": "date", "sort_order": "desc"},
)
data = r.json()
print(f"всего: {data['total']}, ещё есть: {data['has_next']}")
for rev in data["data"]:
print(rev["rating"], rev["author"], "—", (rev["text"] or "")[:60])const params = new URLSearchParams({
group_id: "20", limit: "5", sort_by: "date", sort_order: "desc",
});
const res = await fetch(`${BASE}/reviews?${params}`, { headers: HEADERS });
const data = await res.json();
console.log(`всего: ${data.total}, ещё есть: ${data.has_next}`);
for (const rev of data.data) {
console.log(rev.rating, rev.author, "—", (rev.text ?? "").slice(0, 60));
}Ответ — пагинированный конверт {data, total, limit, offset, has_next}. Поля
отзыва разобраны в Основных понятиях и в
справочнике GET /v2/reviews.
Получите аналитику
Сводка по группе — средняя оценка, распределение, доли площадок:
curl "https://api.rewio.ru/v2/analytics?group_id=20" \
-H "X-API-Key: hrev_FaDGMKJEDDeCR5BCBgEg0aEjMogI7O7hOzE53YY4T1M"Динамику по месяцам даёт GET /v2/analytics/timeseries — см.
гайд по аналитике.
Заведите свой объект (боевой ключ)
Чтобы собирать отзывы по вашим объектам, нужен ключ со скоупом full
(тестовый — только чтение). Дальше — три шага:
# 1. Создать группу (ваш объект)
curl -X POST https://api.rewio.ru/v2/groups \
-H "X-API-Key: hrev_ВАШ_FULL_КЛЮЧ" -H "Content-Type: application/json" \
-d '{"name": "Гранд Отель"}'
# -> { "id": 123, ... }
# 2. Привязать ссылку на площадку (пример — Яндекс.Карты)
curl -X POST https://api.rewio.ru/v2/groups/123/links \
-H "X-API-Key: hrev_ВАШ_FULL_КЛЮЧ" -H "Content-Type: application/json" \
-d '{"url": "https://yandex.ru/maps/org/.../reviews"}'
# 3. Через некоторое время отзывы появятся в группе
curl "https://api.rewio.ru/v2/reviews?group_id=123&limit=10" \
-H "X-API-Key: hrev_ВАШ_FULL_КЛЮЧ"Первый обход стартует автоматически после добавления ссылки; статус сбора виден в
поле scrape_status у ссылки (GET /v2/groups/123/links).