API de VK.watch

Los mismos datos que el sitio, por HTTP. Compra un paquete de API, crea una clave y paga créditos por solicitud.

Paquete de API

99 US$ API: 2000 créditos, 30 días

El acceso a la API se abre durante 30 días tras el pago; los periodos se suman.
Los créditos valen 365 días desde la compra; primero se gastan los que caducan antes.
Los créditos de API son un monedero aparte; el sitio nunca los gasta.
¿Sin paquete de API? Las llamadas a la API gastan créditos del sitio a los mismos precios mientras el acceso al sitio esté activo. Útil para pruebas.
Pago único en cripto, sin renovación automática.

Límites

5 solicitudes por segundo, ráfagas de hasta 20
Hasta 5 claves activas por cuenta
Una solicitud fallida (4xx/5xx) se reembolsa
Cada solicitud se cobra; volver a pedir el mismo perfil se cobra de nuevo

Autenticación

Crea una clave en tu cuenta y envíala como token Bearer. Cada respuesta incluye las cabeceras X-Credits-Charged y X-Credits-Remaining.

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

Las respuestas son sobres JSON {response, meta}. La respuesta de búsqueda se devuelve sin sobre.

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

Endpoints

URL base: https://api.vk.watch/v1

Ruta	Devuelve	Créditos
GET/me	endpoints.notes.balance	0
GET/profile/{id}	Última instantánea del perfil con contadores	2
GET/profile/{id}/changes	Cambios de campos en el tiempo	2
GET/profile/{id}/snapshots	Lista de instantáneas guardadas	1
GET/profile/{id}/snapshot/{snapshotId}	Una instantánea histórica	2
GET/profile/{id}/friends	Lista de amigos	2
GET/profile/{id}/photos	Fotos	2
GET/profile/{id}/comments	Comentarios	1
GET/profile/{id}/identity	Solo nombre y avatar	1
GET/search?name=…	Búsqueda facetada (una página son 50 resultados)	1
POST/lookup	Resolver ids y nombres cortos	1
GET/geo/search, /geo/resolve, /facets/suggest	Ayudas geo y de facetas (gratis)	0
POST/faces (multipart photo)	Búsqueda por rostro con una foto	20

Especificación legible por máquina: openapi.json

Pruébalo

Rellena los parámetros y envía la solicitud desde aquí. Pasa por tu sesión y se cobra igual que una llamada con clave.

Inicia sesión o regístrate para enviar solicitudes

Última instantánea del perfil con contadores
Id del perfil *
```
curl -H "Authorization: Bearer $VKWATCH_API_KEY" \
  "https://api.vk.watch/v1/profile/1"
```

Errores

401 apiKeyRequired / apiKeyInvalid — clave ausente o revocada
402 apiAccessExpired / apiCreditsExhausted — sin periodo de acceso a la API o créditos insuficientes; no se cobra nada
404 profileNotFound — perfil desconocido; no se cobra nada
429 apiRateLimited — límite de frecuencia; reintenta en un segundo