API VK.watch

Те же данные, что и на сайте, по HTTP. Купите пакет API, создайте ключ и платите кредитами за каждый запрос.

Пакет API

99 $ API: 2 000 кредитов, 30 дней

Доступ к API открывается на 30 дней после оплаты; периоды суммируются.
Кредиты действуют 365 дней с момента покупки; сначала списываются те, что истекают раньше.
Кредиты API — отдельный кошелёк; на сайте они не тратятся.
Нет пакета API? Запросы к API списывают кредиты сайта по тем же ценам, пока активен доступ к сайту. Удобно для тестов.
Разовая оплата криптовалютой, без автопродления.

Лимиты

5 запросов в секунду, всплески до 20
До 5 активных ключей на аккаунт
Неудачный запрос (4xx/5xx) возвращает кредиты
Каждый запрос оплачивается; повторный запрос того же профиля оплачивается снова

Аутентификация

Создайте ключ в личном кабинете и передавайте его как Bearer-токен. Каждый ответ содержит заголовки X-Credits-Charged и X-Credits-Remaining.

curl -H "Authorization: Bearer $VKWATCH_API_KEY" \
  https://api.vk.watch/v1/profile/1

Ответы — JSON-конверты {response, meta}. Ответ поиска возвращается без конверта.

{
  "response": { "id": 1, "profile": { "first_name": "…", "last_name": "…", "city": { "title": "…" } }, "photos": 12, "friends": 341 },
  "meta": { "credits": { "charged": 2, "remaining": 1998 } }
}

Эндпоинты

Базовый URL: https://api.vk.watch/v1

Маршрут	Возвращает	Кредиты
GET/me	endpoints.notes.balance	0
GET/profile/{id}	Последний снимок профиля со счётчиками	2
GET/profile/{id}/changes	Изменения полей во времени	2
GET/profile/{id}/snapshots	Список сохранённых снимков	1
GET/profile/{id}/snapshot/{snapshotId}	Один исторический снимок	2
GET/profile/{id}/friends	Список друзей	2
GET/profile/{id}/photos	Фотографии	2
GET/profile/{id}/comments	Комментарии	1
GET/profile/{id}/identity	Только имя и аватар	1
GET/search?name=…	Фасетный поиск (страница = 50 результатов)	1
POST/lookup	Разрешение id и коротких имён	1
GET/geo/search, /geo/resolve, /facets/suggest	Гео и фасетные подсказки (бесплатно)	0
POST/faces (multipart photo)	Поиск по лицу на фото	20

Машиночитаемая спецификация: openapi.json

Попробовать

Заполните параметры и отправьте запрос прямо отсюда. Запрос идёт через вашу сессию, списание такое же, как по ключу.

Войдите или зарегистрируйтесь, чтобы отправлять запросы

Последний снимок профиля со счётчиками
ID профиля *
```
curl -H "Authorization: Bearer $VKWATCH_API_KEY" \
  "https://api.vk.watch/v1/profile/1"
```

Ошибки

401 apiKeyRequired / apiKeyInvalid — ключ отсутствует или отозван
402 apiAccessExpired / apiCreditsExhausted — нет периода доступа к API или недостаточно кредитов; ничего не списывается
404 profileNotFound — неизвестный профиль; ничего не списывается
429 apiRateLimited — превышен лимит; повторите через секунду