कीवर्ड रिसर्च API
आपके अपने टूल, Dashboard और AI एजेंट के लिए कीवर्ड आइडिया, सर्च वॉल्यूम, CPC, कीवर्ड कठिनाई, ऑटोकम्प्लीट सुझाव और क्लस्टरिंग। सभी एंडपॉइंट JSON लौटाते हैं और आपके प्लान के मासिक अनुरोध इस्तेमाल करते हैं, जो वेबसाइट के साथ साझा होते हैं।
क्विक स्टार्ट
वियतनाम में दो कीवर्ड का सर्च वॉल्यूम, तीन भाषाओं में:
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" }'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();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"
सीमाएँ
- Starter: 10,000 क्रेडिट / महीना ($9, वेबसाइट के साथ साझा)
- Pro: 25,000 क्रेडिट / महीना ($19, वेबसाइट के साथ साझा)
- Free और Lite में API शामिल नहीं है।
- Starter और Pro: प्रतिदिन मासिक क्रेडिट का अधिकतम 10%, प्रति मिनट 15 कॉल और एक साथ 5 कॉल।
- रिस्पॉन्स हेडर:
X-Plan,X-Requests-Limit-Month,X-Requests-Remaining-Month,Retry-After
Endpoints
/api/v1/keywords/ideasक्रेडिट: 2सीड कीवर्ड और/या किसी वेबसाइट के लिए कीवर्ड आइडिया, वॉल्यूम, 12 महीने के ट्रेंड, CPC, प्रतिस्पर्धा और कठिनाई के साथ (अधिकतम 1000 पंक्तियाँ)।
{ "keywords": ["keyword planner"], "country": "vn", "lang": "vi", "targetSite": "example.com", "sortBy": "resultDESC", "limit": 200 }/api/v1/keywords/volumeक्रेडिट: हर 10 कीवर्ड पर 1अधिकतम 100 कीवर्ड का मासिक सर्च वॉल्यूम और मेट्रिक्स।
{ "keywords": ["seo tools", "keyword research"], "country": "us" }/api/v1/keywords/suggest?keyword=seo&lang=en&country=us&sources=google,youtube&modes=az,questionsक्रेडिट: 1Google, YouTube, Bing, Amazon, Yahoo, Yandex और Wikipedia से ऑटोकम्प्लीट सुझाव। modes: az, questions, comparisons, prepositions, numbers।
/api/v1/keywords/groupक्रेडिट: 1अधिकतम 500 कीवर्ड को समूहों में बाँटें।
{ "keywords": "seo tools\nfree seo tools\nkeyword planner" }/api/v1/keywords/semanticक्रेडिट: 2किसी विषय के लिए AI द्वारा बनाए गए सिमेंटिक कीवर्ड।
{ "keyword": "coffee machine", "lang": "en" }/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 महीने होते हैं, सबसे पुराना पहले।
त्रुटियाँ
| HTTP | error | अर्थ |
|---|---|---|
| 401 | UNAUTHORIZED | API कुंजी गायब, अमान्य या रद्द है |
| 400 | INVALID_INPUT | अनुरोध का body या query मान्य नहीं है |
| 429 | QUOTA_EXCEEDED | इस महीने के क्रेडिट ख़त्म हो गए |
| 403 | PLAN_NO_API | Your plan does not include the API (Lite) |
| 429 | DAILY_LIMIT | Daily API limit reached |
| 429 | RATE_LIMITED | Too many calls this minute (or free plan spacing): wait `Retry-After` seconds |
| 429 | TOO_MANY_CONCURRENT | More than 5 requests at the same time |
| 503 | SOURCE_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 में बनाई जाती हैं। किसी कुंजी को कभी भी रद्द करें; बाकी काम करती रहेंगी।