TikTok स्क्रैपर API गाइड: प्रोफाइल, पोस्ट, और शॉप डेटा

TL;DR:

• तीन अभिनेता मुख्य कार्यप्रवाही को कवर करते हैं। सार्वजनिक खाता विवरण के लिए scraper.tiktok.user.detail का उपयोग करें, एक निर्माता के सार्वजनिक पोस्ट के लिए scraper.tiktok.user.work, और एक दुकान उत्पाद पृष्ठ के लिए scraper.tiktok.shop.page।
• प्रोफाइल कॉल पोस्ट डेटा के लिए पुल है। यह unique_id स्वीकार करता है और sec_uid लौटाता है, जिसकी अपेक्षा पोस्ट अभिनेता को है।
• दुकान अनुरोधों को उत्पाद संदर्भ की आवश्यकता होती है। दोनों product_id और region भेजें; रिकॉर्ड की तुलना करने से पहले लौटाए गए क्षेत्र और मुद्रा को पढ़ें।
• उत्तर संरचित JSON है। पहचानकर्ताओं को स्ट्रिंग के रूप में संग्रहित करें, nullable फ़ील्ड को बनाए रखें, और कच्चे उत्तर को किसी भी सामान्यीकृत तालिका के बगल में रखें।
• एक टिकटोक स्क्रैपर एपीआई स्नैपशॉट लौटाता है। शेड्यूलिंग, इतिहास, स्कोरिंग, और अलर्ट उस पाइपलाइन में शामिल होते हैं जो इसे कॉल करती है।
• शुरू करने के लिए मुफ्त। नए स्क्रैपलेस खातों में मुफ्त क्रेडिट शामिल होता है; स्क्रैपलेस डैशबोर्ड में एक खाता बनाएं।

परिचय: एक एंडपॉइंट, तीन उपयोगी टिकटोक डेटा सेट

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

स्क्रैपलेस टिकटोक स्क्रैपर एपीआई उन वस्तुओं को एक अनुरोध एंडपॉइंट के पीछे प्रबंधित अभिनेताओं के माध्यम से प्रदर्शित करता है। एपीआई HTTP के ऊपर JSON लौटाता है, इसलिए यह स्क्रिप्ट, डेटा नौकरियां, आंतरिक उपकरण, और एजेंट कार्यप्रवाहों में उपयुक्त है। यह गाइड अभिनेताओं को मानचित्रित करती है, प्रमाणित अनुरोध भेजती है, और उनके उत्तरों को ऐसे रिकॉर्ड में बदल देती है जो पहले चलाने के बाद भी समझ में आते हैं।

प्रबंधित अभिनेताओं के विस्तृत दृश्य के लिए, स्क्रैपलेस स्क्रैपर एपीआई गाइड पढ़ें।

टिकटोक स्क्रैपर एपीआई क्या करता है

एपीआई एक अभिनेता नाम और एक input ऑब्जेक्ट शामिल करते हुए JSON अनुरोध स्वीकार करता है। स्क्रैपलेस अभिनेता को चलाता है और अभिनेता के संरचित परिणाम लौटाता है। परिवहन मानक HTTP अनुरोध सेमांटिक्स का अनुसरण करता है जो HTTP सेमांटिक्स विशिष्टता में वर्णित है, जबकि उत्तर शरीर में IANA के मीडिया प्रकार रजिस्ट्र्री द्वारा सूचीबद्ध पंजीकृत JSON मीडिया प्रकार का उपयोग किया जाता है।

तीन टिकटोक अभिनेता विभिन्न कार्य सर्व करते हैं:

ये सतहें अनुयायी सूचियाँ, दर्शक जनसांख्यिकी, टिप्पणी पाठ, एक पूर्ण टिकटोक कैटलॉग, या एक ऑर्डर लेजर प्रदान नहीं करती हैं। प्रत्येक उत्तर को अनुरोधित सार्वजनिक वस्तु के एक समय-परिवर्तन अवलोकन के रूप में माना जाना चाहिए।

आप इसके साथ क्या बना सकते हैं

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

एंडपॉइंट और पैरामीटर

तीन अभिनेताओं में से सभी एक ही एंडपॉइंट का उपयोग करते हैं:

POST https://api.scrapeless.com/api/v1/scraper/request

प्रमाणीकरण x-api-token अनुरोध शीर्षलेख का उपयोग करता है। शरीर में actor और input शामिल होते हैं।

प्रोफाइल पैरामीटर

scraper.tiktok.user.detail unique_id स्वीकार करता है, उपयोगकर्ता नाम के बिना सामने @। इसका उत्तर account_id, unique_id, sec_uid, उपनाम, प्रोफाइल यूआरएल, बायो, अवतार, सार्वजनिक खाता आँकड़े, खाता बनाने का समय, भाषा, देश, और सत्यापन, गोपनीयता, और विक्रेता स्थिति जैसे बूलियन फ़्लैग्स शामिल कर सकता है।

पोस्ट पैरामीटर

scraper.tiktok.user.work sec_uid की आवश्यकता होती है। यह cursor को एक स्ट्रिंग के रूप में और count को एक सकारात्मक पूर्णांक के रूप में स्वीकार करता है। डिफ़ॉल्ट cursor 0 है, और दिए गए डिफ़ॉल्ट count 35 है। एक प्रतिक्रिया एक items ऐरे को शामिल करती है। एक निरंतरता फ़ील्ड बनाने का प्रयास न करें: केवल तभी आगे बढ़ें जब प्रतिक्रिया और वर्तमान दस्तावेज़ कार्यप्रवाह के लिए एक सत्यापित निरंतरता मान प्रदान करते हैं।

दुकान पैरामीटर

scraper.tiktok.shop.page को product_id और region की आवश्यकता है। दस्तावेज़ में क्षेत्र के उदाहरणों में GB, SG, JP, और US शामिल हैं; ये उदाहरण हैं न कि कोई व्यापक बाजार सूची। प्रतिक्रिया का region उस उत्पाद पृष्ठ का प्रतिनिधित्व करता है जो हल किया गया और मूल्य और मुद्रा के साथ यात्रा करना चाहिए।

अभिनेता विवरण TikTok उपयोगकर्ता विवरण दस्तावेज़, TikTok उपयोगकर्ता कार्य दस्तावेज़, और TikTok शॉप पृष्ठ दस्तावेज़ में उपलब्ध हैं।

पूर्वापेक्षाएँ

• Scrapeless Dashboard से Scrapeless खाता और API टोकन
• एक सार्वजनिक TikTok उपयोगकर्ता नाम या ज्ञात TikTok शॉप उत्पाद ID
• संग्रहीत डेटा के लिए एक अनुमत उद्देश्य और एक पुनरावृत्ति नीति

उदाहरणों को एक लाइव Scrapeless API टोकन की आवश्यकता होती है। कोड चलाने से पहले इसे SCRAPELESS_API_KEY के रूप में निर्यात करें।

एक प्राधिकृत अनुरोध भेजें

यह कर्ल कॉल सार्वजनिक प्रोफ़ाइल डेटा को लाता है। उपयोगकर्ता नाम को उस खाते से बदलें जिसका आपका कार्यप्रवाह अनुसंधान के लिए अधिकृत है।

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header "x-api-token: ${SCRAPELESS_API_KEY}" \
  --header 'content-type: application/json' \
  --data '{
    "actor": "scraper.tiktok.user.detail",
    "input": {"unique_id": "tiktok"}
  }'

समान लिफाफा अन्य अभिनेताओं के लिए भी काम करता है। केवल अभिनेता और इनपुट फ़ील्ड बदलते हैं।

Scrapeless के साथ डाटा निकालना शुरू करें

Scrapeless के साथ अपने वेब स्क्रैपिंग और ऑटोमेशन कार्यप्रवाह को शक्ति दें!
आज ही साइन अप करें और $5 का मुफ्त क्रेडिट प्राप्त करें — कोई क्रेडिट कार्ड आवश्यक नहीं।

अपने मुफ्त क्रेडिट का दावा करें Scrapeless Dashboard में।

Python में प्रोफ़ाइल और पोस्ट डेटा को जोड़ें

उपयोगी जोड़ कुंजी sec_uid है। निम्नलिखित कार्यक्रम इसे प्रोफ़ाइल प्रतिक्रिया से प्राप्त करता है, फिर एक सीमित पोस्ट नमूना मांगता है। Python का JSON पुस्तकालय दस्तावेज़ीकरण यहाँ उपयोग किए गए अनुक्रमणीय व्यवहार को समझाता है।

import json
import os
from urllib.request import Request, urlopen

ENDPOINT = "https://api.scrapeless.com/api/v1/scraper/request"
TOKEN = os.environ["SCRAPELESS_API_KEY"]


def run_actor(actor, actor_input):
    body = json.dumps({"actor": actor, "input": actor_input}).encode()
    request = Request(
        ENDPOINT,
        data=body,
        headers={
            "x-api-token": TOKEN,
            "content-type": "application/json",
        },
        method="POST",
    )
    with urlopen(request, timeout=60) as response:
        return json.load(response)


profile = run_actor(
    "scraper.tiktok.user.detail",
    {"unique_id": "tiktok"},
)

posts = run_actor(
    "scraper.tiktok.user.work",
    {"sec_uid": profile["sec_uid"], "cursor": "0", "count": 10},
)

record = {
    "profile": {
        "account_id": str(profile.get("account_id", "")),
        "unique_id": profile.get("unique_id"),
        "sec_uid": profile.get("sec_uid"),
        "nickname": profile.get("nickname"),
        "statistics": profile.get("statistics", {}),
    },
    "posts": posts.get("items", []),
}

print(json.dumps(record, ensure_ascii=False, indent=2))

यह सुनिश्चित करें कि IDs को स्ट्रिंग के रूप में बनाए रखें जब भी वे केवल अंकों को ही क्यों न शामिल करते हों। इससे नीचे के उपकरणों में सटीकता की हानि से बचा जा सकता है, जो बड़े संख्याओं को सीमित संख्या की सटीकता के साथ प्रदर्शित करते हैं।

बिना अनुमान के प्रतिक्रिया स्कीमा पढ़ें

प्रोफ़ाइल, पोस्ट, और शॉप प्रतिक्रियाओं की अलग-अलग सामान्यीकरण नियमों की आवश्यकता होती है।

प्रोफाइल के लिए, पहचान फ़ील्ड को नेस्टेड सांख्यिकी ऑब्जेक्ट के बगल में रखें। पोस्ट के लिए, पोस्ट ID और URL, विवरण, निर्माण समय, सार्वजनिक गणना, मीडिया फ़ील्ड, हैशटैग, भाषा, चिपके या विज्ञापन ध्वज, संगीत, उपशीर्षक, और उपस्थित होने पर अनुमति को संचित करें। मीडिया URL और उपशीर्षक खाली हो सकते हैं, इसलिए एक खाली मूल्य एक असफल अनुरोध से अलग है।

शॉप उत्पादों के लिए, उत्पाद-स्तरीय फ़ील्ड को SKU-स्तरीय फ़ील्ड से अलग करें। प्रदर्शित मूल्य, संघटित भंडार, विक्रेता, श्रेणियाँ, और शिपिंग विवरण उत्पाद प्रतिक्रिया का वर्णन करते हैं। प्रत्येक SKU के अपने विकल्प और उपलब्धता हो सकती है। sold_count वह मूल्य है जो उत्पाद पृष्ठ द्वारा लौटाया गया है; यह एक सत्यापित आदेश खाता या एक विशेष अवधि का GMV आंकड़ा नहीं है।

संरचित आउटपुट को संभालना

एक ठोस तालिका चार विकल्पों के साथ शुरू होती है:

1. अभिनेता प्रतिक्रिया के बाहर एक संग्रह टाइमस्टैम्प जोड़ें।
2. ऑडिट और पुनःप्रसंस्करण के लिए कच्चा JSON बनाए रखें।
3. प्रोफाइल, पोस्ट, उत्पाद, और SKUs को अलग-अलग तालिकाओं में सामान्यीकृत करें।
4. अनुपस्थित और खाली फ़ील्ड को अज्ञात के रूप में मानें जब तक स्रोत से अर्थ का एक और अर्थ को स्थापित नहीं किया जाता है।

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

Scrapeless इन अभिनेताओं को Scraping API के तहत पैकेज करता है। उत्पादन मात्रा का अनुमान लगाने से पहले वर्तमान मूल्य निर्धारण पृष्ठ की जांच करें।

सामान्य समस्याएँ जिनसे बचें

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

निष्कर्ष: स्थिर वस्तुओं के चारों ओर निर्माण करें

TikTok स्क्रैपर API तीन सामान्य कार्यों को स्पष्ट अभिनेता कॉल्स में घटित करता है: एक खाते को हल करें, एक बाउंडेड सार्वजनिक पोस्ट का नमूना एकत्र करें, या एक ज्ञात शॉप उत्पाद को एक क्षेत्र में लाएँ। मुख्य इंजीनियरिंग कार्य डेटा मॉडलिंग पर केंद्रित होता है: पहचानकर्ताओं को संरक्षित करें, कच्चे प्रतिक्रियाओं को बनाए रखें, टाइमस्टैम्प संलग्न करें, और उत्पाद रिकॉर्ड को भिन्नताओं से अलग करें।

तैयार हैं अपना TikTok डेटा पाइपलाइन बनाने के लिए?

Scrapeless Discord या Telegram समुदाय में शामिल हों क्रियान्वयन नोट्स की तुलना करने के लिए। जब आप पहली अनुरोध भेजने के लिए तैयार हों, तो Scrapeless Dashboard में एक खाता बनाएं।

प्रश्नोत्तरी

प्रश्न: TikTok स्क्रैपर API क्या है?

एक TikTok स्क्रैपर API समर्थित सार्वजनिक TikTok पृष्ठों को एक HTTP अनुरोध के माध्यम से संरचित डेटा में परिवर्तित करता है। Scrapeless उपयोगकर्ता विवरण, उपयोगकर्ता पोस्ट, और शॉप उत्पाद पृष्ठों के लिए अलग-अलग अभिनेता प्रस्तुत करता है।

प्रश्न: क्या API TikTok उपयोगकर्ता नाम से पोस्ट प्राप्त कर सकता है?

हाँ, एक दो-कॉल कार्यप्रवाह के माध्यम से। उपयोगकर्ता नाम को scraper.tiktok.user.detail के साथ हल करें, फिर लौटाई गई sec_uid को scraper.tiktok.user.work में पास करें।

प्रश्न: क्या API टिप्पणियाँ या अनुयायी सूची लौटाता है?

नहीं। यहाँ जो प्रलेखित अभिनेता हैं, वे टिप्पणी पाठ, अनुयायी सूची, या दर्शक जनसांख्यिकी नहीं लौटाते हैं।

प्रश्न: क्या TikTok शॉप प्रतिक्रिया SKU डेटा शामिल करती है?

हाँ। शॉप अभिनेता विकल्पों और SKU रिकॉर्ड को उत्पाद स्तर की कीमत, मुद्रा, स्टॉक, विक्रेता, श्रेणी, छवि, रेटिंग, समीक्षा, और शिपिंग क्षेत्रों के साथ लौट सकता है।

प्रश्न: क्या सार्वजनिक TikTok डेटा स्क्रैपिंग कानूनी है?

कानूनिता अधिकार क्षेत्र, डेटा, उद्देश्य, पहुंच विधि, और लागू शर्तों पर निर्भर करती है। केवल सार्वजनिक डेटा का उपयोग करें, संग्रह को न्यूनतम करें, संग्रहीत रिकॉर्ड की सुरक्षा करें, और विशिष्ट परियोजना के लिए कानूनी सलाह प्राप्त करें।

प्रश्न: क्या मुझे प्रॉक्सी या पृष्ठ सुरक्षा प्रबंधन करने की आवश्यकता है?

प्रबंधित अभिनेता API कॉल के पीछे संग्रह सतह को संभालता है। आपके आवेदन को फिर भी मान्य इनपुट, स्पष्ट त्रुटि हैंडलिंग, और संवेदनशील अनुरोध योजना की आवश्यकता होती है।

प्रश्न: क्या कार्यप्रवाह बिना AI एजेंट के चल सकता है?

हाँ। कोई भी HTTP क्लाइंट जो JSON भेज सकता है और x-api-token हेडर को कॉल कर सकता है।