होम
ब्लॉग
API for traffic source and overview
ब्लॉग

API for traffic source and overview

API for traffic source and overview

आपको एक डोमेन के लिए विश्वसनीय ट्रैफ़िक स्रोत और जुड़ाव डेटा की आवश्यकता है, और आपको यह इस सप्ताह चाहिए। इस लेख के अंत तक, आप जानेंगे कि कौन सा एंडपॉइंट ट्रैफ़िक स्रोत और अवलोकन मैट्रिक्स लौटाता है, इसे कैसे कॉल करना है, आप जिन फ़ील्ड्स की परवाह करते हैं उन्हें कैसे पार्स करना है, और कैसे एक AI एजेंट के माध्यम से MCP से वही कॉल करना है—Zyla API Hub से एक API कुंजी का उपयोग करके।

यह API क्या प्रदान करता है और कब इसका उपयोग करें

Zyla API Hub पर साइट ट्रैफ़िक API डोमेन-स्तरीय वेब ट्रैफ़िक इंटेलिजेंस लौटाता है: ट्रैफ़िक शेयर द्वारा शीर्ष देश, जुड़ाव मैट्रिक्स, और एक अवलोकन जिसमें साइट के लिए एक शीर्षक और विवरण शामिल है। एक साथी एंडपॉइंट समर्थित देशों और ISO कोड प्रदान करता है, जो तब उपयोगी होता है जब आप संख्यात्मक या वर्णात्मक देश कोड को आपके उत्पाद में पठनीय लेबल में मैप करना चाहते हैं।

Illustration: API for traffic source and overview

आम उपयोग:

  • मार्केटिंग एट्रिब्यूशन डैशबोर्ड जिन्हें शीर्ष-5 देश शेयर और जुड़ाव मैट्रिक्स की आवश्यकता होती है।
  • डोमेन ट्रैफ़िक पैटर्न और मासिक विज़िट के अनुमान के आधार पर बिक्री लीड स्कोरिंग।
  • सामग्री या SEO टूलिंग जो ट्रैफ़िक संदर्भ और मूल मेटाडेटा के साथ डोमेन को एनोटेट करता है।

सब कुछ एक Zyla खाते और एक API कुंजी के तहत चलता है; आप Zyla API Hub कैटलॉग (10,000+ APIs) से उसी कुंजी और एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करके किसी भी API को कॉल कर सकते हैं।

Zyla API Hub पर शुरुआत करना

Zyla पर साइट ट्रैफ़िक API पृष्ठ खोलें, सब्सक्राइब पर क्लिक करें या 7-दिन का परीक्षण शुरू करें, और अपनी API कुंजी प्राप्त करें। प्रमाणीकरण एक बियरर टोकन है जो Authorization: Bearer YOUR_API_KEY के रूप में भेजा जाता है। बिलिंग सब्सक्रिप्शन + कोटा है (पे-पर-कॉल नहीं)। पहले API के लिए, 7-दिन का परीक्षण या 50 अनुरोधों की अपेक्षा करें; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

यहाँ से शुरू करें: साइट ट्रैफ़िक API पर 7-दिन का परीक्षण शुरू करें। आप हमेशा Zyla API Hub होमपेज पर अधिक APIs का अन्वेषण कर सकते हैं।

आप जिन एंडपॉइंट्स का उपयोग करेंगे

1) ट्रैफ़िक स्रोत और अवलोकन

विधि: GET

URL: https://zylalabs.com/api/29/site-traffic-api/93/traffic-source-and-overview

यह क्या लौटाता है: प्रत्येक देश के लिए ट्रैफ़िक स्थिति (शीर्ष 5), ट्रैफ़िक स्रोत संदर्भ, और एक दिए गए डोमेन के लिए जुड़ाव जानकारी। प्रोटोकॉल या "www" के बिना डोमेन पास करें।

  • आवश्यक क्वेरी पैरामीटर: डोमेन (उदाहरण: google.com)

आधिकारिक cURL:

curl -s -X GET "https://zylalabs.com/api/29/site-traffic-api/1372/countries-list" \
-H "Authorization: Bearer YOUR_API_KEY"

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

{
"Version": 1,
"SiteName": "google.com",
"Description": "Learn about the Certified Publisher Program. Our publishing software experts will help you maximize revenue and grow your business.",
"TopCountryShares": [
{
"Country": 840,
"CountryCode": "US",
"Value": 0.23679350972974017
},
{
"Country": 392,
"CountryCode": "JP",
"Value": 0.059428140900848324
},
{
"Country": 356,
"CountryCode": "IN",
"Value": 0.05710248670449797
},
{
"Country": 76,
"CountryCode": "BR",
"Value": 0.049777326688909565
},
{
"Country": 826,
"CountryCode": "GB",
"Value": 0.03518837304351638
}
],
"Title": "Google Advanced Search",
"Engagments": {
"BounceRate": "0.28352824215831807",
"Month": "6",
"Year": "2026",
"PagePerVisit": "8.695346223748027",
"Visits": "84940150026",
"TimeOnSite": "605.4395199614316"
},
"EstimatedMonthlyVisits": {
"2026-04-01": 84751050692,…

ध्यान देने योग्य फ़ील्ड:

  • SiteName, Title, Description: UI में आप जो त्वरित मेटाडेटा दिखा सकते हैं।
  • TopCountryShares: ट्रैफ़िक शेयर द्वारा शीर्ष पांच देश। इसमें संख्यात्मक देश, दो-लेटर CountryCode, और अंशीय Value (share) शामिल है।
  • Engagments: पेलोड में महीने और वर्ष के लिए जुड़ाव मैट्रिक्स, जिसमें BounceRate, PagePerVisit, Visits, और TimeOnSite शामिल हैं।
  • EstimatedMonthlyVisits: विज़िट कुल के साथ दिनांक कुंजी (YYYY-MM-01)।

2) देशों की सूची

विधि: GET

URL: https://zylalabs.com/api/29/site-traffic-api/1372/countries-list

यह क्या लौटाता है: समर्थित देशों और कोडों की एक सूची। ट्रैफ़िक अवलोकन द्वारा लौटाए गए Country और CountryCode मूल्यों को प्रदर्शित करने के अनुकूल नामों और क्षेत्रों में मैप करने के लिए उपयोगी।

आधिकारिक cURL:

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

[{"name":"Afghanistan","alpha-2":"AF","alpha-3":"AFG","country-code":"004","iso_3166-2":"ISO 3166-2:AF","region":"Asia","sub-region":"Southern Asia","intermediate-region":"","region-code":"142","sub-region-code":"034","intermediate-region-code":""},{"name":"Åland Islands","alpha-2":"AX","alpha-3":"ALA","country-code":"248","iso_3166-2":"ISO 3166-2:AX","region":"Europe","sub-region":"Northern Europe","intermediate-region":"","region-code":"150","sub-region-code":"154","intermediate-region-code":""},{"name":"Albania","alpha-2":"AL","alpha-3":"ALB","country-code":"008","iso_3166-2":"ISO 3166-2:AL","region":"Europe","sub-region":"Southern Europe","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Algeria","alpha-2":"DZ","alpha-3":"DZA","country-code":"012","iso_3166-2":"ISO 3166-2:DZ","region":"Africa","sub-region":"Northern Africa","intermediate-region":"","region-code":"002","sub-region-code":"015","intermediate-region-code":""},{"name":"American Samoa","alpha-2":"AS","alpha-3":"ASM","country-code":"016","iso_3166-2":"ISO 3166-2:AS","region":"Oceania","sub-region":"Polynesia","intermediate-region":"","region-code":"009","sub-region-code":"061","intermediate-region-code":""},{"name":"Andorra","alpha-2":"AD","alpha-3":"AND","country-code":"020","iso_3166-2":"ISO 3166-2:AD","region":"Europe","sub-region":"Southern Europe","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Angola","alpha-2":"AO","alpha-3":"AGO","country-code":"024","iso_3166-2":"ISO 3166-2:AO","region":"Africa","sub-region":"Sub-Saharan Africa","intermediate-region":"Middle Africa","region-code":"002","sub-region-code":"202","intermediate-region-code":"017"},{"name":"Anguilla","alpha-2":"AI","alpha-3":"AIA","country-code":"660","iso_3166-2":"ISO 3166-2:AI","region":"Americas","sub-region":"Latin America and the Caribbean","intermediate-region":"Caribbean","region-code":"019","sub-region-code":"419","intermediate-region-code":"029"},{"name":"Antarctica","alpha-2":"AQ","alpha-3":"ATA","country-code":"010","iso_3166-2":"ISO 3166-2:AQ","region":"","sub-region":"","intermediate-region":"","region-code":"","sub-region-code":"","intermediate-region-code":""},{"name":"Antigua and Barbuda","alpha-2":"AG","alpha-3":"ATG","country-code":"028","iso_3166-2":"ISO 3166-2:AG","region":"Americas","sub-region":"Latin America and the Caribbean","intermediate-region":"Caribbean","region-code":"019","s…

सामान्य उपयोग: ट्रैफ़िक अवलोकन से TopCountryShares पंक्तियों को देश के नाम और क्षेत्रों के साथ समृद्ध करने के लिए alpha-2 या country-code द्वारा की गई स्थानीय कैश बनाएं।

एंड-टू-एंड उदाहरण: एक डोमेन का ट्रैफ़िक अवलोकन प्राप्त करें और देशों को मैप करें

नीचे एक न्यूनतम Python उदाहरण है जो:

  1. एक डोमेन के साथ ट्रैफ़िक स्रोत और अवलोकन एंडपॉइंट को कॉल करता है।
  2. एक बार देशों की सूची एंडपॉइंट को कॉल करता है और alpha-2 कोड द्वारा एक लुकअप तालिका बनाता है।
  3. पठनीय देश के नाम और शेयर के साथ शीर्ष-5 देश तालिका प्रिंट करता है।
import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
BASE = "https://zylalabs.com/api/29/site-traffic-api"

def get_overview(domain: str):
url = f"{BASE}/93/traffic-source-and-overview"
resp = requests.get(url, params={"domain": domain}, headers={"Authorization": f"Bearer {API_KEY}"})
resp.raise_for_status()
return resp.json()

def get_countries():
url = f"{BASE}/1372/countries-list"
resp = requests.get(url, headers={"Authorization": f"Bearer {API_KEY}"})
resp.raise_for_status()
return resp.json()

def build_country_lookup(countries):
# Map alpha-2 code to country name (e.g., "US" -> "United States of America")
lookup = {}
for c in countries:
alpha2 = c.get("alpha-2")
name = c.get("name")
if alpha2 and name:
lookup[alpha2] = name
return lookup

if __name__ == "__main__":
domain = "google.com"
overview = get_overview(domain)
countries = get_countries()
code_to_name = build_country_lookup(countries)

print(f"Site: {overview.get('SiteName')}")
print(f"Title: {overview.get('Title')}")
print(f"Description: {overview.get('Description')}")

print("\nTop 5 Countries by Share:")
for row in overview.get("TopCountryShares", []):
code = row.get("CountryCode")
share = row.get("Value")
name = code_to_name.get(code, code)
print(f"- {name} ({code}): {share}")

engagements = overview.get("Engagments", {})
print("\nEngagements:")
for k in ["Year", "Month", "Visits", "BounceRate", "PagePerVisit", "TimeOnSite"]:
if k in engagements:
print(f"{k}: {engagements[k]}")

नोट्स:

  • प्रमाणीकरण हेडर Authorization: Bearer YOUR_API_KEY के माध्यम से है।
  • इन GET एंडपॉइंट्स के लिए कोई अनुरोध शरीर आवश्यक नहीं है।
  • 24 घंटे या उससे अधिक के लिए देशों की सूची को कैश करने पर विचार करें; यह कम बार बदलता है और आपके प्रवाह को तेज करता है।

समय बचाने वाले व्यावहारिक कार्यान्वयन विवरण

  • डोमेन प्रारूप: केवल डोमेन पास करें, प्रोटोकॉल या "www" के बिना (जैसे, example.com)।
  • डेटा प्रकार: कई संख्यात्मक मान (जैसे, BounceRate, PagePerVisit) स्ट्रिंग के रूप में आते हैं; अपने एप्लिकेशन लॉजिक में आवश्यकतानुसार पार्स करें।
  • ट्रैफ़िक शेयर: TopCountryShares.Value एक अंशीय शेयर है (जैसे, 0.23 = 23%)। UI में प्रतिशत के लिए 100 से गुणा करें।
  • देश मैपिंग: प्रदर्शित नामों को बिना हार्डकोडिंग के रेंडर करने के लिए देशों की सूची के साथ CountryCode (alpha-2) का उपयोग करें।
  • कैशिंग: EstimatedMonthlyVisits और देशों की सूची के लिए अनुशंसित है ताकि विलंबता कम हो और आप अपनी सब्सक्रिप्शन कोटा के भीतर रहें।
  • त्रुटियाँ: उपयोगकर्ता को स्पष्ट संदेश दिखाकर गैर-2xx कोड को संभालें (अमान्य डोमेन, गायब प्रमाणीकरण हेडर, आदि)।

वास्तविक दुनिया के उपयोग के मामले

CRM के अंदर लीड समृद्धि

जब एक नया लीड एक वेबसाइट शामिल करता है, तो ट्रैफ़िक स्रोत और अवलोकन एंडपॉइंट को कॉल करें ताकि TopCountryShares प्राप्त करें और उस लीड के दर्शकों के लिए शीर्ष बाजार प्रदर्शित करें। जुड़ाव से विज़िट और PagePerVisit के साथ संयोजन करें ताकि आउटरीच को प्राथमिकता दी जा सके।

एट्रिब्यूशन डैशबोर्ड

प्रत्येक डोमेन को ट्रैक करने के लिए (जैसे, रेफरल या भागीदार), महीने के अनुसार की गई EstimatedMonthlyVisits को खींचें और कैश करें। TopCountryShares का उपयोग करें ताकि भूगोल द्वारा योगदान को स्टैक्ड बार या कोरोलोथ मानचित्रों में तोड़ा जा सके।

SEO और सामग्री योजना

SERP परिणामों या प्रतियोगी सूचियों को शीर्षक और विवरण के साथ समृद्ध करें ताकि त्वरित अवलोकन प्राप्त हो सके, और सामग्री सुधार के अवसरों को उजागर करने के लिए BounceRate या PagePerVisit को प्रदर्शित करें।

AI एजेंट (MCP) से API को कॉल करना

यदि आप Claude Code, Cursor, Windsurf, या किसी भी MCP-संगत क्लाइंट के माध्यम से स्वचालन कर रहे हैं, तो आप Zyla के MCP गेटवे के माध्यम से कॉल को रूट कर सकते हैं। अपने उपकरण को MCP एंडपॉइंट का उपयोग करने के लिए कॉन्फ़िगर करें और अपनी API कुंजी प्रदान करें:

MCP

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

शिप करने से पहले मान्यता चेकलिस्ट

  • Authorization: Bearer YOUR_API_KEY के साथ प्रमाणित GET अनुरोध।
  • अवलोकन के लिए: डोमेन क्वेरी पैरामीटर शामिल करें, कोई प्रोटोकॉल और कोई www नहीं।
  • JSON पार्स करें और आवश्यकतानुसार स्ट्रिंगिफाइड संख्यात्मक फ़ील्ड को कास्ट करें।
  • TopCountryShares.CountryCode को देशों की सूची के माध्यम से पठनीय नाम में मैप करें।
  • कोटा के भीतर रहने और विलंबता में सुधार करने के लिए देशों की सूची और मासिक अनुमानों को कैश करें।

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

क्या API पूर्ण URLs या केवल डोमेन स्वीकार करता है?
केवल प्रोटोकॉल और "www" के बिना डोमेन (जैसे, example.com) को ट्रैफ़िक स्रोत और अवलोकन एंडपॉइंट पर पास किया जाना चाहिए।

मैं प्रमाणीकरण कैसे करूं?
हर अनुरोध के लिए हेडर में Authorization: Bearer YOUR_API_KEY भेजें।

क्या मैं समर्थित देशों की सूची प्राप्त कर सकता हूँ?
हाँ। समर्थित देशों और ISO कोड प्राप्त करने के लिए देशों की सूची एंडपॉइंट को कॉल करें जिन्हें आप अवलोकन एंडपॉइंट से TopCountryShares को समृद्ध करने के लिए उपयोग कर सकते हैं।

क्या संख्यात्मक फ़ील्ड संख्याएँ हैं या स्ट्रिंग?
Engagments ऑब्जेक्ट में कुछ मैट्रिक्स (जैसे, BounceRate, PagePerVisit, Visits, TimeOnSite) स्ट्रिंग के रूप में लौटाए जाते हैं। यदि आपको उन्हें गणना या स्वरूपित करने की आवश्यकता है, तो उन्हें अपने कोड में संख्याओं में पार्स करें।

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

कार्यान्वयन के लिए तैयार? अपनी कुंजी प्राप्त करें और आज ही ट्रैफ़िक स्रोत और जुड़ाव डेटा खींचना शुरू करें: साइट ट्रैफ़िक API पर 7-दिन का परीक्षण शुरू करें। जब आप अपने एकीकरण का विस्तार करने के लिए तैयार हों, तो Zyla API Hub पर अधिक श्रेणियों का अन्वेषण करें।

आधिकारिक API प्रतिक्रिया

[{"name":"Afghanistan","alpha-2":"AF","alpha-3":"AFG","country-code":"004","iso_3166-2":"ISO 3166-2:AF","region":"Asia","sub-region":"Southern Asia","intermediate-region":"","region-code":"142","sub-region-code":"034","intermediate-region-code":""},{"name":"Åland Islands","alpha-2":"AX","alpha-3":"ALA","country-code":"248","iso_3166-2":"ISO 3166-2:AX","region":"Europe","sub-region":"Northern Europe","intermediate-region":"","region-code":"150","sub-region-code":"154","intermediate-region-code":""},{"name":"Albania","alpha-2":"AL","alpha-3":"ALB","country-code":"008","iso_3166-2":"ISO 3166-2:AL","region":"Europe","sub-region":"Southern Europe","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Algeria","alpha-2":"DZ","alpha-3":"DZA","country-code":"012","iso_3166-2":"ISO 3166-2:DZ","region":"Africa","sub-region":"Northern Africa","intermediate-region":"","region-code":"002","sub-region-code":"015","intermediate-region-code":""},{"name":"American Samoa","alpha-2":"AS","alpha-3":"ASM","country-code":"016","iso_3166-2":"ISO 3166-2:AS","region":"Oceania","sub-region":"Polynesia","intermediate-region":"","region-code":"009","sub-region-code":"061","intermediate-region-code":""},{"name":"Andorra","alpha-2":"AD","alpha-3":"AND","country-code":"020","iso_3166-2":"ISO 3166-2:AD","region":"Europe","sub-region":"Southern Europe","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Angola","alpha-2":"AO","alpha-3":"AGO","country-code":"024","iso_3166-2":"ISO 3166-2:AO","region":"Africa","sub-region":"Sub-Saharan Africa","intermediate-region":"Middle Africa","region-code":"002","sub-region-code":"202","intermediate-region-code":"017"},{"name":"Anguilla","alpha-2":"AI","alpha-3":"AIA","country-code":"660","iso_3166-2":"ISO 3166-2:AI","region":"Americas","sub-region":"Latin America and the Caribbean","intermediate-region":"Caribbean","region-code":"019","sub-region-code":"419","intermediate-region-code":"029"},{"name":"Antarctica","alpha-2":"AQ","alpha-3":"ATA","country-code":"010","iso_3166-2":"ISO 3166-2:AQ","region":"","sub-region":"","intermediate-region":"","region-code":"","sub-region-code":"","intermediate-region-code":""},{"name":"Antigua and Barbuda","alpha-2":"AG","alpha-3":"ATG","country-code":"028","iso_3166-2":"ISO 3166-2:AG","region":"Americas","sub-region":"Latin America and the Caribbean","intermediate-region":"Caribbean","region-code":"019","s…

क्या आप Zyla API HUB का उपयोग करने के लिए तैयार हैं?

अभी आज़माएँ!

संबंधित पोस्ट्स

ऑस्ट्रेलिया रियल्टी एपीआई के साथ काम करना

ऑस्ट्रेलिया रियल्टी एपीआई के साथ काम करना

आपको इस सप्ताह अपने ऐप में ऑस्ट्रेलियाई रियल एस्टेट डेटा की आवश्यकता है: एक क्षेत्र में बेची गई संपत्तियों की खोज करें,...

 FlashScore - लाइव API का उपयोग कैसे करें

FlashScore - लाइव API का उपयोग कैसे करें

आपको इस सप्ताह एक ऐप में लाइव स्पोर्ट्स डेटा को वायर करना है। इस गाइड के अंत तक, आप FlashScore संस्थाओं (टीमों, खिलाड़िय...

 मैच कमेंट्री प्राप्त करने के लिए API

मैच कमेंट्री प्राप्त करने के लिए API

आपको इस सप्ताह अपने खेल ऐप में मैच कमेंट्री और लाइव संदर्भ भेजना है। इस गाइड के अंत तक, आप टीमों और प्रतियोगिताओं को हल...

 बैंक डेटा के लिए API

बैंक डेटा के लिए API

आपको भुगतान जारी करने या नए ग्राहक खातों को खोलने से पहले अमेरिकी बैंक रूटिंग नंबरों को मान्य करने और बैंक विवरण (नाम, प...

 Working with Site Traffic API

Working with Site Traffic API

You need to ship traffic analytics this week: country coverage for reporting, high-level engagement per domain, and a br...

 सोफास्कोर का उपयोग कैसे करें - लाइव एपीआई

सोफास्कोर का उपयोग कैसे करें - लाइव एपीआई

आपको एक खेल एकीकरण भेजने की आवश्यकता है जो: सभी समर्थित खेलों की सूची बना सके, नाम द्वारा टीमों/लीगों/खिलाड़ियों की खोज...

खोजें

संबंधित पोस्ट्स

हाल की पोस्ट्स