TikTok Scraper クイックスタート

User Detailのactorを使用して、1つのTikTokアカウントプロフィールを取得します。このチュートリアルでは、ユーザー名と 公式のUser Detailの例からのリクエストを使用します。

はじめに

Scrapelessアカウント、有効なAPIキー、およびcURLが必要です。キーは Scrapelessダッシュボードから取得してください。

1. プロフィールリクエストを送信

YOUR_API_KEY を自分のキーに置き換えてください。また、 teamtrump を取得したいユーザー名に置き換えることができます。公式の例と同様に、プロフィールのURLではなくユーザー名そのものを渡します。

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"
  }
}'

actor scraper.tiktok.user.detailを選択します。必須の input.unique_id がアカウントを識別します。

2. 完了した結果を読み取る

HTTP 200 のレスポンスが返され、プロフィールデータが含まれます。これは公開されているレスポンス例の一部であり、新たに取得したデータではありません：

{
  "account_id": "7365161718782395438",
  "unique_id": "teamtrump",
  "sec_uid": "MS4wLjABAAAAIb0gpCf24bC1i5TWl87J5SjS0h7ZB59nfledznAyQ_DF7-vpgJJ8nYfzo98Ba3fp",
  "nickname": "Team Trump",
  "profile_url": "https://www.tiktok.com/@teamtrump",
  "is_verified": true
}

完全な例にはさらに avatar と statisticsが含まれます。統計値は文字列形式です。User Workを使ってそのアカウントの投稿をリクエストしたい場合は、実際の sec_uid を結果から保存してください。

3. まだ処理中のタスクを取得

HTTP 201を受け取った場合、レスポンスから taskId を読み取り、以下の YOUR_TASK_ID を置き換えてください：

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

ポーリング間隔と再試行回数については、 結果の取得とポーリング を参照してください。重複するプロフィールリクエストを作成するのではなく、返されたタスクIDを再利用してください。

リクエストが失敗した場合

HTTPのステータスとレスポンス本文を確認してください。User Detailのリファレンスには、 400 のレスポンスに code と messageが含まれており、エラー例として code: 20500、 message: "scraping failed"も記載されています。再試行する前に、入力されたユーザー名と認証情報を確認してください。

次のステップ

エンドポイント に進み、 sec_uid を使って投稿をリクエストしたり、 product_id と regionを使ってShopの商品を取得したりしてください。