API to get user detail

आपको बिना स्क्रैपर बनाए या हेडर को रिवर्स-इंजीनियर किए अपने ऐप में एक TikTok उपयोगकर्ता की प्रोफ़ाइल और अनुयायी आँकड़े खींचने की आवश्यकता है। इस गाइड के अंत तक, आप एक वास्तविक एंडपॉइंट का क्वेरी करेंगे जो उपयोगकर्ता मेटाडेटा (अनुयायी, अनुसरण, प्रोफ़ाइल फ़ील्ड) को उपयोगकर्ता नाम द्वारा लौटाता है, और आप जानेंगे कि इसे उपयोगकर्ता प्रबंधन कार्यप्रवाह जैसे प्रोफ़ाइल डैशबोर्ड और मॉडरेशन कतारों के लिए सामग्री प्राप्त करने के लिए कैसे जोड़ना है।

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

Tiktok Public Media API सार्वजनिक TikTok उपयोगकर्ता डेटा के साथ काम करने के लिए केवल पढ़ने योग्य एंडपॉइंट्स को उजागर करता है। कुंजी उपयोगकर्ता-प्रबंधन क्षमता एक उपयोगकर्ता के विस्तृत प्रोफ़ाइल को उनके उपयोगकर्ता नाम द्वारा पुनः प्राप्त करना है, जिसमें अनुयायी और अनुसरण की गिनती, प्रोफ़ाइल फ़ील्ड, और आईडी शामिल हैं जिन्हें आप बाद की कॉल के लिए उपयोग कर सकते हैं। सामान्य अनुप्रयोगों में शामिल हैं:

अनुयायी प्रवृत्तियों और बुनियादी आँकड़ों को दिखाने वाले उपयोगकर्ता प्रोफ़ाइल पैनल का निर्माण करना।
एक उपयोगकर्ता नाम को देखकर TikTok खाता कनेक्शन की पुष्टि करना और अपेक्षित मेटाडेटा की पुष्टि करना।
उनकी अपरिवर्तनीय पहचानकर्ताओं (जैसे, secUid) को हल करके एक उपयोगकर्ता की सामग्री कार्यप्रवाह को बीज देना ताकि उनके वीडियो प्राप्त किए जा सकें।

सभी एंडपॉइंट्स Zyla API Hub पर Tiktok Public Media API के तहत उपलब्ध हैं, और आप एक खाते, एक API कुंजी, और एक सदस्यता + कोटा मॉडल के साथ Zyla API Hub पर 10,000 से अधिक सार्वजनिक APIs का अन्वेषण कर सकते हैं।

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

Zyla API Hub पर API की लिस्टिंग पृष्ठ खोलें और उपलब्ध होने पर सदस्यता लें या 7-दिन का परीक्षण प्रारंभ करें। पहले API को 7-दिन के परीक्षण या 50 अनुरोधों के साथ आजमाया जा सकता है। कोई मुफ्त योजना नहीं है; वर्तमान पहुँच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जाँच करें। सदस्यता लेने के बाद, आपको एक API कुंजी प्राप्त होगी।

प्रमाणीकरण: अपने कुंजी को हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करके पास करें
बेस कॉलिंग पैटर्न: zylalabs.com पर नीचे दस्तावेज़ीकृत सटीक एंडपॉइंट URLs का उपयोग करें
बिलिंग: सदस्यता + कोटा (प्रति कॉल भुगतान नहीं)

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

1) उपयोगकर्ता विवरण प्राप्त करें

एक TikTok उपयोगकर्ता की विस्तृत प्रोफ़ाइल जानकारी उनके उपयोगकर्ता नाम का उपयोग करके प्राप्त करें। यह अनुयायी की गिनती, अनुसरण की गिनती, और प्रोफ़ाइल विवरण जैसे उपयोगकर्ता मेटाडेटा लौटाता है।

विधि: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail
आवश्यक अनुरोध पैरामीटर:
- username (string): TikTok हैंडल, उदाहरण के लिए: _ttqueen

आधिकारिक cURL उदाहरण (कॉपी/पेस्ट):

curl -s -X GET "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail?username=_ttqueen" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक JSON प्रतिक्रिया:

{
"data": {
"id": "6644110999556227073",
"nickname": "Quynh Truong",
"signature": "Thấy mình đáng iu thì fl mình nhé hehee
💬For work: 097.136.3242",
"hdAvatarUrlList": [
"https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/dcb917fff48aacab462620b08f13b4e0~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=c1870c0f&x-expires=1790154000&x-signature=nO62jhA4bUQvXuz5YAr8WEwl6ns%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a"
],
"uniqueId": "_ttqueen",
"secUid": "MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L",
"isVerified": false,
"statistics": {
"followerCount": 3100000,
"followingCount": 139,
"friendCount": 84,
"heartCount": 117100000,
"videoCount": 559,
"diggCount": 0
}
}
}

आप जिन फ़ील्ड नोट्स का वास्तव में उपयोग करेंगे:

data.id: संख्यात्मक उपयोगकर्ता ID (string)। अपने डेटाबेस में एक स्थिर कुंजी के रूप में उपयोग करें।
data.uniqueId: सार्वजनिक उपयोगकर्ता नाम जिसे आपने देखा।
data.secUid: अन्य एंडपॉइंट्स द्वारा आवश्यक सुरक्षा-स्कोप वाला अद्वितीय पहचानकर्ता (जैसे, उपयोगकर्ता की वीडियो सूची प्राप्त करना)।
data.hdAvatarUrlList: प्रोफ़ाइल प्रदर्शनों के लिए अवतार छवि URLs की सूची।
data.statistics.*: followerCount, followingCount, heartCount, videoCount प्रोफ़ाइल KPI के लिए आवश्यक हैं।
data.isVerified: बैज प्रदर्शनों और मॉडरेशन रूटिंग के लिए बूलियन फ़्लैग।

2) वीडियो सूची प्राप्त करें

एक TikTok उपयोगकर्ता द्वारा पोस्ट किए गए वीडियो की सूची को उनके secUid का उपयोग करके प्राप्त करें। वीडियो मेटाडेटा लौटाता है जिसमें आईडी, विवरण, और आँकड़े शामिल हैं।

विधि: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list
आवश्यक अनुरोध पैरामीटर:
- secUid (string): Get User Detail (data.secUid) से लौटाए गए सटीक मान का उपयोग करें

नोट्स:

प्रतिक्रिया में एक data.awemeList ऐरे शामिल है। प्रत्येक आइटम में id, url, description, createdAt (UNIX टाइमस्टैम्प, सेकंड), contentType, और लेखक विवरण जैसे फ़ील्ड होते हैं।
सामग्री को कालानुक्रमिक रूप से क्रमबद्ध करने के लिए createdAt का उपयोग करें। टाइमस्टैम्प पूर्णांक हैं जो UNIX युग से सेकंड का प्रतिनिधित्व करते हैं; अपने UI में अपने स्थानीय समय क्षेत्र में परिवर्तित करें।

3) वीडियो या फोटो विवरण प्राप्त करें

ID या URL द्वारा TikTok वीडियो विवरण प्राप्त करें, जिसमें विवरण, आँकड़े, लेखक जानकारी, और मीडिया URLs शामिल हैं।

विधि: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details
आवश्यक अनुरोध पैरामीटर:
- idOrUrl (string): एक TikTok वीडियो URL या ID पास करें

नोट्स:

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

उपयोगकर्ता प्रबंधन डैशबोर्ड के लिए एंड-टू-एंड प्रवाह

Get User Detail का उपयोग करके उपयोगकर्ता को उपयोगकर्ता नाम द्वारा हल करें।
अपने उपयोगकर्ता रिकॉर्ड के लिए आँकड़ों के साथ पहचानकर्ताओं (id, uniqueId, secUid) को स्टोर करें।
जब आवश्यक हो, तो लौटाए गए secUid के साथ Get video list का उपयोग करके उनकी सामग्री प्राप्त करें।
चुने गए पोस्ट के लिए, विवरण दृश्य को रेंडर करने के लिए इसके URL या ID के साथ Get Video Or Photo Details को कॉल करें।

यह दर्शाता है कि अधिकांश उत्पादन डैशबोर्ड कैसे एक कैनोनिकल उपयोगकर्ता रिकॉर्ड को id और secUid द्वारा की गई कुंजी के रूप में रखते हैं, जबकि सामग्री को मांग पर लाने के लिए आँकड़ों को समय-समय पर ताज़ा करते हैं ताकि विलंबता और लागत को नियंत्रित किया जा सके।

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

प्रमाणीकरण: प्रत्येक अनुरोध में Authorization: Bearer YOUR_API_KEY शामिल होना चाहिए।
टाइमस्टैम्प: सामग्री एंडपॉइंट्स द्वारा लौटाए गए createdAt फ़ील्ड UNIX युग के सेकंड (UTC) हैं। अपने उत्पाद की समय क्षेत्र नीति के अनुसार परिवर्तित करें।
कैशिंग: यदि आप कई प्रोफाइल के लिए अनुयायी की गिनती को पोल करते हैं तो Get User Detail प्रतिक्रियाओं को कैश करें (जैसे, 5–15 मिनट)। यह डुप्लिकेट अनुरोधों को कम करता है और UI लोड को सुचारू करता है।
पहचानकर्ता: सामग्री प्राप्त करने के लिए secUid आवश्यक है। बाद में एक अतिरिक्त कॉल से बचने के लिए इसे अपने पहले लुकअप के तुरंत बाद बनाए रखें।
कोटा: पहुँच सदस्यता + कोटा है। पहले API को 7-दिन के परीक्षण या 50 अनुरोधों के साथ आजमाया जा सकता है। अपने Zyla डैशबोर्ड में उपयोग की निगरानी करें।

Python उदाहरण: एक उपयोगकर्ता को हल करें और प्रोफ़ाइल आँकड़े प्रदर्शित करें

यह नमूना Get User Detail को कॉल करता है, मुख्य उपयोगकर्ता-प्रबंधन फ़ील्ड को निकालता है, और एक संक्षिप्त प्रोफ़ाइल सारांश प्रिंट करता है। YOUR_API_KEY को अपनी कुंजी से बदलें।

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
USERNAME = "_ttqueen"

url = "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail"
params = {"username": USERNAME}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json().get("data", {})

user_id = data.get("id")
unique_id = data.get("uniqueId")
sec_uid = data.get("secUid")
nickname = data.get("nickname")
avatar_urls = data.get("hdAvatarUrlList", [])
stats = data.get("statistics", {}) or {}

summary = {
"id": user_id,
"username": unique_id,
"nickname": nickname,
"followers": stats.get("followerCount"),
"following": stats.get("followingCount"),
"videos": stats.get("videoCount"),
"hearts": stats.get("heartCount"),
"verified": data.get("isVerified"),
"secUid": sec_uid,
"avatar": avatar_urls[0] if avatar_urls else None
}

print(summary)

यहां से, आप डाउनस्ट्रीम सामग्री कॉल के लिए id और secUid को बनाए रख सकते हैं, और अपने UI के प्रोफ़ाइल हेडर में summary["avatar"] प्रदर्शित कर सकते हैं।

त्रुटि हैंडलिंग और संचालन टिप्स

पुनः प्रयास बजट: नेटवर्क में रुकावट होती है। idempotent GETs के लिए छोटे पुनः प्रयास नीति का उपयोग करें (जैसे, 2–3 पुनः प्रयास)।
इनपुट मान्यता: केवल दस्तावेज़ीकृत पैरामीटर पास करें। उपयोगकर्ता लुकअप के लिए, सुनिश्चित करें कि उपयोगकर्ता नाम स्ट्रिंग उस अपेक्षित TikTok हैंडल प्रारूप से मेल खाती है जिसे आप उपयोगकर्ताओं से एकत्र करते हैं।
आंशिक डेटा: hdAvatarUrlList जैसी ऐरे खाली हो सकती हैं; नमूने में दिखाए गए अनुसार गायब फ़ील्ड के लिए गार्ड करें।
शेड्यूलिंग: यदि आप समय-समय पर अनुयायी आँकड़े ताज़ा करते हैं, तो स्पाइक्स से बचने और कोटा के भीतर रहने के लिए अनुरोधों को क्रमबद्ध करें।

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

पहचान समाधान: जब एक उपयोगकर्ता आपके उत्पाद में अपना TikTok कनेक्ट करता है, तो स्वामित्व की पुष्टि करने के लिए उपयोगकर्ता नाम द्वारा Get User Detail को कॉल करें (पुष्टि के लिए उपनाम, अवतार, अनुयायी की गिनती प्रदर्शित करें)।
व्यवस्थापक प्रोफ़ाइल: आंतरिक पृष्ठ बनाएं जो उपयोगकर्ता पहचान (id, uniqueId, nickname), एक सत्यापन बैज, और त्वरित समीक्षाओं के लिए सारांश आँकड़े (अनुयायी, दिल, वीडियो) दिखाते हैं।
वृद्धि स्नैपशॉट: समय के साथ followerCount और videoCount परिवर्तनों को ट्रैक करने के लिए आँकड़ों से दैनिक संचित डेटा बनाए रखें।
मॉडरेशन कतारें: Get video list को Get User Detail से secUid के साथ मिलाकर हाल की सामग्री को समीक्षा कतार में पूर्व-प्राप्त करें।

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

यदि आप MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf) के साथ कार्यों का आयोजन करते हैं, तो आप MCP एंडपॉइंट के माध्यम से Zyla APIs को कॉल कर सकते हैं। वही Authorization हेडर लागू होता है; आपका क्लाइंट उपकरण को सक्रिय करता है।

MCP एंडपॉइंट: MCP (जब आपके उपकरण को इसकी आवश्यकता हो तो अपने apikey को क्वेरी पैरामीटर के रूप में जोड़ें: apikey=YOUR_API_KEY)
उपकरणों के लिए ऊपर दिखाए गए सटीक हब URLs का उपयोग करें जो सीधे HTTP कॉल स्वीकार करते हैं, Authorization हेडर सेट के साथ।

यह एक एजेंट को उपयोगकर्ता विवरण को उपयोगकर्ता नाम द्वारा प्राप्त करने, secUid को पार्स करने, फिर वीडियो प्राप्त करने की अनुमति देता है, सभी कोडिंग सत्र या स्वचालन के भीतर आपके संपादक को छोड़े बिना।

एकीकरण चेकलिस्ट

Zyla पर सदस्यता लें और अपनी API कुंजी प्राप्त करें।
उपयोगकर्ता नाम द्वारा Get User Detail को लागू करें; id और secUid को बनाए रखें।
प्रोफ़ाइल रेंडर करें: उपनाम, अवतार (hdAvatarUrlList में पहला आइटम), isVerified बैज, आँकड़े।
जब आवश्यक हो, तो secUid का उपयोग करके उपयोगकर्ता के वीडियो प्राप्त करने के लिए एक कार्य या मांग पर कॉल जोड़ें।
प्रोफ़ाइल आँकड़ों के लिए अनुरोधों को पुनः प्रयास और न्यूनतम कैशिंग (जैसे, 5–15 मिनट) के साथ लपेटें।
अपने Zyla डैशबोर्ड में कोटा की निगरानी करें और तदनुसार पोलिंग आवृत्ति को समायोजित करें।

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

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

प्रश्न: मैं उपयोगकर्ता नाम द्वारा उन्हें देखने के बाद एक उपयोगकर्ता के वीडियो कैसे प्राप्त करूं?
उत्तर: डेटा.secUid प्राप्त करने के लिए Get User Detail को कॉल करें, फिर उस secUid को Get video list एंडपॉइंट पर पास करें।

प्रश्न: createdAt टाइमस्टैम्प किस समय क्षेत्र में हैं?
उत्तर: createdAt मान UNIX युग के सेकंड (UTC) हैं। अपने UI में अपनी इच्छित समय क्षेत्र में परिवर्तित करें।

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

प्रश्न: क्या मैं इसे AI कोडिंग एजेंट में उपयोग कर सकता हूँ?
उत्तर: हाँ। अपनी API कुंजी के साथ Zyla MCP एंडपॉइंट के माध्यम से वही हब एंडपॉइंट्स कॉल करें; MCP-संगत क्लाइंट सीधे उपकरणों को सक्रिय कर सकते हैं।

क्या आप इसे अपने ऐप में जोड़ने के लिए तैयार हैं? आधिकारिक लिस्टिंग के साथ शुरू करें, अपनी कुंजी प्राप्त करें, और अभी अपना पहला अनुरोध करें: Tiktok Public Media API पर 7-दिन का परीक्षण प्रारंभ करें। कभी भी Zyla API Hub पर अधिक APIs का अन्वेषण करें।