सामग्री पर जाएँ
VK.watch

VK.watch API

साइट जैसा ही डेटा, 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/meendpoints.notes.balance0
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/lookupid और स्क्रीन नाम हल करें1
GET/geo/search, /geo/resolve, /facets/suggestजियो और फ़ेसेट सहायक (निःशुल्क)0
POST/faces (multipart photo)फ़ोटो से चेहरा खोज20

मशीन-पठनीय विनिर्देश: openapi.json

आज़माएँ

पैरामीटर भरें और यहीं से अनुरोध भेजें। यह आपके सत्र से चलता है और कुंजी कॉल की तरह ही शुल्क लेता है।

अनुरोध भेजने के लिए साइन इन या साइन अप करें

  • काउंटर सहित नवीनतम प्रोफ़ाइल स्नैपशॉट

    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 — दर सीमा; एक सेकंड बाद पुनः प्रयास करें

उच्च सीमाएँ, बल्क निर्यात या कस्टम समझौता चाहिए? ईमेल करें b2b@vk.watch ।