टिकटोक शॉप स्क्रैपर गाइड: उत्पाद डेटा, मूल्य, और एसकेयू्स

TL;DR:

• एक TikTok दुकान स्क्रैपर एक ज्ञात उत्पाद के साथ शुरू होता है। product_id और region को scraper.tiktok.shop.page पर भेजें।
• उत्पाद और विकल्प रिकॉर्ड के लिए अलग तालिकाओं की आवश्यकता है। उत्पाद स्तर की कीमत, स्टॉक, विक्रेता और शिपिंग को SKU स्तर के विकल्पों और उपलब्धता को अधिलेखन नहीं करना चाहिए।
• क्षेत्र और मुद्रा हर अवलोकन पर होना चाहिए। लौटाया गया क्षेत्र उस पृष्ठ का प्रतिनिधित्व करता है जो हल किया गया है, जबकि मुद्रा कीमत को उसका अर्थ देती है।
• बिक्री लेबल की सीमाएँ हैं। sold_count को लौटाए गए रूप में बनाए रखें; इसे GMV, एक आदेश खाता या चुने गए समय के लिए बिक्री के रूप में पुनःव्याख्या न करें।
• सेटअप मदद करने वाले स्नैपशॉट। कार्यकर्ता उत्पाद डेटा लौटाता है; अनुसूची और इतिहास को कॉलिंग एप्लिकेशन द्वारा बनाया गया है।
• शुरू करने के लिए स्वतंत्र। नए Scrapeless खातों में Scrapeless डैशबोर्ड के माध्यम से मुफ्त क्रेडिट शामिल है।

परिचय: फ़ीड बनाने से पहले उत्पाद का मॉडल

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

Scrapeless TikTok दुकान स्क्रैपर एक ज्ञात उत्पाद ID और क्षेत्र से एक संरचित उत्पाद प्रतिक्रिया लौटाता है। यह मार्गदर्शिका अनुरोध को दिखाती है, फ़ील्ड को मैप करती है, और उत्पाद और SKU रिकॉर्ड के लिए एक साफ़ Python मानकीकरणकर्ता बनाती है। प्रबंधित डेटा कार्यकर्ताओं द्वारा उपयोग किए जाने वाले सामान्य अनुरोध लिफाफे के लिए, प्रकाशित Scrapeless डेटा कार्यकर्ता मार्गदर्शिका पढ़ें।

TikTok दुकान स्क्रैपर क्या लौटाता है

scraper.tiktok.shop.page कार्यकर्ता उत्पाद विवरण देखने के लिए डिज़ाइन किया गया है। यह वापस कर सकता है:

• उत्पाद ID, नाम, क्षेत्र, विक्रेता, और बेची गई संख्या
• प्रदर्शित कीमत और मुद्रा
• संचित स्टॉक
• रेटिंग और समीक्षाओं की संख्या
• उत्पाद चित्र
• विकल्प परिभाषाएँ और SKU रिकॉर्ड
• SKU उपलब्धता
• विक्रेता विवरण, श्रेणियाँ, और शिपिंग जानकारी

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

TikTok का अपना वाणिज्य दस्तावेज़ उत्पादों को SKUs से अलग करता है उत्पाद API अवलोकन में. वह भेद भी स्क्रैप किए गए उत्पाद-पृष्ठ रिकॉर्ड के लिए सही डेटाबेस सीमा है: एक उत्पाद कई बेचने योग्य रूपों का मालिक हो सकता है।

अनुरोध पैरामीटर

एंडपॉइंट POST https://api.scrapeless.com/api/v1/scraper/request है, जिसे x-api-token के साथ प्रमाणित किया गया है।

शरीर में दो आवश्यक इनपुट हैं:

दस्तावेज़ क्षेत्र के उदाहरण दिखाता है जैसे GB, SG, JP, और US. उस छोटे उदाहरण सेट को एक पूर्ण मार्केट डायरेक्टरी के रूप में न मानें। उत्पाद कार्यप्रवाह द्वारा आवश्यक बाजार की पुष्टि करें और परिणाम में लौटाए गए क्षेत्र को बनाए रखें।

पूर्ण इनपुट और आउटपुट उदाहरण TikTok दुकान पृष्ठ कार्यकर्ता दस्तावेज़ में है।

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

• Scrapeless डैशबोर्ड से एक Scrapeless खाता और API टोकन
• एक ज्ञात सार्वजनिक TikTok दुकान उत्पाद ID
• अनुसंधान कार्य के लिए आवश्यक बाजार क्षेत्र
• एक संग्रहण स्कीमा जो उत्पाद और SKU स्नैपशॉट को अलग-अलग रख सकता है

कोड में SCRAPELESS_API_KEY में एक लाइव टोकन और TIKTOK_SHOP_PRODUCT_ID में एक वास्तविक उत्पाद ID की आवश्यकता होती है।

कर्ल के साथ त्वरित कैप्चर

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.shop.page\",\"input\":{\"product_id\":\"${TIKTOK_SHOP_PRODUCT_ID}\",\"region\":\"GB\"}}"

प्रतिक्रिया JSON है। पंजीकृत application/json प्रकार IANA के मीडिया प्रकार रजिस्ट्रियों में बनाए रखा गया है, इसलिए मानक HTTP क्लाइंट बिना साइट-विशिष्ट डिकोडर के शरीर को पार्स कर सकते हैं।

Python में उत्पाद और SKU डेटा को मानकीकृत करें

निम्नलिखित मानकीकरणकर्ता कच्ची प्रतिक्रिया को बनाए रखता है, एक उत्पाद रिकॉर्ड बनाता है, और प्रति SKU एक पंक्ति निकालता है। यह जानबूझकर यह मानने से बचता है कि प्रत्येक वैकल्पिक फ़ील्ड मौजूद है।

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

ENDPOINT = "https://api.scrapeless.com/api/v1/scraper/request"


def fetch_product(product_id, region):
    payload = {
        "actor": "scraper.tiktok.shop.page",
        "input": {"product_id": str(product_id), "region": region},
    }
    request = Request(
        ENDPOINT,
        data=json.dumps(payload).encode(),
        headers={
            "x-api-token": os.environ["SCRAPELESS_API_KEY"],
            "content-type": "application/json",
        },
        method="POST",
    )
    with urlopen(request, timeout=60) as response:
        return json.load(response)


def normalize(raw):
    observed_at = datetime.now(timezone.utc).isoformat()
    product_id = str(raw.get("product_id", ""))
    product = {
        "observed_at": observed_at,
        "product_id": product_id,
        "region": raw.get("region"),
        "name": raw.get("name"),
        "seller": raw.get("seller"),
        "price": raw.get("price"),
        "currency": raw.get("currency"),
        "stock": raw.get("stock"),
        "sold_count": raw.get("sold_count"),
        "rating": raw.get("rating"),
        "review_count": raw.get("review_count"),
    }
    sku_rows = []
    for sku in raw.get("skus") or []:
        sku_rows.append({
            "observed_at": observed_at,
            "product_id": product_id,
            "region": raw.get("region"),
            "sku_id": str(sku.get("sku_id") or sku.get("id") or ""),
            "options": sku.get("options"),
            "availability": sku.get("availability"),
            "price": sku.get("price"),
            "currency": sku.get("currency") or raw.get("currency"),
        })
    return product, sku_rows


raw_product = fetch_product(os.environ["TIKTOK_SHOP_PRODUCT_ID"], "GB")
product_row, sku_rows = normalize(raw_product)
print(json.dumps({"product": product_row, "skus": sku_rows}, indent=2))

Scrapeless के साथ स्क्रैपिंग शुरू करें

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

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

उत्पाद क्षेत्रों को पढ़ने का तरीका

पहचान और विक्रेता

product_id को एक स्ट्रिंग के रूप में स्टोर करें। बिक्रीकर्ता वस्तु या बिक्रीकर्ता पहचानकर्ता को उत्पाद स्नैपशॉट के साथ रखیں, क्योंकि केवल नाम एक स्थायी जोड़ कुंजी नहीं हो सकता है।

कीमत और मुद्रा

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

स्टॉक और उपलब्धता

उत्पाद स्तर का स्टॉक एक समग्र दृश्य है। SKU उपलब्धता एक विशेष विकल्प संयोजन का वर्णन करती है। TikTok दुकान का इन्वेंट्री документация भी उत्पाद और SKU को अलग-अलग स्टॉक आयाम के रूप में पहचानता है। दोनों स्तरों को बनाए रखें और उत्पाद समग्र के साथ गायब SKU फ़ील्ड को प्रतिस्थापित करने से बचें।

बेचे गए गणना, रेटिंग, और समीक्षाएँ

sold_count, रेटिंग, और समीक्षा गणना को अवलोकित लेबल के रूप में रखें। एक उत्पाद-पृष्ठ बेची गई गणना एक रिपोर्टिंग विंडो स्थापित नहीं करती है और ऑर्डर खाता का खुलासा नहीं करती है। रेटिंग और समीक्षा गणना वर्तमान पृष्ठ प्रतिक्रिया का वर्णन करती है, व्यक्तिगत समीक्षाओं के पाठ को नहीं।

विकल्प और SKUs

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

स्नैपशॉट-तैयार स्कीमा बनाएं

एक व्यावहारिक मॉडल तीन स्टोर्स का उपयोग करता है:

गायब और शून्य अलग हैं। शून्य स्टॉक एक मान है; अनुपस्थित स्टॉक अज्ञात है। इस भिन्नता को डेटाबेस, विश्लेषण कार्य, और अलर्ट नियमों में बनाए रखें।

Scrapeless इस अभिनेता को Scraping API के माध्यम से प्रदान करता है। जब उत्पाद सेट और संग्रह गति का आकार निर्धारित करें, तब वर्तमान मूल्य निर्धारण पृष्ठ का उपयोग करें।

सामान्य समस्याएँ रोकें

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

निष्कर्ष: उत्पाद पदानुक्रम को बनाए रखें

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

अपने TikTok दुकान डेटासेट बनाने के लिए तैयार?

Scrapeless Discord या Telegram समुदाय में स्कीमा पर चर्चा करें। जब आपकी उत्पाद सूची और क्षेत्र नियम तैयार हों, तब Scrapeless डैशबोर्ड खोलें।

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

प्रश्न: एक TikTok दुकान स्क्रैपर क्या इकट्ठा करता है?

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

प्रश्न: मैं Python के साथ TikTok दुकान उत्पादों को कैसे स्क्रैप करूँ?

Scrapeless स्क्रैपर API को scraper.tiktok.shop.page के साथ एक JSON POST अनुरोध भेजें, साथ ही इनपुट ऑब्जेक्ट में product_id और region।

प्रश्न: क्या अभिनेता दुकान में हर उत्पाद का पता लगा सकता है?

नहीं। यह उत्पाद-पृष्ठ अभिनेता एक ज्ञात उत्पाद ID की अपेक्षा करता है; इसे पूरी कैटलॉग खोज API के रूप में वर्णित नहीं किया जाना चाहिए।

प्रश्न: क्या प्रतिक्रिया में उत्पाद विविधताएँ शामिल हैं?

यह विकल्प और उपलब्धता के साथ SKU रिकॉर्ड शामिल कर सकता है। उन रिकॉर्डों को उत्पाद स्तर के फ़ील्ड से अलग रखें।

प्रश्न: क्या अभिनेता स्वचालित रूप से कीमतों को ट्रैक करता है?

नहीं। यह एक स्नैपशॉट लौटाता है। आपका अनुप्रयोग कॉल शेड्यूल करता है, टाइमस्टैम्प संग्रहीत करता है, स्नैपशॉट की तुलना करता है, और कोई भी अलर्ट भेजता है।

प्रश्न: क्या TikTok दुकान डेटा को खींचना वैध है?

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

प्रबंधित अभिनेता संग्रह सतह को संभालता है। आपका कोड वैध उत्पाद संदर्भ प्रदान करता है और संरचित प्रतिक्रिया को संभालता है।

Q: क्या यह बिना एआई एजेंट के चल सकता है?

हाँ। उदाहरण सामान्य HTTP अनुरोधों का उपयोग करता है और एक एजेंट पर निर्भर नहीं है।