TikTok स्क्रैपर एंडपॉइंट

आपको जिस डेटा की आवश्यकता है उसके लिए TikTok actor चुनें। प्रत्येक संचालन समान HTTP अनुरोध एंडपॉइंट का उपयोग करता है, लेकिन इसके actor और इनपुट फ़ील्ड भिन्न होते हैं।

अनुरोध और प्रमाणीकरण

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

अपनी Scrapeless API कुंजी के साथ YOUR_API_KEY को प्रतिस्थापित करें। actor और input युक्त एक JSON ऑब्जेक्ट भेजें।

एक ऑपरेशन चुनें

उपयोगकर्ता विवरण

आधिकारिक उदाहरण में दिखाए गए अनुसार unique_id में खाता उपयोगकर्ता नाम पास करें:

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.tiktok.user.detail",
  "input": {
    "unique_id": "teamtrump"
  }
}'

प्रकाशित प्रतिक्रिया में account_id, unique_id, sec_uid, nickname, profile_url, avatar, statistics, और is_verified जैसे खाता झंडे शामिल हैं।

यदि आप उपयोगकर्ता कार्य को कॉल करना चाहते हैं तो sec_uid सहेजें। एक उपयोगकर्ता नाम, खाता आईडी और sec_uid अलग-अलग मान हैं; एक को दूसरे के लिए प्रतिस्थापित न करें।

उपयोगकर्ता विवरण API संदर्भ

उपयोगकर्ता कार्य

अपने खाते के पोस्ट प्राप्त करने के लिए इसका उपयोग करें sec_uid। नीचे दिए गए अनुरोध आधिकारिक उपयोगकर्ता विवरण प्रतिक्रिया के समान खाता पहचानकर्ता का उपयोग करता है; इसे अपने स्वयं के पूर्ण प्रोफ़ाइल अनुरोध से प्राप्त sec_uid से बदलें।

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.tiktok.user.work",
  "input": {
    "sec_uid": "MS4wLjABAAAAIb0gpCf24bC1i5TWl87J5SjS0h7ZB59nfledznAyQ_DF7-vpgJJ8nYfzo98Ba3fp",
    "cursor": "0",
    "count": 10
  }
}'

सफल उदाहरण में एक items सरणी शामिल है। यह अंश इसके पहले आइटम से चयनित क्षेत्रों को बरकरार रखता है:

{
  "items": [
    {
      "post_id": "7673888001365150989",
      "post_url": "https://www.tiktok.com/@teamtrump/video/7673888001365150989",
      "play_count": 572300,
      "like_count": 31000
    }
  ]
}

पूर्ण आइटम में वीडियो और लेखक की जानकारी भी शामिल है। संदर्भ एक कर्सर इनपुट का दस्तावेजीकरण करता है लेकिन इसके प्रतिक्रिया उदाहरण में अगले पृष्ठ का कर्सर या has_more क्षेत्र शामिल नहीं है। कोई पृष्ठांकन लूप न बनाएं जो मान ले कि कोई क्षेत्र मौजूद है।

उपयोगकर्ता कार्य API संदर्भ

दुकान पृष्ठ

TikTok दुकान उत्पाद ID और क्षेत्र के साथ उत्पाद विवरण प्राप्त करें। दोनों इनपुट आवश्यक स्ट्रिंग्स हैं। यह अनुरोध आधिकारिक उदाहरण के gb मान को बरकरार रखता है:

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.tiktok.shop.page",
  "input": {
    "product_id": "1729411983267761850",
    "region": "gb"
  }
}'

लौटाया गया region उत्पाद पृष्ठ पर वास्तविक क्षेत्र का प्रतिनिधित्व करता है। प्रकाशित उदाहरण का यह उपसमुच्चय क्षेत्र प्रकार दिखाता है; मूल्य और गिनती ऐतिहासिक उदाहरण मान हैं:

{
  "product_id": "1729411983267761850",
  "region": "GB",
  "sold_count": "17644",
  "price": {
    "currency": "GBP",
    "sale_price": "5.78"
  },
  "rating": 4.5,
  "review_count": "823"
}

पूर्ण उदाहरण में stock, images, options, skus, seller, और shipping_optionsभी शामिल है। उत्पाद ID को स्ट्रिंग के रूप में रखें; उदाहरण भी sold_count, review_count, और price.sale_price को स्ट्रिंग के रूप में दर्शाता है।

दुकान पृष्ठ API संदर्भ

टास्क परिणामों को संभालें

एक HTTP 200 प्रतिक्रिया पूर्ण परिणाम शामिल होती है। एक HTTP 201 प्रतिक्रिया का अर्थ है कि प्रसंस्करण अभी भी चल रहा है; इसके taskId को सहेजें और निम्नलिखित के साथ उस टास्क को पुनः प्राप्त करें:

curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

अपने अनुरोध द्वारा लौटाई गई ID से YOUR_TASK_ID को बदलें। पोलिंग अंतराल और पुनः प्रयास सीमाओं के लिए परिणाम और पोलिंग का अनुसरण करें।

HTTP स्थिति कोड के साथ-साथ त्रुटि बॉडी का भी निरीक्षण करें। एक 400 प्रतिक्रिया में code: 20500 और message: "scraping failed" शामिल हो सकते हैं; यह एक सफल डेटा प्रतिक्रिया नहीं है। पुनः प्रयास करने से पहले लक्ष्य और अनुरोध इनपुट की जाँच करें।

प्रतिक्रिया उदाहरण

इस पृष्ठ पर अंश आधिकारिक API उदाहरणों के उपसमुच्चय हैं, नमूना अनुरोधों से लाइव परिणाम नहीं। पूर्ण पेलोड के लिए लिंक किए गए संचालन संदर्भ को पढ़ें और अपने अनुप्रयोग की आवश्यकताओं के अनुसार लापता मानों को संभालें।