Skip to content

README.md

Latest commit

 

History

History
48 lines (35 loc) · 1.92 KB

README.md

File metadata and controls

48 lines (35 loc) · 1.92 KB
Raw

Python example

Requires Python 3.11+. The scripts use apify-client==3.3.0; python-dotenv loads .env from the repository root. The shell environment takes precedence over .env. Only APIFY_TOKEN is configurable; the Actor is fixed in code.

From the repository root:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r examples/python/requirements.txt
cp .env.example .env

Set APIFY_TOKEN in .env or the process environment. The default video URL is https://www.tiktok.com/@carter.braydon/video/7647694374876319007.

python3 examples/python/single_url.py
python3 examples/python/single_url.py --video-url 'https://www.tiktok.com/@user/video/1234567890'
python3 examples/python/async_run.py start
python3 examples/python/async_run.py wait --run-id RUN_ID --max-wait 900
python3 examples/python/csv_batch.py sample-data/tiktok-video-urls.csv --concurrency 2 --max-wait 900
python3 examples/python/csv_batch.py --reconcile

Single and batch outputs are written under sample-output/generated/. Run creation is one client-side POST attempt, not an exactly-once guarantee. If its result is unknown, check Apify Console before starting another Run; after a wait timeout, continue with the same Run ID.

Native batch Run (multiple targets in one request):

python3 examples/python/batch_targets.py

Accepted target examples (pass as videoUrl or an entry in batchTargets):

  • Profile: https://www.tiktok.com/@creator
  • Username: @creator
  • Short links: https://vm.tiktok.com/abcd, https://www.tiktok.com/t/SHORT_CODE, or https://tiktok.com/t/SHORT_CODE. Replace SHORT_CODE with an actual TikTok share code; the placeholder is not itself a resolvable link.

Reject other domains and unrelated TikTok paths such as /tag/example.

CSV batch files accept video URLs only, with one video Run per row. Use batchTargets for profile collection or a single Run containing multiple targets.