API v1

कीवर्ड रिसर्च API

आपके अपने टूल, Dashboard और AI एजेंट के लिए कीवर्ड आइडिया, सर्च वॉल्यूम, CPC, कीवर्ड कठिनाई, ऑटोकम्प्लीट सुझाव और क्लस्टरिंग। सभी एंडपॉइंट JSON लौटाते हैं और आपके प्लान के मासिक अनुरोध इस्तेमाल करते हैं, जो वेबसाइट के साथ साझा होते हैं।

क्विक स्टार्ट

वियतनाम में दो कीवर्ड का सर्च वॉल्यूम, तीन भाषाओं में:

cURL
curl -X POST https://keywordplanner.vn/api/v1/keywords/volume \
  -H "Authorization: Bearer kwp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keywords": ["seo tools", "keyword research"], "country": "vn" }'
JavaScript
const res = await fetch("https://keywordplanner.vn/api/v1/keywords/volume", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.KWP_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ keywords: ["seo tools", "keyword research"], country: "vn" }),
});
const { ok, data, usage } = await res.json();
Python
import os, requests

r = requests.post(
    "https://keywordplanner.vn/api/v1/keywords/volume",
    headers={"Authorization": f"Bearer {os.environ['KWP_API_KEY']}"},
    json={"keywords": ["seo tools", "keyword research"], "country": "vn"},
    timeout=60,
)
print(r.json()["data"]["keywords"])

प्रमाणीकरण

यहाँ एक कुंजी बनाएँ: Dashboard API और उसे Authorization हेडर में भेजें।

curl https://keywordplanner.vn/api/v1/usage \
  -H "Authorization: Bearer kwp_live_YOUR_KEY"

सीमाएँ

Endpoints

POST/api/v1/keywords/ideasक्रेडिट: 2

सीड कीवर्ड और/या किसी वेबसाइट के लिए कीवर्ड आइडिया, वॉल्यूम, 12 महीने के ट्रेंड, CPC, प्रतिस्पर्धा और कठिनाई के साथ (अधिकतम 1000 पंक्तियाँ)।

{ "keywords": ["keyword planner"], "country": "vn", "lang": "vi", "targetSite": "example.com", "sortBy": "resultDESC", "limit": 200 }
POST/api/v1/keywords/volumeक्रेडिट: हर 10 कीवर्ड पर 1

अधिकतम 100 कीवर्ड का मासिक सर्च वॉल्यूम और मेट्रिक्स।

{ "keywords": ["seo tools", "keyword research"], "country": "us" }
GET/api/v1/keywords/suggest?keyword=seo&lang=en&country=us&sources=google,youtube&modes=az,questionsक्रेडिट: 1

Google, YouTube, Bing, Amazon, Yahoo, Yandex और Wikipedia से ऑटोकम्प्लीट सुझाव। modes: az, questions, comparisons, prepositions, numbers।

POST/api/v1/keywords/groupक्रेडिट: 1

अधिकतम 500 कीवर्ड को समूहों में बाँटें।

{ "keywords": "seo tools\nfree seo tools\nkeyword planner" }
POST/api/v1/keywords/semanticक्रेडिट: 2

किसी विषय के लिए AI द्वारा बनाए गए सिमेंटिक कीवर्ड।

{ "keyword": "coffee machine", "lang": "en" }
GET/api/v1/usageक्रेडिट: 0

वर्तमान प्लान और शेष क्रेडिट (इसमें क्रेडिट नहीं लगता)।

रिस्पॉन्स

{
  "ok": true,
  "data": {
    "keywords": [
      { "keyword": "keyword planner", "results": 12100, "trend": [9900, 12100, …], "competition_level": 34,
        "minCPC": 4200, "maxCPC": 15800, "difficulty": 48.2, "length": 2, "isQuestion": false, "keywordType": "exact" }
    ],
    "traffic": [{ "time": "2026-09", "month": 9, "year": 2026, "totalImpression": 154000 }]
  },
  "usage": { "plan": "Starter", "units": 2, "used": 121, "limit": 10000, "remaining": 9879 }
}

CPC मान VND में हैं। trend में 12 महीने होते हैं, सबसे पुराना पहले।

त्रुटियाँ

HTTPerrorअर्थ
401UNAUTHORIZEDAPI कुंजी गायब, अमान्य या रद्द है
400INVALID_INPUTअनुरोध का body या query मान्य नहीं है
429QUOTA_EXCEEDEDइस महीने के क्रेडिट ख़त्म हो गए
403PLAN_NO_APIYour plan does not include the API (Lite)
429DAILY_LIMITDaily API limit reached
429RATE_LIMITEDToo many calls this minute (or free plan spacing): wait `Retry-After` seconds
429TOO_MANY_CONCURRENTMore than 5 requests at the same time
503SOURCE_UNAVAILABLEकीवर्ड डेटा स्रोत अस्थायी रूप से उपलब्ध नहीं है

अक्सर पूछे जाने वाले प्रश्न

किन प्लान में API शामिल है?

Starter और Pro। API वेबसाइट वाले ही मासिक क्रेडिट इस्तेमाल करता है, इसलिए कोई अलग API सब्सक्रिप्शन नहीं है। Free और Lite में API शामिल नहीं है।

एक कॉल में कितने क्रेडिट लगते हैं?

कीवर्ड आइडिया और सिमेंटिक कीवर्ड में 2 क्रेडिट, सर्च वॉल्यूम में हर 10 कीवर्ड पर 1, सुझाव और ग्रुपिंग में 1 क्रेडिट लगता है। /api/v1/usage और विफल कॉल नहीं गिनी जातीं।

कौन-से देश और भाषाएँ समर्थित हैं?

कीवर्ड डेटा स्रोत के सभी देश और भाषाएँ: country (vn, us, jp…) और lang (vi, en, ja…) में ISO कोड भेजें। CPC मान VND में लौटाए जाते हैं।

क्या कोई रेट लिमिट है?

हाँ: प्रति मिनट 15 कॉल, एक साथ 5 कॉल और प्रतिदिन मासिक क्रेडिट का अधिकतम 10%। Retry-After हेडर बताता है कि कितनी देर प्रतीक्षा करनी है।

क्या मेरे पास कई API कुंजियाँ हो सकती हैं?

हाँ, प्रति खाता अधिकतम 5 कुंजियाँ (उदाहरण के लिए हर ऐप के लिए एक), जो Dashboard › API में बनाई जाती हैं। किसी कुंजी को कभी भी रद्द करें; बाकी काम करती रहेंगी।