आपके पीएम ने "हर लीड की वेबसाइट और ईमेल डोमेन को श्रेणी द्वारा ऑटो-टैग करने" के लिए कहा और आपको कुछ चाहिए जो आप इस सप्ताह भेज सकें। इस लेख के अंत तक, आप ज़ाइला एपीआई हब पर वेबसाइट वर्गीकरण एपीआई को एक पूर्ण यूआरएल या एक ईमेल पता भेजने में सक्षम होंगे और ठोस श्रेणियाँ (विश्वास के साथ), एक लोगो यूआरएल, और संबंधित मेटाडेटा प्राप्त कर सकेंगे जिसे आप सीधे अपने समृद्धि, रूटिंग, या एनालिटिक्स पाइपलाइन में प्लग कर सकते हैं।
यह एपीआई क्या करती है और इसका उपयोग कब करें
वेबसाइट वर्गीकरण एपीआई एक यूआरएल पथ (केवल रूट डोमेन नहीं) या एक ईमेल डोमेन को वर्गीकृत करती है और विश्वास स्कोर के साथ श्रेणियाँ लौटाती है, साथ ही उपलब्ध होने पर एक लोगो यूआरएल और सामाजिक लिंक जैसे उपयोगी अतिरिक्त। सामान्य एकीकरण में सीआरएम समृद्धि, उद्योग द्वारा लीड रूटिंग, सामग्री मॉडरेशन, और एनालिटिक्स विभाजन शामिल हैं।
आप कर सकते हैं:
- एक पूर्ण यूआरएल को श्रेणीबद्ध करें (जैसे, लैंडिंग पृष्ठ, ब्लॉग पोस्ट, उत्पाद यूआरएल)।
- एक संपर्क रिकॉर्ड से एक ईमेल डोमेन को श्रेणीबद्ध करें ताकि संगठन के संदर्भ का अनुमान लगाया जा सके।
यह एपीआई ज़ाइला एपीआई हब पर उपलब्ध है, जो हजारों एपीआई के बीच एक खाता, एक एपीआई कुंजी, और एक सदस्यता-प्लस-कोटा मॉडल प्रदान करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।
ज़ाइला एपीआई हब पर शुरुआत करना
वेबसाइट वर्गीकरण एपीआई लिस्टिंग खोलें, उपलब्ध होने पर सदस्यता लें या मुफ्त परीक्षण शुरू करें, और अपनी एपीआई कुंजी कॉपी करें। प्रमाणीकरण एकल एचटीटीपी हेडर है: Authorization: Bearer YOUR_API_KEY.
यहां से शुरू करें: वेबसाइट वर्गीकरण एपीआई पर 7-दिन का परीक्षण शुरू करें. ज़ाइला सदस्यता + कोटा का उपयोग करता है (पे-पर-कॉल नहीं)। पहले एकीकरण के लिए, आप आमतौर पर 7-दिन का परीक्षण या सीमित अनुरोध कोटा देखेंगे; वर्तमान विकल्प के लिए लिस्टिंग की जांच करें।
आप कॉल कर सकते हैं ऐसे एंडपॉइंट्स
यह एपीआई ज़ाइला एपीआई हब पर दो पोस्ट एंडपॉइंट्स को उजागर करती है। दोनों को Authorization हेडर की आवश्यकता होती है और URL-encoded फॉर्म पैरामीटर स्वीकार करते हैं।
1) यूआरएल: एक पूर्ण यूआरएल पथ को श्रेणीबद्ध करें
जब आपको एक विशिष्ट पृष्ठ को वर्गीकृत करने की आवश्यकता हो, न कि केवल रूट डोमेन।
- विधि: POST
- अनुरोध यूआरएल: https://zylalabs.com/api/12/website-categorization-api/48/url
- आवश्यक पैरामीटर: url (पूर्ण यूआरएल जिसे आप श्रेणीबद्ध करना चाहते हैं)
आधिकारिक कर्ल (जैसा है कॉपी/पेस्ट करें और YOUR_API_KEY को बदलें):
curl -s -X POST "https://zylalabs.com/api/12/website-categorization-api/48/url"
-H "Authorization: Bearer YOUR_API_KEY"
--data-urlencode "url=https://google.com"आधिकारिक नमूना JSON प्रतिक्रिया:
{
"domain": {
"categories": [
{
"confidence": 0.9019761085510254,
"name": "/Internet & Telecom/Email & Messaging/Email",
"IAB19-15": "Email",
"IAB-623-619": "Internet - Email"
}
],
"logo_url": "https://klazify.s3.amazonaws.com/187668924417925096926ad786fcaae866.96410880.png",
"social_media": {
"facebook_url": null,
"twitter_url": null,
"instagram_url": null,
"medium_url": null,
"youtube_url": "https://www.youtube.com/?gl=US&tab=w1",
"pinterest_url": null,
"linkedin_url": null,
"github_url": null
}
},
"success": true,
"objects": {
"company": {
"name": "Google",
"city": "Mountain View",
"stateCode": "CA",
"countryCode": "US",
"employeesRange": "100K+",
"revenue": 257637000000,
"raised": null,
"tags": [
"Internet",
"Publishers",
"Broadcasting",
"Information",
"Publishing",
"Web Search",
"Web & Client Portals",
"Technology",
"Web Services & Apps",
"Information Technology & Services",
"B2C",
"SAAS",
"B2B"
],
"tech": [
"google_apps",
"db2",
"media.net",
"grafana",
"marchex",
"oracle_crm",
"smartsheet",
"sybase",
"apache_kafka",
"sage_50cloud",
"splunk",
"oracle_endeca",
"informatica",
"appnexus",
"apache_http_server",
"apache_spark",
"ibm_infosphere",
"wrike",
"sap_hybris_marketing",
"couchbase",
"atlassian_fisheye",
"gitlab",
"dropbox",
"woo_commerce",
"workamajig",
"workday",
"atlassian_jira",
"sas_enterprise",
"oracle_cash_and_treasury_management",
"qliktech",
"thomson_reuters_eikon",
"flexer…आप वास्तव में क्या उपयोग करेंगे:
- domain.categories: श्रेणी वस्तुओं की सूची। प्रत्येक वस्तु में शामिल हैं:
- name: वर्गीकरण पथ (जैसे, “/Internet & Telecom/Email & Messaging/Email”).
- confidence: वर्गीकरण विश्वास को इंगित करने वाला संख्यात्मक स्कोर।
- IAB पहचानकर्ता जब उपलब्ध हो (जैसे, IAB19-15, IAB-623-619).
- domain.logo_url: UI बैज या CRM कार्ड के लिए उपयोगी।
- domain.social_media: यूआरएल मौजूद हो सकते हैं या शून्य; शून्य जांच करें।
- objects.company: नाम, स्थान फ़ील्ड, employeesRange, revenue, tags, और तकनीकी स्टैक संकेतक जैसे मेटाडेटा जब उपलब्ध हो।
- success: सफल वर्गीकरण की पुष्टि करने के लिए बूलियन।
पायथन उदाहरण: एक यूआरएल को श्रेणीबद्ध करें और शीर्ष श्रेणी चुनें
यह उदाहरण प्रमाणीकरण हेडर के साथ फॉर्म-कोडेड डेटा पोस्ट करता है, फिर शीर्ष श्रेणी नाम और विश्वास को उठाता है। यह मूल शून्य-सुरक्षित पहुंच का भी प्रदर्शन करता है।
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/12/website-categorization-api/48/url"
def categorize_url(target_url: str):
headers = {
"Authorization": f"Bearer {API_KEY}",
}
# The endpoint expects URL-encoded form data
data = {
"url": target_url
}
resp = requests.post(URL, headers=headers, data=data, timeout=30)
resp.raise_for_status()
payload = resp.json()
# Safely read fields
domain = payload.get("domain") or {}
cats = domain.get("categories") or []
top = cats[0] if cats else None
result = {
"success": payload.get("success") is True,
"top_category_name": (top or {}).get("name"),
"top_category_confidence": (top or {}).get("confidence"),
"logo_url": domain.get("logo_url"),
"social_youtube": (domain.get("social_media") or {}).get("youtube_url"),
"company_name": ((payload.get("objects") or {}).get("company") or {}).get("name"),
}
return result
if __name__ == "__main__":
out = categorize_url("https://google.com")
print(out)2) ईमेल: ईमेल डोमेन द्वारा श्रेणीबद्ध करें
जब आपके पास एक ईमेल पता हो और आप डोमेन की श्रेणी का अनुमान लगाना चाहते हैं। यह सीआरएम या मार्केटिंग ऑटोमेशन में सुविधाजनक है, जहां ईमेल प्राथमिक पहचानकर्ता है।
- विधि: POST
- अनुरोध यूआरएल: https://zylalabs.com/api/12/website-categorization-api/1989/email
- आवश्यक पैरामीटर: email (ईमेल पता जिसका डोमेन आप श्रेणीबद्ध करना चाहते हैं)
आधिकारिक कर्ल:
उदाहरण प्रतिक्रिया (लिस्टिंग पर प्रदान की गई के रूप में संक्षिप्त):
ध्यान दें कि संरचना अभी भी domain.categories को शामिल करती है, और फ़ील्ड डेटा उपलब्ध नहीं होने पर शून्य हो सकते हैं। हमेशा शून्य-चेक करें।
समय बचाने के लिए कार्यान्वयन विवरण
- प्रमाणीकरण: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY शामिल करें।
- कोडिंग: दोनों एंडपॉइंट्स URL-encoded फॉर्म पैरामीटर की अपेक्षा करते हैं (जैसा कि कर्ल में --data-urlencode द्वारा दिखाया गया है)।
- अनुरोध शरीर: प्रत्येक एंडपॉइंट के लिए केवल आवश्यक पैरामीटर भेजें:
- यूआरएल एंडपॉइंट की आवश्यकता है: url
- ईमेल एंडपॉइंट की आवश्यकता है: email
- शून्यता: कई फ़ील्ड (जैसे, सामाजिक मीडिया यूआरएल या कंपनी मेटाडेटा) शून्य हो सकते हैं। अपने एक्सेसर्स की सुरक्षा करें।
- कैशिंग: यदि आप बार-बार समान डोमेन/यूआरएल को श्रेणीबद्ध करते हैं, तो कॉल और विलंबता को कम करने के लिए सामान्यीकृत यूआरएल या ईमेल डोमेन द्वारा की गई ऐप-स्तरीय कैश जोड़ें।
- बैचिंग: लिस्टिंग एकल-आइटम एंडपॉइंट्स को उजागर करती है। यदि आपको बैच थ्रूपुट की आवश्यकता है, तो अपने सदस्यता कोटा का सम्मान करते हुए क्लाइंट-साइड पर समवर्ती कार्यकर्ताओं को चलाएँ।
- त्रुटि हैंडलिंग: HTTP स्थिति कोड और प्रतिक्रिया में सफलता बूलियन की जांच करें। यदि कोई फ़ील्ड गायब है, तो इसे अनुपलब्ध के रूप में मानें न कि त्रुटि के रूप में।
- संगति: एक पृष्ठ यूआरएल अपने रूट डोमेन की तुलना में एक अधिक विशिष्ट श्रेणी उत्पन्न कर सकता है। प्रति-पृष्ठ कार्यप्रवाह के लिए यूआरएल एंडपॉइंट को प्राथमिकता दें।
व्यावहारिक उपयोग के मामले जिन्हें आप इस सप्ताह बना सकते हैं
- लीड रूटिंग: अपने साइनअप फॉर्म पर प्रस्तुत वेबसाइट यूआरएल को श्रेणीबद्ध करें और उद्योग/श्रेणी के आधार पर सही बिक्री कतार में असाइन करें।
- ईएसपी/सीआरएम समृद्धि: जब आपके पास केवल एक ईमेल हो, तो ईमेल एंडपॉइंट का उपयोग करें ताकि डोमेन श्रेणी का अनुमान लगाया जा सके और संपर्कों को ऑनबोर्डिंग प्रवाह के लिए ऑटो-टैग किया जा सके।
- विज्ञापन लक्ष्यीकरण और अपवाद: सामग्री यूआरएल को वर्गीकृत करें ताकि यह सुनिश्चित हो सके कि अभियान केवल अनुमत श्रेणियों के खिलाफ चलें।
- सामग्री एनालिटिक्स: अपने उत्पाद या ब्लॉग में श्रेणी के अनुसार आउटबाउंड लिंक को टैग करें ताकि एक श्रेणी-स्तरीय जुड़ाव डैशबोर्ड बनाया जा सके।
- यूआई पॉलिश: अपने ऐप में कंपनी या लिंक पूर्वावलोकन के बगल में logo_url प्रदर्शित करें।
एआई एजेंटों से एपीआई को एमसीपी के माध्यम से कॉल करें
आप इन समान एंडपॉइंट्स को एक एमसीपी-संगत क्लाइंट (जैसे, क्लॉड कोड, कर्सर, विंडसर्फ) से भी ट्रिगर कर सकते हैं, अपने एजेंट को ज़ाइला एमसीपी गेटवे की ओर इशारा करके। अपने एमसीपी क्लाइंट कॉन्फ़िगरेशन में अपनी एपीआई कुंजी प्रदान करें और टूल इनवोकेशन के माध्यम से समान हब एंडपॉइंट्स को कॉल करें। कनेक्शन विवरण के लिए MCP देखें। एमसीपी गेटवे आपकी ज़ाइला एपीआई कुंजी और सदस्यता का उपयोग करता है; परिणाम सीधे HTTP कॉल के साथ मेल खाते हैं जो ऊपर दिखाए गए हैं।
शिप करने के लिए एक न्यूनतम कार्यप्रवाह
- एक ज़ाइला खाता बनाएं और लिस्टिंग पृष्ठ से एपीआई की सदस्यता लें। अपनी एपीआई कुंजी कॉपी करें।
- यूआरएल इनपुट के लिए (जैसे, फॉर्म या वेबहुक से), https://zylalabs.com/api/12/website-categorization-api/48/url पर पोस्ट करें जिसमें url पूर्ण पृष्ठ यूआरएल पर सेट हो।
- ईमेल इनपुट के लिए (जैसे, सीआरएम घटनाओं से), https://zylalabs.com/api/12/website-categorization-api/1989/email पर पोस्ट करें जिसमें email उपयोगकर्ता के ईमेल पर सेट हो।
- domain.categories[0].name और domain.categories[0].confidence पढ़ें; उन्हें logo_url के साथ अपने डेटाबेस में स्टोर करें।
- दोहराए गए यूआरएल/डोमेन के लिए शून्य जांचें और सरल कैशिंग जोड़ें। ज़ाइला में अपनी सदस्यता कोटा की निगरानी करें।
अक्सर पूछे जाने वाले प्रश्न
एपीआई कौन सा प्रमाणीकरण उपयोग करती है?
हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
क्या मैं एक विशिष्ट पृष्ठ को श्रेणीबद्ध कर सकता हूँ, केवल होम डोमेन नहीं?
हाँ। https://zylalabs.com/api/12/website-categorization-api/48/url पर यूआरएल एंडपॉइंट का उपयोग करें और पूर्ण यूआरएल पथ पास करें।
मैं रूटिंग के लिए किन फ़ील्ड्स पर भरोसा करूँ?
domain.categories पढ़ें, विशेष रूप से पहले आइटम का नाम और विश्वास। logo_url या social_media जैसे वैकल्पिक फ़ील्ड के लिए एक शून्य-सुरक्षित पथ बनाए रखें।
क्या कोई मुफ्त योजना है?
यह एपीआई सदस्यता + कोटा का उपयोग करती है और मुफ्त योजना की पेशकश नहीं करती है। वर्तमान पहुंच विकल्पों के लिए लिस्टिंग की जांच करें; आमतौर पर आप मूल्यांकन के लिए 7-दिन का परीक्षण या सीमित अनुरोध कोटा देखेंगे।
मैं इसे अपने एआई कोडिंग एजेंट के साथ कैसे एकीकृत करूँ?
अपने एजेंट को ज़ाइला के एमसीपी गेटवे से कनेक्ट करें और टूल के रूप में समान एंडपॉइंट्स को लागू करें। सेटअप विवरण के लिए ऊपर दिए गए एमसीपी लिंक का संदर्भ लें।
क्या आप वास्तविक ट्रैफ़िक को श्रेणीबद्ध करने और अपने एकीकरण को शिप करने के लिए तैयार हैं? यहां अपनी मूल्यांकन प्रक्रिया शुरू करें: वेबसाइट वर्गीकरण एपीआई पर 7-दिन का परीक्षण शुरू करें. आपकी सदस्यता ज़ाइला एपीआई हब पर एकल एपीआई कुंजी के साथ चलती है जिसे आप एमसीपी-सक्षम एजेंटों के माध्यम से भी उपयोग कर सकते हैं।
