वेबसाइट वर्गीकरण एपीआई के साथ काम करना

आपके पास डोमेन, पूर्ण यूआरएल और ईमेल पते की एक सूची है, और आपको उन्हें मार्केटिंग-फ्रेंडली या IAB-शैली की श्रेणियों में स्वचालित रूप से टैग करने की आवश्यकता है सप्ताह के अंत तक। इस गाइड के अंत तक, आप Zyla API Hub पर वेबसाइट वर्गीकरण एपीआई को एक यूआरएल या एक ईमेल डोमेन भेजने में सक्षम होंगे और संरचित श्रेणियाँ, विश्वास स्कोर, और उपयोगी मेटाडेटा प्राप्त करेंगे जिसका आप तुरंत लीड स्कोरिंग, सामग्री मॉडरेशन, राउटिंग, या एनालिटिक्स में उपयोग कर सकते हैं।

यह एपीआई क्या प्रदान करता है

वेबसाइट वर्गीकरण एपीआई वेब प्रॉपर्टीज और ईमेल डोमेन को श्रेणियों में वर्गीकृत करता है और एक लोगो यूआरएल, सामाजिक लिंक जैसे अतिरिक्त संदर्भ लौटाता है जब उपलब्ध हो, और वैकल्पिक कंपनी विशेषताएँ। यह निम्नलिखित पर काम करता है:

• पूर्ण यूआरएल (जैसे, https://example.com/path) पृष्ठ-स्तरीय वर्गीकरण के लिए।
• ईमेल डोमेन (जैसे, gmail.com से [email protected]) मेलबॉक्स/प्रदाता पहचान और संबंधित जानकारी के लिए।

विशिष्ट अनुप्रयोगों में लीड समृद्धि, विज्ञापन लक्ष्यीकरण संरेखण, सामग्री फ़िल्टरिंग, और एनालिटिक्स खंडन शामिल हैं। आप दो POST एंडपॉइंट्स के साथ बातचीत करेंगे जो एकल पैरामीटर स्वीकार करते हैं और JSON लौटाते हैं।

Zyla API Hub पर शुरू करना

एपीआई सूची खोलें और एपीआई कुंजी प्राप्त करने के लिए सदस्यता लें। Zyla API Hub एक सदस्यता + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। यह एपीआई अपनी सूची पृष्ठ पर 7-दिन की परीक्षण अवधि प्रदान करता है ताकि आप बिना प्रतिबद्धता के जल्दी प्रोटोटाइप कर सकें।

• वेबसाइट वर्गीकरण एपीआई सूची पर जाएँ: वेबसाइट वर्गीकरण एपीआई पर 7-दिन का परीक्षण शुरू करें।
• सदस्यता लें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें), फिर अपनी एपीआई कुंजी कॉपी करें।
• हर अनुरोध में हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करें।

एक खाता, एक एपीआई कुंजी, और Zyla Hub कैटलॉग में 10,000 से अधिक सार्वजनिक एपीआई के लिए एक सुसंगत सदस्यता मॉडल लागू होता है। जब आप अपने स्टैक में समृद्धि या उपयोगिताएँ जोड़ने के लिए तैयार हों, तो मार्केटप्लेस का अन्वेषण करें zylalabs.com।

एंडपॉइंट्स का अवलोकन

1) यूआरएल वर्गीकरण

इसका उपयोग एक पूर्ण यूआरएल पथ को वर्गीकृत करने के लिए करें, न कि केवल रूट डोमेन।

• विधि: POST
• अनुरोध यूआरएल: https://zylalabs.com/api/12/website-categorization-api/48/url
• आवश्यक पैरामीटर: url (जैसे, https://google.com)

आपको क्या वापस मिलता है: विश्वास के साथ श्रेणियाँ, एक लोगो_url, और जब उपलब्ध हो, सामाजिक मीडिया लिंक और कंपनी वस्तुएँ। इसका उपयोग तब करें जब पृष्ठ-स्तरीय संदर्भ महत्वपूर्ण हो या जब आप एक नग्न डोमेन तक सामान्यीकृत नहीं करना चाहते।

2) ईमेल डोमेन वर्गीकरण

एक ईमेल पता प्रस्तुत करें ताकि उस ईमेल के प्रदाता/डोमेन के लिए डोमेन-स्तरीय जानकारी वर्गीकृत और पुनर्प्राप्त की जा सके।

• विधि: POST
• अनुरोध यूआरएल: https://zylalabs.com/api/12/website-categorization-api/1989/email
• आवश्यक पैरामीटर: email (जैसे, [email protected])

आपको क्या वापस मिलता है: श्रेणियाँ, लोगो_url, और जब उपलब्ध हो, डोमेन पंजीकरण डेटा और समान डोमेन की सूची। इसका उपयोग लीड या उपयोगकर्ताओं को मेलबॉक्स प्रदाता द्वारा खंडित करने या CRM रिकॉर्ड को समृद्ध करने के लिए करें।

यूआरएल वर्गीकरण के लिए न्यूनतम, कॉपी-पेस्ट cURL

एक पूर्ण यूआरएल भेजें और विश्वास मानों और संबंधित मेटाडेटा के साथ श्रेणी डेटा प्राप्त करें।

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"

आधिकारिक नमूना प्रतिक्रिया:

{
"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 एक पठनीय वर्गीकरण पथ देता है; अन्य फ़ील्ड IAB कोड के लिए मानचित्रित होते हैं।
• domain.logo_url: प्रदाता या कंपनी का लोगो यूआरएल।
• domain.social_media: ज्ञात सामाजिक लिंक जब उपलब्ध हो (शायद null)।
• success: इस पर भरोसा करने से पहले इसे जांचें।
• objects.company: वैकल्पिक कंपनी मेटाडेटा जैसे नाम, स्थान, टैग, और तकनीकी स्टैक प्रविष्टियाँ जब उपलब्ध हो।

Python उदाहरण: एक यूआरएल को वर्गीकृत करें और प्रमुख फ़ील्ड पढ़ें

यह उदाहरण एक यूआरएल पोस्ट करता है, सफलता ध्वज की जांच करता है, और इसके विश्वास और लोगो यूआरएल के साथ शीर्ष श्रेणी को प्रिंट करता है। यह केवल प्रलेखित एंडपॉइंट और पैरामीटर का उपयोग करता है।

import requests

API_KEY = "YOUR_API_KEY"
ENDPOINT = "https://zylalabs.com/api/12/website-categorization-api/48/url"

def categorize_url(target_url: str):
headers = {
"Authorization": f"Bearer {API_KEY}",
}
# Use form encoding to mirror --data-urlencode behavior
data = {
"url": target_url
}
resp = requests.post(ENDPOINT, headers=headers, data=data, timeout=20)
resp.raise_for_status()
payload = resp.json()
if not payload.get("success"):
raise RuntimeError("API returned success=false")

domain = payload.get("domain", {})
categories = domain.get("categories", []) or []
logo_url = domain.get("logo_url")

top = categories[0] if categories else None
if top:
print("Top category:", top.get("name"))
print("Confidence:", top.get("confidence"))
else:
print("No categories found")

print("Logo URL:", logo_url)
return payload

if __name__ == "__main__":
categorize_url("https://google.com")

ईमेल एंडपॉइंट: ईमेल डोमेन द्वारा त्वरित वर्गीकरण

एक ईमेल पता प्रस्तुत करें; एपीआई डोमेन का अनुमान लगाता है और वर्गीकरण और संबंधित जानकारी लौटाता है।

• विधि: POST
• अनुरोध यूआरएल: https://zylalabs.com/api/12/website-categorization-api/1989/email
• पैरामीटर: email (आवश्यक)

उदाहरण प्रतिक्रिया:

इस पेलोड से आप निकाल सकते हैं:

• domain.categories: मेलबॉक्स प्रदाता के डोमेन को वर्गीकृत करें।
• logo_url: अपने UI में उपयोगकर्ता ईमेल के बगल में एक लोगो प्रदर्शित करें।
• domain_registration_data और समान_domains जब उपलब्ध हो: हीयूरिस्टिक्स या फजी मिलान के लिए सहायक।

जो शिप करते हैं उनके कार्यान्वयन पैटर्न

• लीड स्कोरिंग: साइनअप पर ईमेल एंडपॉइंट को कॉल करें ताकि डोमेन को टैग किया जा सके और स्कोर को समायोजित किया जा सके (जैसे, "ईमेल" श्रेणी → उपभोक्ता मेलबॉक्स प्रदाता)।
• सामग्री राउटिंग: यूआरएल की एक सूची के लिए, प्रत्येक को यूआरएल एंडपॉइंट पर भेजें और शीर्ष श्रेणी के आधार पर प्रासंगिक मॉडरेशन या प्रोसेसिंग कतार में रूट करें।
• विज्ञापन संरेखण: लौटाई गई श्रेणियों को अपने आंतरिक वर्गीकरण में मानचित्रित करें या श्रेणियों ऐरे में मौजूद IAB मानचित्रण फ़ील्ड का सीधे उपयोग करें।
• UI समृद्धि: पहचाने गए डोमेन के लिए एक लोगो_url और ज्ञात सामाजिक लिंक प्रदर्शित करें ताकि डैशबोर्ड में सहायक संदर्भ जोड़ा जा सके।

समय बचाने के लिए अनुरोध विवरण

• Authorization: HTTP हेडर Authorization: Bearer YOUR_API_KEY सेट करें।
• फॉर्म एन्कोडिंग: हब उदाहरण --data-urlencode का उपयोग करते हैं। अपने कोड में, इसको दर्शाने के लिए फॉर्म फ़ील्ड (application/x-www-form-urlencoded) या एक सामान्य फॉर्म बॉडी भेजें।
• नल हैंडलिंग: सामाजिक लिंक और कुछ कंपनी फ़ील्ड नल हो सकते हैं। अपने JSON पार्सिंग को तदनुसार सुरक्षित करें।
• कैशिंग: समान यूआरएल/डोमेन के लिए श्रेणियाँ अक्सर नहीं बदलतीं। उपयुक्त होने पर कैनोनिकल यूआरएल या डोमेन के अनुसार परिणामों को कैश करें।
• बैचिंग: यदि आप सूचियों को वर्गीकृत कर रहे हैं, तो अपने क्लाइंट स्तर पर समानांतर करें और अपने सदस्यता कोटा का सम्मान करें। अपने वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए एपीआई सूची की जांच करें।

AI एजेंटों से MCP के माध्यम से कॉल करना

यदि आप क्लॉड कोड, कर्सर, विंडसर्फ, या किसी भी MCP-संगत क्लाइंट के साथ समन्वय कर रहे हैं, तो आप Zyla के MCP एंडपॉइंट के माध्यम से कॉल रूट कर सकते हैं। अपने एपीआई कुंजी को MCP यूआरएल में प्रदान करें और अपने एजेंट को आपके लिए प्रलेखित एंडपॉइंट्स कॉल करने दें।

• MCP एंडपॉइंट: MCP
• उपयोग: अपने उपकरण को MCP एंडपॉइंट और अपनी कुंजी के साथ कॉन्फ़िगर करें। एजेंट से, आवश्यक पैरामीटर (यूआरएल या ईमेल) और Authorization हेडर के साथ ऊपर दिखाए गए समान वेबसाइट वर्गीकरण एपीआई एंडपॉइंट्स को कॉल करें।

यह आपको Zyla पारिस्थितिकी तंत्र में उपकरणों के बीच एकल एपीआई कुंजी बनाए रखते हुए एक स्वायत्त कार्यप्रवाह के भीतर वर्गीकरण चरणों को बनाए रखने की अनुमति देता है। अपने एजेंटों के लिए अधिक एपीआई का अन्वेषण करें zylalabs.com पर।

समस्या निवारण और उत्पादन चेकलिस्ट

• इनपुट मान्य करें: सुनिश्चित करें कि यूआरएल एक सही स्वरूपित पूर्ण यूआरएल है और ईमेल व्याकरणिक रूप से मान्य है।
• सफलता की जांच करें: श्रेणी ऐरे पढ़ने से पहले सफलता फ़ील्ड सत्यापित करें।
• फॉलबैक: जब श्रेणियाँ खाली या नल हों, तो एक डिफ़ॉल्ट मार्ग पर निर्णय लें (जैसे, "अवर्गीकृत").
• टाइमआउट/रीट्राई: क्लाइंट टाइमआउट सेट करें और अस्थायी नेटवर्क त्रुटियों पर पुनः प्रयास करें। पुनः प्रयास लूप से बचें जो जल्दी से कोटा का उपभोग कर सकते हैं।
• लॉगिंग: भविष्य के ट्यूनिंग और डिबगिंग में मदद के लिए श्रेणी नाम और विश्वास को लॉग करें।

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

कौन सी प्रमाणीकरण विधि आवश्यक है?
हर अनुरोध पर HTTP हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करें।

क्या मैं एक पूर्ण पथ को वर्गीकृत कर सकता हूँ (केवल रूट डोमेन नहीं)?
हाँ, यूआरएल एंडपॉइंट का उपयोग करें (POST to https://zylalabs.com/api/12/website-categorization-api/48/url) url पैरामीटर के साथ।

मैं उपयोगकर्ताओं को उनके ईमेल प्रदाताओं द्वारा कैसे वर्गीकृत करूँ?
ईमेल एंडपॉइंट का उपयोग करें (POST to https://zylalabs.com/api/12/website-categorization-api/1989/email) email पैरामीटर के साथ। प्राथमिक श्रेणी और विश्वास के लिए domain.categories को पार्स करें।

Zyla कौन सा योजना मॉडल उपयोग करता है?
सदस्यता + कोटा। यह एपीआई अपनी सूची पृष्ठ पर 7-दिन की परीक्षण अवधि प्रदान करता है ताकि आप जल्दी से मूल्यांकन कर सकें। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।

कौन से फ़ील्ड को सुरक्षित रूप से उपस्थित मानने के लिए?
हमेशा सफलता की जांच करें। domain.categories ऐरे, logo_url, social_media, और objects.company फ़ील्ड मौजूद हो सकते हैं, लेकिन कुछ मान नल हो सकते हैं। गायब फ़ील्ड के खिलाफ सुरक्षा करें।

इसे शिप करें

आपके पास अब वेबसाइट वर्गीकरण एपीआई के लिए कार्यशील cURL और Python उदाहरण हैं। सदस्यता लें, अपनी कुंजी प्राप्त करें, और आज ही यूआरएल और ईमेल डोमेन को वर्गीकृत करना शुरू करें: वेबसाइट वर्गीकरण एपीआई पर 7-दिन का परीक्षण शुरू करें।