आपको शुक्रवार तक एक उत्पाद प्रबंधक को बताना होगा कि क्या एक नाम ट्रेडमार्क के लिए मुक्त है और, यदि नहीं, तो कौन सी श्रेणियाँ अभी भी खुली हैं। इस गाइड के अंत तक, आप ट्रेडमार्क उपलब्धता की जांच करने और Zyla API Hub से एकल API कुंजी का उपयोग करके मालिक और मार्क विवरण खींचने में सक्षम होंगे, इसे अपने ऐप, CI कार्य, या मॉडरेशन पाइपलाइन में प्लग करें, और तेजी से कार्यात्मक परिणाम लौटाएं।
यह API क्या प्रदान करता है और इसका उपयोग कब करें
Zyla API Hub पर Trademark Search API तीन पढ़ने वाले एंडपॉइंट्स को उजागर करता है:
- खोज: नाम या पोस्टकोड द्वारा मालिकों को देखें और उनके पंजीकृत ट्रेडमार्क प्राप्त करें।
- ट्रेडमार्क उपलब्धता: जांचें कि क्या एक कीवर्ड उपलब्ध है और कौन सी Nice श्रेणियाँ उपलब्ध या ली गई हैं, संबंधित अनुक्रमांक के साथ।
- ट्रेडमार्क खोज: कीवर्ड-चालित खोज जो मुख्य पंजीकरण मेटाडेटा (स्थिति, मालिक, फाइलिंग/पंजीकरण तिथियाँ, आदि) लौटाती है।
विशिष्ट एकीकरणों में उत्पाद लॉन्च से पहले ब्रांड स्क्रीनिंग, मार्केटप्लेस लिस्टिंग मॉडरेशन, नए विक्रेता नामों के लिए चेकआउट गेट, और अधिकार क्षेत्र और श्रेणियों में संघर्षों के लिए आंतरिक ऑडिट शामिल हैं।
Zyla API Hub पर शुरू करना
API के मार्केटप्लेस पृष्ठ को खोलें और अपनी कुंजी प्राप्त करने के लिए सदस्यता लें। प्रमाणीकरण हर अनुरोध में Authorization: Bearer YOUR_API_KEY के माध्यम से होता है।
- Trademark Search API पर 7-दिन का परीक्षण प्रारंभ करें पृष्ठ पर जाएं।
- API कुंजी प्राप्त करने के लिए सदस्यता लें (या उपलब्ध होने पर मुफ्त परीक्षण प्रारंभ करें)।
- Zyla API Hub पर किसी भी API में एक ही कुंजी का उपयोग करें। बिलिंग सदस्यता + कोटा है, प्रति कॉल भुगतान नहीं है। इस पहले API के लिए, आप 7-दिन के परीक्षण या 50 अनुरोधों के साथ शुरू कर सकते हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
आप जिन एंडपॉइंट्स को कॉल करेंगे
1) खोज
विधि: GET
URL: https://zylalabs.com/api/1495/trademark-search-api/1236/search
यह क्या करता है: मालिक के नाम या पोस्टकोड द्वारा खोज करता है और उस मालिक के लिए पाए गए ट्रेडमार्क के बारे में विवरण लौटाता है। जब एक मालिक का पता बदल जाता है तो डुप्लिकेट मालिक दिखाई दे सकते हैं।
प्रमाणीकरण आवश्यक है। इस उदाहरण के लिए कोई अनुरोध पैरामीटर प्रलेखित नहीं हैं।
cURL (कॉपी-पेस्ट):
curl -s -X GET "https://zylalabs.com/api/1495/trademark-search-api/1236/search" \
-H "Authorization: Bearer YOUR_API_KEY"
JSON प्रतिक्रिया (आधिकारिक उदाहरण):
{
"count": 1,
"items": [
{
"name": "VIAJO.COM INC.",
"address1": "4225 Executive Square, Suite 325",
"address2": null,
"city": "La Jolla",
"state": "CA",
"country": "US",
"postcode": "92037",
"trademarks": [
{
"keyword": "CLICK Y VIAJA",
"registration_number": "2847107",
"serial_number": "75928638"
}
]
}
]
}
आप वास्तव में क्या उपयोग करेंगे: अपने परिणाम सेट के आकार के लिए गिनती; पहचान की पुष्टि के लिए प्रत्येक मालिक का नाम और पता फ़ील्ड; और, ट्रेडमार्क के तहत, कीवर्ड के साथ पंजीकरण_संख्या और अनुक्रमांक नीचे की जांच या UI लिंकिंग के लिए।
2) ट्रेडमार्क उपलब्धता
विधि: GET
URL: https://zylalabs.com/api/1495/trademark-search-api/1237/trademark-availability
यह क्या करता है: यह लौटाता है कि क्या दी गई कीवर्ड उपलब्ध है और उपलब्ध_classes, unavailable_classes, और संबंधित serial_numbers की सूची बनाता है। प्रमाणीकरण आवश्यक है। इस उदाहरण के लिए कोई अनुरोध पैरामीटर प्रलेखित नहीं हैं।
जब आपको हाँ/नहीं और वर्ग विभाजन की आवश्यकता होती है तो इसका उपयोग करें ताकि उत्पाद निर्णयों को चलाया जा सके। उदाहरण के लिए, एक नामकरण सेवा यदि unavailable_classes लक्षित वर्ग सेट के साथ ओवरलैप करती है तो सबमिशन को ब्लॉक कर सकती है।
3) ट्रेडमार्क खोज
विधि: GET
URL: https://zylalabs.com/api/1495/trademark-search-api/1238/trademark-search
यह क्या करता है: कीवर्ड खोज जो मार्क नाम, अनुक्रम और पंजीकरण संख्या, स्थिति जानकारी, मालिक विवरण, और फाइलिंग/पंजीकरण तिथियाँ लौटाती है। प्रमाणीकरण आवश्यक है। SearchType व्यवहार को लिस्टिंग में उच्च स्तर पर वर्णित किया गया है, जिसमें एक "सक्रिय" प्रकार शामिल है जो मृत मार्क को बाहर करता है; पैरामीटर विशिष्टताओं के लिए API पृष्ठ पर परामर्श करें।
इसका उपयोग समृद्ध विवरण के लिए करें: स्थिति_लेबल/कोड/परिभाषा, फाइलिंग_तारीख, पंजीकरण_तारीख, और मालिकों का डेटा एक उम्मीदवार मार्क के चारों ओर एक पूर्ण प्रोफ़ाइल पृष्ठ या आंतरिक डैशबोर्ड बनाने के लिए।
शिप करने के लिए कोड कॉपी-पेस्ट करें
Python उदाहरण: खोज कॉल करें और मालिक और मार्क आईडी निकालें
यह उदाहरण खोज एंडपॉइंट को कॉल करता है, फिर मालिक और पहले ट्रेडमार्क के अनुक्रम और पंजीकरण नंबरों को प्रिंट करता है। यह ऊपर दिए गए cURL नमूने के समान एंडपॉइंट का उपयोग करता है।
import os
import requests
API_KEY = os.environ.get("ZylaApiKey", "YOUR_API_KEY")
url = "https://zylalabs.com/api/1495/trademark-search-api/1236/search"
headers = {
"Authorization": f"Bearer {API_KEY}",
}
resp = requests.get(url, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
print(f"कुल मालिक: {data.get('count')}")
for owner in data.get("items", []):
print("मालिक:", owner.get("name"))
addr = ", ".join(filter(None, [
owner.get("address1"),
owner.get("address2"),
owner.get("city"),
owner.get("state"),
owner.get("postcode"),
owner.get("country"),
]))
print("पता:", addr)
for tm in owner.get("trademarks", []):
print(" - मार्क:", tm.get("keyword"))
print(" पंजीकरण #:", tm.get("registration_number"))
print(" अनुक्रम #:", tm.get("serial_number"))
कार्यान्वयन नोट्स:
- प्रमाणन: हमेशा Authorization: Bearer YOUR_API_KEY शामिल करें।
- समय समाप्त: अपने कार्यभार के लिए उपयुक्त क्लाइंट-साइड टाइमआउट सेट करें।
- नल: कुछ पता फ़ील्ड शून्य हो सकते हैं; उन्हें जोड़ने से पहले हटा दें।
- डुप्लिकेशन: खोज एंडपॉइंट जब पते बदलते हैं तो डुप्लिकेट मालिक लौटा सकता है; एक स्थिर कुंजी द्वारा डुप्लिकेट करें जिसे आप बनाए रखते हैं (जैसे, नाम + अनुक्रमों का संयोजन जो आपको महत्वपूर्ण हैं)।
उपलब्धता जांच के लिए व्यावहारिक पैटर्न
जब आपको प्रति वर्ग एक गो/नहीं निर्णय की आवश्यकता होती है, तो ट्रेडमार्क उपलब्धता कॉल करें और उपयोग करें:
- उपलब्ध: कीवर्ड के लिए "हाँ" या "नहीं"।
- उपलब्ध_classes: उन वर्गों की सूची जहाँ मार्क अभी भी उपलब्ध है।
- unavailable_classes: सूची जहाँ संघर्ष मौजूद हैं।
- serial_numbers: ऑडिटिंग या UI लिंक के लिए संघर्षशील पंजीकरण या फाइलिंग से जुड़े अनुक्रम।
विशिष्ट प्रवाह:
- फॉर्म या CI वेरिएबल से एक इनपुट कीवर्ड स्वीकार करें।
- ट्रेडमार्क-उपलब्धता कॉल करें और उपलब्ध और वर्ग ऐरे पढ़ें।
- यदि लक्षित वर्गों और unavailable_classes के बीच ओवरलैप मौजूद है, तो ब्लॉक या चेतावनी दें; अन्यथा आरक्षण की अनुमति दें और एक टाइमस्टैम्प निर्णय बनाए रखें।
- वैकल्पिक रूप से, स्थिति और मालिक की जानकारी इकट्ठा करने के लिए ट्रेडमार्क खोज के साथ फॉलो अप करें ताकि एक खारिज/अपील UI हो सके।
समय बचाने के लिए प्रतिक्रिया हैंडलिंग टिप्स
- प्रतिक्रिया आकार: खोज एक रूट ऑब्जेक्ट लौटाती है जिसमें गिनती और आइटम होते हैं; ट्रेडमार्क उपलब्धता की प्रतिक्रिया कीवर्ड, उपलब्ध ध्वज, वर्ग ऐरे, और अनुक्रम लौटाती है; ट्रेडमार्क खोज गिनती और आइटम लौटाती है जिसमें स्थिति_लेबल और मालिकों जैसे विस्तृत फ़ील्ड होते हैं।
- कैशिंग: यदि आपका UI अनुमति देता है, तो एकल सत्र में दोहराए गए चेक को कम करने के लिए छोटे समय के लिए सामान्यीकृत कीवर्ड द्वारा कैश करें। जब उपयोगकर्ता मार्क को संपादित करता है तो अमान्य करें।
- ऑडिटिंग: भविष्य की समीक्षाओं के लिए संदर्भित करने के लिए उपलब्धता जांच से अनुक्रमों को स्टोर करें कि किस फाइलिंग ने निर्णय के समय संघर्ष का कारण बना।
उत्पादन उपयोग के मामलों का निर्माण
- उत्पाद नामकरण गेट: PRD समीक्षा के दौरान, उम्मीदवार नाम के लिए उपलब्धता चलाएँ; यदि उपलब्धता "नहीं" है या लक्षित वर्ग unavailable_classes के साथ इंटरसेक्ट करते हैं, तो डिज़ाइन प्रतिबद्धताओं से पहले एक नाम परिवर्तन की आवश्यकता होती है।
- मार्केटप्लेस लिस्टिंग मॉडरेशन: विक्रेता या स्टोर निर्माण पर, प्रस्तावित स्टोर नाम को मान्य करें; यदि संघर्ष उत्पन्न होते हैं, तो संघर्षों को प्रदर्शित करने के लिए पहले कुछ अनुक्रमों सहित एक अस्वीकृति कारण प्रस्तुत करें।
- डोमेन-साइड ट्रायज: अपने डोमेन उपलब्धता लॉजिक को ट्रेडमार्क-उपलब्धता के साथ संयोजित करें। यदि एक डोमेन मुक्त है लेकिन मार्क आपके संचालन वर्ग में लिया गया है, तो ब्लॉक करें और वैकल्पिक सलाह दें।
- CI जांच: एक मोनोरेपो में, ब्रांडिंग संपत्तियों में परिवर्तन को पार्स करें, प्रदर्शित नाम निकालें, और यदि संघर्ष मौजूद हैं तो निर्माण विफल करने के लिए GitHub Action में उपलब्धता कॉल करें।
AI एजेंटों से MCP के माध्यम से API कॉल करना
यदि आप Claude Code, Cursor, या Windsurf जैसे डेवलपर उपकरणों से जांचों का आयोजन करते हैं, तो आप Zyla के MCP-संगत एंडपॉइंट के माध्यम से समान हब एंडपॉइंट्स को कॉल कर सकते हैं। अपने क्लाइंट को MCP सेवा तक पहुँचने के लिए कॉन्फ़िगर करें और अपने क्लाइंट के MCP कॉन्फ़िगरेशन के अनुसार अपनी API कुंजी प्रदान करें। एजेंट आपके Authorization हेडर का उपयोग करके ऊपर प्रलेखित हब URLs को सक्रिय करेगा, ताकि आपका कोड और एजेंट कार्यप्रवाह संरेखित रहें।
परीक्षण और संचालन पर विचार
- सामान्यीकरण: अपने UI और अपने कैश कुंजी में कीवर्ड (केस, उच्चारण, विराम चिह्न) को सामान्यीकृत करें ताकि उपयोगकर्ताओं को केस टॉगल करते समय असंगत उत्तर न मिलें।
- मालिक डुप्लिकेट: जब ऐतिहासिक पते मौजूद होते हैं तो खोज परिणामों में डुप्लिकेट की अपेक्षा करें; अपने दृश्य स्तर में डुप्लिकेट करें।
- लेटेंसी बजट: फ्रंटेंड चेक को छोटे क्लाइंट टाइमआउट और आशावादी UI पैटर्न का उपयोग करना चाहिए; बैकएंड बैच स्क्रीनिंग लंबे समय के समय समाप्तियों को समायोजित कर सकती है।
- कोटा: ट्रेडमार्क खोज API सदस्यता + कोटा का उपयोग करती है, प्रति कॉल भुगतान नहीं। 7-दिन के परीक्षण या 50 अनुरोधों के साथ शुरू करें, फिर API पृष्ठ पर आवश्यकतानुसार अपनी योजना को समायोजित करें।
संदर्भ: एंडपॉइंट्स का सारांश
- खोज (GET): https://zylalabs.com/api/1495/trademark-search-api/1236/search
- ट्रेडमार्क उपलब्धता (GET): https://zylalabs.com/api/1495/trademark-search-api/1237/trademark-availability
- ट्रेडमार्क खोज (GET): https://zylalabs.com/api/1495/trademark-search-api/1238/trademark-search
सभी एंडपॉइंट्स को Authorization: Bearer YOUR_API_KEY हेडर की आवश्यकता होती है। केवल ऊपर दिए गए फ़ील्ड और URLs प्रलेखित हैं; यदि आपको अतिरिक्त फ़िल्टर या पैरामीटर की आवश्यकता है, तो अपडेट के लिए मार्केटप्लेस पृष्ठ की जांच करें।
अक्सर पूछे जाने वाले प्रश्न
मैं प्रमाणीकरण कैसे करता हूँ?
हब URLs के लिए हर अनुरोध हेडर में Authorization: Bearer YOUR_API_KEY शामिल करें।
क्या मैं अनुरोध में वर्ग या अधिकार क्षेत्र द्वारा फ़िल्टर कर सकता हूँ?
उपरोक्त सार्वजनिक लिस्टिंग इन उदाहरणों के लिए अनुरोध पैरामीटर को प्रलेखित नहीं करती है। वर्ग-विशिष्ट क्रियाओं का निर्णय लेने के लिए ट्रेडमार्क उपलब्धता प्रतिक्रिया के available_classes और unavailable_classes का उपयोग करें, और पैरामीटर अपडेट के लिए API के मार्केटप्लेस पृष्ठ की जांच करें।
कौन से फ़ील्ड मुझे बताते हैं कि एक मार्क "सक्रिय" है बनाम "मृत"?
ट्रेडमार्क खोज एंडपॉइंट का उपयोग करें और प्रतिक्रिया में status_label, status_code, और status_definition पढ़ें। लिस्टिंग एक "सक्रिय" SearchType नोट करती है जो मृत मार्क को बाहर करती है; विशिष्टताओं के लिए API पृष्ठ पर परामर्श करें।
क्या डुप्लिकेट मालिक हैं?
हाँ। खोज एंडपॉइंट डुप्लिकेट मालिक प्रविष्टियाँ लौटा सकता है, विशेष रूप से जब मालिक ने पते बदले हैं। अपने व्यवसाय लॉजिक के आधार पर नीचे की ओर डुप्लिकेट करें।
मूल्य निर्धारण मॉडल क्या है?
Zyla APIs सदस्यता + कोटा का उपयोग करती हैं, प्रति कॉल भुगतान नहीं। इस API के लिए आप 7-दिन के परीक्षण या 50 अनुरोधों के साथ शुरू कर सकते हैं। वर्तमान योजनाओं और सीमाओं के लिए मार्केटप्लेस पृष्ठ देखें।
क्या आप इसे अपने ऐप में वायर करने और शिप करने के लिए तैयार हैं? अपनी कुंजी प्राप्त करें और Trademark Search API पर 7-दिन के परीक्षण के साथ शुरू करें। एक खाता Zyla API Hub पर हजारों APIs को एक ही कुंजी और सदस्यता मॉडल के साथ अनलॉक करता है।