आपको उपयोगकर्ता प्रबंधन प्रवाह को शक्ति देने के लिए TikTok उपयोगकर्ता विवरण को प्रोग्रामेटिक रूप से प्राप्त करने की आवश्यकता है—ऑनबोर्डिंग के दौरान खातों की पुष्टि करना, प्रोफाइल को समृद्ध करना, या संग्रहीत रिकॉर्ड को लाइव डेटा के साथ सामंजस्य करना। इस गाइड के अंत तक, आप एक वास्तविक "Get User Info" एंडपॉइंट को कॉल करने में सक्षम होंगे, इसके उत्तर को संभालेंगे, और इसे एक उत्पादन कार्यप्रवाह में वायर करेंगे, जिसमें कार्यशील कर्ल और पायथन उदाहरण शामिल हैं जिन्हें आप आज अपने कोडबेस में पेस्ट कर सकते हैं।
यह API क्या करती है और यह उपयोगकर्ता प्रबंधन में कैसे मदद करती है
Zyla API Hub पर TikTok डेटा API दो केवल पढ़ने योग्य एंडपॉइंट्स को उजागर करता है जिन्हें आप एकल API कुंजी के साथ कॉल कर सकते हैं:
- Get User Info: एक TikTok उपयोगकर्ता के बारे में जानकारी लौटाता है
user_idद्वारा। यह उपयोगकर्ता सत्यापन और समन्वय कार्यों के लिए मुख्य निर्माण खंड है। - Get Video Info:
urlद्वारा वीडियो-स्तरीय मेटाडेटा लौटाता है। यह तब उपयोगी होता है जब आपके उपयोगकर्ता प्रबंधन प्रवाह को उपयोगकर्ताओं को उनके साझा सामग्री के साथ जोड़ने या यह मान्य करने की आवश्यकता होती है कि एक प्रस्तुत वीडियो URL मान्य है और इच्छित खाते से संबंधित है।
विशिष्ट उपयोगकर्ता प्रबंधन उपयोग के मामले शामिल हैं:
- साइनअप के दौरान प्रदान किए गए TikTok
user_idकी पुष्टि करना या एक मौजूदा प्रोफाइल को ग्राहक खाते से लिंक करना। - अपने उपयोगकर्ता तालिका को कैनोनिकल आईडी के साथ समृद्ध करना जिन्हें आप डाउनस्ट्रीम सिस्टम में विश्वसनीय रूप से की कर सकते हैं।
- एक वीडियो URL की समीक्षा करना जो एक उपयोगकर्ता ने प्रदान किया है और इसे उनके खाते के साथ सहसंबंधित करना, इससे पहले कि गेटेड सुविधाओं तक पहुंच प्रदान की जाए।
आप दोनों एंडपॉइंट्स को एकल मार्केटप्लेस खाते और API कुंजी से एक्सेस करते हैं, जिसमें सदस्यता आधारित बिलिंग और कोटा होता है। यहां पहला API 7-दिन का परीक्षण (या 50 अनुरोध) प्रदान करता है। कोई मुफ्त योजना नहीं है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
Zyla API Hub पर शुरू करना
Zyla API Hub पर TikTok डेटा API लिस्टिंग खोलें, उपलब्ध होने पर सब्सक्राइब या स्टार्ट फ्री ट्रायल पर क्लिक करें, और अपनी API कुंजी कॉपी करें। सभी अनुरोधों में प्रमाणीकरण के लिए एकल हेडर शामिल होता है:
- Header:
Authorization: Bearer YOUR_API_KEY
यहां अपना परीक्षण शुरू करें: Start 7-day trial on TikTok Data API. आप मिनटों में उत्पादन-ग्रेड एंडपॉइंट्स को कॉल करेंगे।
एंडपॉइंट संदर्भ
Get User Info
इस एंडपॉइंट का उपयोग करें जब आपके पास एक TikTok user_id हो और आपको उस उपयोगकर्ता की जानकारी प्राप्त करने की आवश्यकता हो। यह उपयोगकर्ता सत्यापन और समन्वय के लिए केंद्र बिंदु है।
- Method: GET
- URL: https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info
- Required parameter:
user_id(string): TikTok उपयोगकर्ता ID। उदाहरण:107955
आधिकारिक कर्ल उदाहरण:
curl -s -X GET "https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info?user_id=107955" \
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक उदाहरण प्रतिक्रिया:
{
"code": -1,
"msg": "userinfo is failed! Please check unique_id or user_id.",
"processed_time": 0.1441
}
आप वास्तव में उपयोग करेंगे ऐसे क्षेत्र नोट्स:
code: पूर्णांक परिणाम संकेतक। यहां एक नकारात्मक मान संकेत करता है कि अनुरोध ने प्रदान किए गए पहचानकर्ता के लिए उपयोगकर्ता डेटा नहीं लौटाया।msg: त्रुटि हैंडलिंग में सहायता के लिए निदान संदेश (जैसे, अमान्य या गैर-मौजूद ID)।processed_time: सेकंड में प्रसंस्करण समय (फ्लोट)। अवलोकनशीलता और बजट पुनः प्रयासों के लिए उपयोगी।
उत्पादन टिप: अपने सत्यापन प्रयास के साथ msg को संग्रहीत करें ताकि आपकी सहायता टीम उपयोगकर्ता ऑनबोर्डिंग मुद्दों की समीक्षा करते समय एक गलत ID को न मिलने की स्थिति से अलग कर सके।
Get Video Info
इस एंडपॉइंट का उपयोग करें जब आपको एक उपयोगकर्ता की प्रस्तुतियों को मान्य या समृद्ध करने की आवश्यकता हो जिसमें एक TikTok वीडियो URL शामिल है। यह सामान्य है जब उपयोगकर्ता स्वामित्व या पात्रता साबित करने के लिए सामग्री को लिंक करते हैं।
- Method: GET
- URL: https://zylalabs.com/api/2516/tiktok-data-api/2504/get-video-info
- Required parameter:
url(string): एक TikTok वीडियो URL विशेष प्रारूप में दिखाया गया।
नोट: वीडियो URL निम्नलिखित प्रारूप में होना चाहिए https://www.tiktok.com/@khaby.lame/video/7411964588809342241. आधिकारिक कर्ल उदाहरण:
लौटाए गए क्षेत्रों का उपयोग करें यह पुष्टि करने के लिए कि वीडियो मौजूद है और पहचानकर्ताओं को निकालने के लिए जो आपको अपने सिस्टम में उपयोगकर्ता प्रोफाइल के साथ सामग्री को सहसंबंधित करने में मदद करते हैं। यदि आप इस URL के साथ एक उपयोगकर्ता का TikTok हैंडल एकत्र करते हैं, तो आप कार्रवाई की अनुमति देने से पहले दोनों की क्रॉस-चेक कर सकते हैं जैसे कि एक निर्माता कार्यक्रम में शामिल होना या उन्नत सुविधाओं को अनलॉक करना।
Python में कार्यशील उदाहरण
नीचे दिया गया स्निपेट Get User Info को प्रलेखित पैरामीटर और प्रमाणीकरण योजना के साथ कॉल करता है, फिर यह code पर शाखा करता है यह निर्धारित करने के लिए कि क्या TikTok खाते को आपके आंतरिक उपयोगकर्ता रिकॉर्ड से संलग्न करना है या समीक्षा के लिए इसे चिह्नित करना है।
import requests
API_KEY = "YOUR_API_KEY"
USER_ID = "107955" # वह user_id प्रदान करें जो आपने अपने उपयोगकर्ता प्रवाह के दौरान एकत्र किया था
url = "https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info"
params = {"user_id": USER_ID}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# उपयोगकर्ता प्रबंधन प्रवाह के लिए न्यूनतम शाखा तर्क
if isinstance(data, dict) and data.get("code") == 0:
# उदाहरण: अपने उपयोगकर्ता तालिका में सत्यापित TikTok लिंक को बनाए रखें
# save_user_tiktok_link(internal_user_id, USER_ID, data)
print("उपयोगकर्ता जानकारी प्राप्त की गई और संग्रहीत की गई।")
else:
# निदान लॉग करें और अपनी सहायता या जोखिम प्रणाली को सूचित करें
print(f"उपयोगकर्ता सत्यापन {USER_ID} के लिए विफल।")
print(f"code={data.get('code')} msg={data.get('msg')} processed_time={data.get('processed_time')}")
नोट्स:
- समय समाप्त: अपने वातावरण के लिए उपयुक्त एक सेट करें; 20 सेकंड ऊपर एक उदाहरण है।
- पुनः प्रयास: केवल नेटवर्क-स्तरीय समय समाप्ति या 5xx पर idempotent GETs को पुनः प्रयास करें, JSON में एप्लिकेशन-स्तरीय त्रुटि कोड पर नहीं।
- अवलोकनशीलता: अपने लॉग संदर्भ के साथ
processed_timeको संग्रहीत करें ताकि समय के साथ धीमी गति को ट्रैक किया जा सके।
इन एंडपॉइंट्स के चारों ओर उपयोगकर्ता प्रबंधन प्रवाह डिजाइन करना
नीचे न्यूनतम लेकिन प्रभावी पैटर्न हैं जिन्हें आप सीधे अपनी सेवा परत और कतारों में अनुकूलित कर सकते हैं।
- TikTok ID के साथ साइनअप:
- अपने फॉर्म में
user_idएकत्र करें और इसे एक लंबित स्थिति में संग्रहीत करें। - तुरंत Get User Info को कॉल करें; यदि
codeसफलता का संकेत देता है, तो लिंक को सत्यापित के रूप में चिह्नित करें और अपने प्रवाह को जारी रखें। - यदि प्रतिक्रिया विफलता का संकेत देती है, तो
msgके आधार पर उपयोगकर्ता को एक सटीक इनलाइन त्रुटि लौटाएं, और यदि आवश्यक हो तो एक समर्थन ऑडिट को कतारबद्ध करें।
- अपने फॉर्म में
- एक TikTok वीडियो को उपयोगकर्ता प्रोफाइल से लिंक करना:
- उपयोगकर्ता से प्रलेखित प्रारूप में एक वीडियो
urlएकत्र करें। - Get Video Info को कॉल करें और पुष्टि करें कि वीडियो हल होता है। यदि आपके पास उपयोगकर्ता का TikTok
user_idभी है, तो अतिरिक्त आश्वासन के लिए वीडियो मेटाडेटा से पहचानकर्ताओं को सहसंबंधित करें इससे पहले कि आप इसे बनाए रखें।
- उपयोगकर्ता से प्रलेखित प्रारूप में एक वीडियो
- नियमित पुनः समन्वय:
- संग्रहीत
user_idमानों को फिर से मान्य करने के लिए एक कार्य निर्धारित करें, अपने कोटा के आधार पर खातों के नमूने या पूर्ण सेट के लिए Get User Info का उपयोग करें। - परिवर्तनों को रिकॉर्ड करें और यदि पहले से मान्य लिंक विफल होने लगे तो उत्पाद संचालन को सूचित करें।
- संग्रहीत
समय बचाने वाले संचालन टिप्स
- प्रमाणीकरण: हमेशा
Authorization: Bearer YOUR_API_KEYभेजें। अतिरिक्त हेडर न जोड़ें या स्पष्ट रूप से प्रलेखित किए बिना कुंजी-इन-प्रश्न का प्रयास न करें (यह इस API के लिए नहीं है)। - अनुरोध आकार: दोनों एंडपॉइंट्स केवल क्वेरी पैरामीटर के साथ GET हैं; कोई अनुरोध शरीर नहीं है।
- प्रसंस्कृत समय:
processed_timeफ्लोट सेकंड में है; यह प्रदर्शन डैशबोर्ड और SLOs के लिए उपयोगी है। - कैशिंग: यदि आप उपयोगकर्ता लुकअप को कैश करते हैं, तो इस तथ्य का सम्मान करें कि उपयोगकर्ता-फेसिंग पहचान बदल सकती है। महत्वपूर्ण सत्यापन प्रवाह के लिए छोटे TTLs का उपयोग करें, गैर-आवश्यक समृद्धि के लिए लंबे समय तक।
- त्रुटि हैंडलिंग: JSON
codeपर शाखा करें और उपयोगकर्ता-फेसिंग मार्गदर्शन या आंतरिक लॉगिंग के लिएmsgकी जांच करें; नेटवर्क त्रुटियों और JSON-स्तरीय त्रुटियों को अलग-अलग व्यवहार करें। - कोटा योजना: मार्केटप्लेस सदस्यता + कोटा का उपयोग करता है (पे-पर-कॉल नहीं)। यहां पहला API 7-दिन का परीक्षण या 50 अनुरोधों का समर्थन करता है ताकि आप एकीकृत कर सकें। अपने Zyla डैशबोर्ड में उपयोग की निगरानी करें और बैच कार्यों का आकार उसी के अनुसार करें।
त्वरित संदर्भ: सटीक पैरामीटर और URLs
- Get User Info
- GET https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info
- Params:
user_id(string, आवश्यक)
- Get Video Info
- GET https://zylalabs.com/api/2516/tiktok-data-api/2504/get-video-info
- Params:
url(string, आवश्यक), प्रारूप जैसेhttps://www.tiktok.com/@khaby.lame/video/7411964588809342241
एंडपॉइंट्स से मैप किए गए उपयोग के मामले
- खाता लिंकिंग: उपयोगकर्ता प्रोफाइल पर इसे सहेजने से पहले TikTok खाते की पुष्टि करने के लिए Get User Info का उपयोग करें।
- निर्माता सुविधाओं के लिए पात्रता जांच: Get Video Info के साथ प्रस्तुत वीडियो URL को मान्य करें, फिर केवल तभी आगे बढ़ें जब लुकअप सफल हो।
- सहायता उपकरण: अपने प्रशासन में "Re-verify TikTok" बटन जोड़ें जो Get User Info को कॉल करता है और आपकी टीम को
msgदिखाता है।
AI एजेंटों के माध्यम से इस API को कॉल करें MCP से
आप इन HTTP एंडपॉइंट्स को MCP-संगत डेवलपर उपकरणों और एजेंटों (जैसे, Claude Code, Cursor, Windsurf) से Zyla MCP गेटवे का उपयोग करके भी सक्रिय कर सकते हैं। अपने क्लाइंट को MCP एंडपॉइंट पर इंगित करें और अपनी API कुंजी पास करें:
- MCP URL:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
अपने एजेंट से, ऊपर दिखाए गए समान HTTPS GET अनुरोध जारी करें (प्रमाणीकरण हेडर सहित)। यह आपको कोड समीक्षाओं के दौरान या रनबुक-चालित संचालन के दौरान एक-क्लिक सत्यापन स्क्रिप्ट करने की अनुमति देता है बिना स्थानीय स्क्रिप्ट में रहस्यों को हार्डकोड किए। अधिक जानकारी के लिए, दस्तावेज़ देखें: MCP.
समस्या निवारण
- Get User Info पर
code: -1प्राप्त करना: पुष्टि करें कि प्रदान किया गयाuser_idसही है। उपयोगकर्ताओं कोmsgको एक मित्रवत तरीके से दिखाएं (जैसे, "कृपया अपने TikTok उपयोगकर्ता ID की दोबारा जांच करें")। - वीडियो URL असंगतताएँ: सुनिश्चित करें कि URL प्रलेखित प्रारूप का पालन करता है, जिसमें पथ संरचना शामिल है। यदि आप भाषा प्रश्न पैरामीटर (जैसे,
?lang=en) कैप्चर करते हैं, तो उन्हें उदाहरण कर्ल में जैसा कि है URL-कोडित रखें। - HTTP 401: सुनिश्चित करें कि आपका प्रमाणीकरण हेडर बियरर योजना का उपयोग करता है और कुंजी समाप्त नहीं हुई है या घुमाई नहीं गई है।
- अवलोकनशीलता: प्रत्येक अनुरोध के लिए
processed_timeको लॉग करें ताकि अस्थायी धीमी प्रतिक्रियाओं की पहचान की जा सके और पुनः प्रयासों को ठीक किया जा सके।
अक्सर पूछे जाने वाले प्रश्न
TikTok डेटा API किस प्रमाणीकरण हेडर की अपेक्षा करता है?
प्रत्येक अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
क्या मैं इन एंडपॉइंट्स को POST बॉडी भेज सकता हूँ?
नहीं। दोनों प्रलेखित एंडपॉइंट्स GET हैं और केवल क्वेरी स्ट्रिंग के माध्यम से पैरामीटर स्वीकार करते हैं।
processed_time का क्या अर्थ है?
यह आपके अनुरोध के लिए सर्वर-साइड प्रसंस्करण समय है। इसका उपयोग प्रदर्शन निगरानी और अलर्टिंग के लिए करें।
क्या कोई मुफ्त योजना है?
नहीं। मार्केटप्लेस सदस्यता + कोटा का उपयोग करता है, पे-पर-कॉल नहीं। यहां पहला API 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है ताकि आप एकीकृत कर सकें। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए, API पृष्ठ की जांच करें।
वीडियो URL प्रारूप कितना सख्त है?
आपको एंडपॉइंट विवरण में दिखाए गए प्रारूप में एक URL प्रदान करना होगा (उदाहरण के लिए, https://www.tiktok.com/@khaby.lame/video/7411964588809342241)। यदि मौजूद हो तो प्रश्न पैरामीटर को URL-कोडित रखें।
अपनी एकीकरण को शिप करें
आपके पास अब TikTok उपयोगकर्ताओं को सत्यापित करने और उनके प्रस्तुत सामग्री को आपके उपयोगकर्ता प्रबंधन प्रवाह के भीतर मान्य करने के लिए सटीक URLs, पैरामीटर, और कार्यशील उदाहरण हैं। अपना खाता बनाएं, एक API कुंजी प्राप्त करें, और यहां अपना 7-दिन का परीक्षण शुरू करें: Start 7-day trial on TikTok Data API. एक खाता Zyla API Hub पर हजारों उत्पादन-तैयार APIs को एकल कुंजी और सदस्यता मॉडल के साथ कवर करता है।