आपको एक TikTok उपयोगकर्ता की प्रोफ़ाइल और अनुयायी आँकड़े प्रोग्रामेटिक रूप से उपयोगकर्ता नाम द्वारा प्राप्त करने की आवश्यकता है, और आपको यह इस सप्ताह काम करने की आवश्यकता है। इस गाइड के अंत तक, आप एकल HTTP GET का उपयोग करके उपयोगकर्ता विवरण (ID, उपनाम, सत्यापन, अनुयायी संख्या, और अधिक) प्राप्त करेंगे, और आप जानेंगे कि इसे वीडियो पुनर्प्राप्ति और आइटम विवरण खोजों में कैसे जोड़ना है।
इस API की आवश्यकता और यह क्या लौटाता है
Zyla API Hub पर Tiktok Public Media API केवल पढ़ने के लिए एंडपॉइंट्स को सार्वजनिक TikTok डेटा खींचने के लिए उजागर करता है। इसके साथ, आप कर सकते हैं:
- एक TikTok उपयोगकर्ता नाम को एक पूर्ण प्रोफ़ाइल (ID, secUid, उपनाम, अवतार URL, सत्यापन स्थिति, और अनुयायी आँकड़े) में हल करें।
- उनके secUid के माध्यम से एक उपयोगकर्ता द्वारा पोस्ट किए गए वीडियो प्राप्त करें।
- URL या ID द्वारा एक विशिष्ट TikTok वीडियो या फोटो के लिए विस्तृत जानकारी प्राप्त करें।
यह सामाजिक डैशबोर्ड, CRM समृद्धि, निर्माता विश्लेषण, सामग्री निगरानी, और सर्वर-साइड स्वचालन के लिए उपयोगी है जिन्हें सार्वजनिक TikTok मेटाडेटा तक पुनरुत्पादनीय पहुँच की आवश्यकता होती है।
Zyla API Hub हजारों APIs को एक कुंजी और एक सदस्यता मॉडल के तहत केंद्रीकृत करता है। आप zylalabs.com पर 10,000 से अधिक सार्वजनिक APIs का अन्वेषण कर सकते हैं और कई विक्रेताओं का प्रबंधन किए बिना सदस्यता ले सकते हैं।
Zyla API Hub पर शुरुआत करना
इन एंडपॉइंट्स का प्रयास करने के लिए, Tiktok Public Media API लिस्टिंग खोलें और एक परीक्षण शुरू करें। आपको प्राधिकरण हेडर में रखने के लिए एक API कुंजी प्राप्त होगी।
- लिस्टिंग पर जाएं: Tiktok Public Media API पर 7-दिन का परीक्षण शुरू करें.
- अपनी कुंजी प्राप्त करने के लिए सदस्यता लें या मुफ्त परीक्षण शुरू करें (जब उपलब्ध हो)।
- हर अनुरोध पर Authorization: Bearer YOUR_API_KEY का उपयोग करें।
बिलिंग सदस्यता + कोटा है (प्रति कॉल भुगतान नहीं)। वर्तमान पहुँच विकल्पों और मूल्य निर्धारण के लिए, हमेशा API पृष्ठ की जाँच करें। आप उसी खाते और कुंजी के साथ Zyla API Hub पर अन्य श्रेणियों को भी ब्राउज़ कर सकते हैं।
आप जिन एंडपॉइंट्स का उपयोग करेंगे
1) उपयोगकर्ता विवरण प्राप्त करें - एक उपयोगकर्ता नाम को प्रोफ़ाइल और आँकड़ों में हल करें
विधि: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail
विवरण: उपयोगकर्ता नाम का उपयोग करके एक TikTok उपयोगकर्ता की विस्तृत प्रोफ़ाइल जानकारी प्राप्त करें। अनुयायी संख्या, अनुसरण संख्या, और प्रोफ़ाइल विवरण जैसे उपयोगकर्ता मेटाडेटा लौटाता है।
आवश्यक पैरामीटर: username (string)
उपयोगकर्ता नाम = _ttqueen के साथ उदाहरण:
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"
आधिकारिक प्रतिक्रिया नमूना:
{
"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 जिसे आप एक स्थिर कुंजी के रूप में संग्रहीत कर सकते हैं।data.uniqueIdऔरdata.nickname: UI के लिए हैंडल और प्रदर्शन नाम।data.hdAvatarUrlList: उच्च गुणवत्ता वाले अवतार URL।data.isVerified: सत्यापन संकेतक।data.statistics: KPI के लिए अनुयायी/अनुसरण/दिल/वीडियो की संख्या।data.secUid: अगले एंडपॉइंट के साथ एक उपयोगकर्ता के वीडियो को पुनर्प्राप्त करने के लिए आवश्यक।
2) वीडियो सूची प्राप्त करें - secUid द्वारा वीडियो सूची
विधि: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list
विवरण: एक TikTok उपयोगकर्ता द्वारा पोस्ट किए गए वीडियो की सूची प्राप्त करें उनके secUid का उपयोग करके। IDs, विवरण, और आँकड़े सहित वीडियो मेटाडेटा लौटाता है।
आवश्यक पैरामीटर: secUid (string)
आप secUid को Get User Detail प्रतिक्रिया से प्राप्त करते हैं। इसे इस एंडपॉइंट पर आपूर्ति करें ताकि निर्माता की पोस्टों की गणना की जा सके।
उदाहरण अनुरोध URL आकार (प्राधिकरण हेडर को न भूलें):
https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list?secUid=MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L
3) वीडियो या फोटो विवरण प्राप्त करें - एक विशिष्ट पोस्ट का निरीक्षण करें
विधि: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details
विवरण: ID या URL द्वारा TikTok वीडियो विवरण प्राप्त करें जिसमें विवरण आँकड़े लेखक जानकारी और मीडिया URL शामिल हैं।
आवश्यक पैरामीटर: idOrUrl (string)
एक TikTok आइटम URL या उसका ID प्रदान करें ताकि उस एकल पोस्ट के लिए विस्तृत मेटाडेटा प्राप्त किया जा सके। उदाहरण पैरामीटर मान:
https://www.tiktok.com/@khaby.lame/video/7661681676719869214?lang=en
कार्यप्रवाह: उपयोगकर्ता नाम से उपयोगकर्ता विवरण (और उससे आगे)
- लक्ष्य उपयोगकर्ता नाम के साथ Get User Detail कॉल करें:
- उपयोगकर्ता पहचान और अवतार: अपने प्रोफ़ाइल पृष्ठ या CRM रिकॉर्ड पर प्रदर्शित करें।
- अनुयायी और वीडियो की संख्या: मैट्रिक्स और स्वास्थ्य संकेतकों को भरें।
- secUid: इसे संग्रहीत करें; आपको वीडियो सूची बनाने के लिए इसकी आवश्यकता होगी।
- वैकल्पिक रूप से, हाल की सामग्री के लिए फ़ीड या विश्लेषण के लिए लौटाए गए secUid के साथ Get video list कॉल करें।
- वैकल्पिक रूप से, गहरे गोताखोरों के लिए चयनित वीडियो URL या ID के साथ Get Video Or Photo Details कॉल करें (जैसे, क्लिक पर प्रति-पोस्ट विवरण दिखाएं)।
त्वरित पायथन उदाहरण: उपयोगकर्ता विवरण प्राप्त करें और मुख्य फ़ील्ड पढ़ें
यह उदाहरण Get User Detail को कॉल करता है, प्रोफ़ाइल की मूल जानकारी और अनुयायी आँकड़े निकालता है, और दिखाता है कि यदि आप बाद में वीडियो प्राप्त करने की योजना बनाते हैं तो secUid को कैसे बनाए रखना है।
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BASE_USER_DETAIL = "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail"
def get_user_detail(username: str) -> dict:
url = f"{BASE_USER_DETAIL}?username={username}"
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, timeout=30)
resp.raise_for_status()
return resp.json()
if __name__ == "__main__":
username = "_ttqueen"
data = get_user_detail(username)
user = data.get("data", {})
stats = user.get("statistics", {})
print("User ID:", user.get("id"))
print("Unique ID:", user.get("uniqueId"))
print("Nickname:", user.get("nickname"))
print("Verified:", user.get("isVerified"))
print("Avatar URL:", (user.get("hdAvatarUrlList") or [None])[0])
print("Followers:", stats.get("followerCount"))
print("Following:", stats.get("followingCount"))
print("Hearts:", stats.get("heartCount"))
print("Video Count:", stats.get("videoCount"))
print("secUid (for video list):", user.get("secUid"))
नोट्स:
- प्राधिकरण एक Bearer हेडर है जिसमें आपकी कुंजी API लिस्टिंग से है।
- KeyError से बचने के लिए अनुक्रमण करने से पहले हमेशा गायब फ़ील्ड की जाँच करें।
idयाuniqueIdको अपने स्थानीय विदेशी कुंजी के रूप में बनाए रखें, और यदि आप बाद में वीडियो प्राप्त करने वाले हैं तोsecUidको बनाए रखें।
व्यावहारिक विवरण जो समय बचाते हैं
- प्रमाणीकरण: सभी एंडपॉइंट्स को प्राधिकरण हेडर की आवश्यकता होती है ठीक उसी तरह जैसे Authorization: Bearer YOUR_API_KEY।
- डेटा ताजगी: अनुयायी और दिल की गिनती को समय-समय पर मानों के रूप में मानें। यदि आप कैश करते हैं, तो अपने उत्पाद की आवश्यकताओं के आधार पर अपने ताज़ा चक्र का निर्णय लें।
- टाइमस्टैम्प: जब वीडियो प्राप्त करते हैं, तो आप संख्यात्मक
createdAtमान देखेंगे। उन्हें अपने अनुप्रयोग में अपनी इच्छित समय क्षेत्र और प्रारूप में सामान्यीकृत करें। - पहचानकर्ता: लचीलापन के लिए
idऔरuniqueIdदोनों को संग्रहीत करें;secUidएक उपयोगकर्ता के वीडियो को सूचीबद्ध करने के लिए आवश्यक है। - त्रुटि प्रबंधन: लॉजिक को शाखाबद्ध करने के लिए HTTP स्थिति कोड और फ़ील्ड की उपस्थिति/अनुपस्थिति का उपयोग करें। पुनः प्रयासों के लिए अनुरोध URL और उपयोगकर्ता नाम लॉग करें।
- कोटा: API एक सदस्यता + कोटा मॉडल का उपयोग करता है। अपने वर्तमान सीमाओं और उपलब्ध 7-दिन के परीक्षण के लिए लिस्टिंग की जाँच करें।
उपयोग के मामले जिन्हें आप इस सप्ताह शिप कर सकते हैं
- निर्माता लुकअप विजेट: एक उपयोगकर्ता नाम टाइप करें, तुरंत अवतार, सत्यापन बैज, और अनुयायी संख्या दिखाएँ।
- CRM समृद्धि: TikTok IDs और अनुयायी आँकड़े प्रभावशाली रिकॉर्ड के बगल में संग्रहीत करें।
- मॉडरेशन/क्यूरेशन उपकरण: एक हैंडल को हल करें, फिर उनकी वीडियो प्राप्त करें ताकि समीक्षा कतारें या हाइलाइट रीलें बनाई जा सकें।
- रिपोर्टिंग नौकरियाँ: रात की गतिविधियाँ जो अनुयायी, दिल, और वीडियो की गिनती को ताज़ा करती हैं ताकि विश्लेषणात्मक डैशबोर्ड को शक्ति मिल सके।
AI एजेंटों द्वारा इस API को MCP के माध्यम से कॉल करना
यदि आप कोड सहायक या एजेंटिक IDE के साथ स्वचालित करते हैं, तो आप MCP एंडपॉइंट के माध्यम से किसी भी Zyla API को कॉल कर सकते हैं। अपने MCP-संगत क्लाइंट को इस पर इंगित करने के लिए कॉन्फ़िगर करें:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
यह Tiktok Public Media API को क्लॉड कोड, कर्सर, विंडसर्फ, और अन्य जैसे क्लाइंट से एक उपकरण के रूप में कॉल करने योग्य बनाता है। अधिक जानकारी के लिए, MCP पृष्ठ देखें।
अन्य एंडपॉइंट्स को जोड़ना (वैकल्पिक पैटर्न)
प्रोफ़ाइल को हल करने के बाद एक उपयोगकर्ता के वीडियो प्राप्त करें
एक बार जब आप Get User Detail से secUid पढ़ लेते हैं, तो इसे भेजें:
GET https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list?secUid=MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L
इसे "हाल के अपलोड" टैब को भरने या आइटम के बीच विश्लेषण चलाने के लिए उपयोग करें।
विशिष्ट आइटम के लिए विवरण प्राप्त करें
जब एक उपयोगकर्ता आपके UI में एक वीडियो पर क्लिक करता है, तो TikTok URL या ID को पास करके गहरे विवरण प्राप्त करें:
GET https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details?idOrUrl=https%3A%2F%2Fwww.tiktok.com%2F%40khaby.lame%2Fvideo%2F7661681676719869214%3Flang%3Den
यह आइटम-स्तरीय पृष्ठों, पूर्वावलोकनों, और सर्वर-साइड लिंक अनफर्ल के लिए उपयोगी है।
एक मिनट का सत्यापन चेकलिस्ट
- प्राधिकरण हेडर मौजूद है और सही प्रारूपित है।
- उपयोगकर्ता नाम स्ट्रिंग आवश्यकतानुसार URL-कोडित है।
- आगामी संचालन के लिए उपयोगकर्ता प्रोफ़ाइल से
id,uniqueId, औरsecUidसंग्रहीत करें। - खाली एरे जैसे
hdAvatarUrlListको सुचारू रूप से संभालें। - पुनरुत्पादनीय बग रिपोर्ट के लिए अनुरोध URL लॉग करें।
अक्सर पूछे जाने वाले प्रश्न
मैं अपनी अनुरोधों को कैसे प्रमाणित करूँ?
हर कॉल पर Authorization: Bearer YOUR_API_KEY शामिल करें। सदस्यता लेने या परीक्षण शुरू करने के बाद API लिस्टिंग से अपनी कुंजी प्राप्त करें।
वीडियो सूची एंडपॉइंट के लिए आवश्यक secUid मुझे कहाँ मिलेगा?
उपयोगकर्ता नाम के साथ Get User Detail कॉल करें; प्रतिक्रिया में data.secUid शामिल है। उस मान का उपयोग Get video list के साथ करें।
क्या मैं विवरण प्राप्त करने के लिए सीधे TikTok वीडियो URL पास कर सकता हूँ?
हाँ। Get Video Or Photo Details का उपयोग करें और idOrUrl पैरामीटर को TikTok URL या आइटम ID पर सेट करें।
मूल्य निर्धारण और कोटा क्या हैं?
पहुँच सदस्यता + कोटा है (प्रति कॉल भुगतान नहीं)। वर्तमान पहुँच विकल्पों के लिए API पृष्ठ की जाँच करें। लिस्टिंग पर 7-दिन का परीक्षण उपलब्ध है।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। मूल्यांकन के लिए लिस्टिंग पर 7-दिन का परीक्षण करें, फिर अपनी उपयोगिता के अनुसार एक सदस्यता चुनें।
क्या आप अपने उपयोगकर्ता विवरण एकीकरण को शिप करने के लिए तैयार हैं? अपनी कुंजी प्राप्त करें और यहाँ आधिकारिक एंडपॉइंट्स के साथ परीक्षण शुरू करें: Tiktok Public Media API पर 7-दिन का परीक्षण शुरू करें. एक खाता और एक कुंजी Zyla API Hub पर हजारों APIs में काम करते हैं।