TikTok スクレイパー エンドポイント

必要なデータに応じて TikTok actor を選択してください。各操作は同じ HTTP リクエストエンドポイントを使用しますが、その actor および入力フィールドは異なります。

リクエストと認証

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

YOUR_API_KEY をご自身のScrapeless APIキーに置き換えてください。JSONオブジェクトを1つ送信し、その中に actor と inputを含めてください。

操作を選択

ユーザー詳細

アカウントのユーザー名を 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 です。User Workを呼び出す場合に使用します。ユーザー名、アカウントID、 sec_uid はそれぞれ異なる値であり、相互に置き換えることはできません。

ユーザー詳細 API リファレンス

ユーザー作品

アカウントの投稿は、そのアカウントの sec_uidを使用して取得します。以下のリクエストは、公式のUser Detailレスポンスと同じアカウント識別子を使用しています。自分で完了したプロフィール取得リクエストから得られた 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 フィールドも含まれていません。これらのフィールドが存在することを前提にページネーションのループを実装しないでください。

User Work API リファレンス

ショップページ

TikTok Shopの商品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 も文字列として表されています。

Shop Page 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'

プレースホルダー YOUR_TASK_ID を、リクエストで返されたIDに置き換えます。 結果の取得とポーリング に記載されたポーリング間隔と再試行回数の上限に従ってください。

エラー本文とHTTPステータスコードの両方を確認してください。 400 レスポンスには、 code: 20500 と message: "scraping failed"が含まれる場合があり、これはデータ取得の成功を示すレスポンスではありません。再試行する前に、対象とリクエストの入力値を確認してください。

レスポンスの例

このページの抜粋は、サンプルリクエストからのライブ結果ではなく、公式の API 例のサブセットです。完全なペイロードについては、リンクされた操作リファレンスを読んでください。また、アプリケーションのニーズに応じて、欠落している値を適切に処理してください。