Quick Reference
Use delay and scroll_delay to ensure page assets load. Use min_size_bytes and retry_on to retry on blank or error pages. Use click_accept, press_escape, and hide_cookie_banners to dismiss modals and banners.
See the full configuration below or browse all available options.
TikTok is surprisingly cooperative for automated screenshots compared to other social platforms. You don't need Point of View for most public content - just proper timing and scroll handling.
This guide provides a working configuration for capturing TikTok content using the Urlbox Screenshot API.
Early Access Pricing
The retry_on option used in this example is currently in early access. This feature will incur additional costs once fully launched. Contact us for current pricing details.
Why TikTok Screenshots Can Fail
While TikTok is more accessible than Instagram or Facebook, you might still encounter:
- Dynamic content: Videos and comments load dynamically, potentially leaving blank areas
- Lazy loading: Content loads as you scroll
- Cookie banners: Consent dialogs can obstruct the content
Working Configuration
This configuration uses delays, scroll handling, and retry logic to capture TikTok content reliably.
{
"url": "https://www.tiktok.com/@theprimeagen/video/7251695355211926826",
"full_page": true,
"delay": 2000,
"scroll_delay": 800,
"retry_on": "small_size,timeout,5xx,4xx",
"max_retries": 3,
"min_size_bytes": 50000,
"retry_delay_ms": 2000,
"click_accept": true,
"press_escape": true,
"hide_cookie_banners": true
}
What Each Option Does
| Option | Description |
|---|---|
delay: 2000 | Gives time for Javascript on the page to settle after requests finish |
scroll_delay: 800 | When scrolling the page in steps, this delays each scroll to allow lazy-loaded content to appear |
retry_on: "small_size,timeout,5xx,4xx" | Retries the render when it's smaller than min_size_bytes, the request times out, or returns an error |
min_size_bytes: 50000 | Checks the minimum file size to catch blank or error pages |
max_retries: 3 | Maximum number of retry attempts when retry_on is applied. |
retry_delay_ms: 2000 | The time to wait between retries in milliseconds when retry_on is applied. |
click_accept: true | Accepts cookie consent banners |
hide_cookie_banners: true | Removes cookie and other bothersome banners using common heuristics |
press_escape: true | Presses the ESC key to help dismiss modals |
Important Notes
Response times: Using retry_on can significantly increase response times. Each retry adds the base render time plus retry_delay_ms, so a request with 3 retries could take considerably longer than a single render. For time-sensitive use cases, consider using webhooks or the async endpoint for asynchronous delivery instead.
Public content only: This configuration is designed for public content. Results may vary for private accounts or content that requires login.
Things change: These configurations work as of February 2026. TikTok occasionally updates its platform, so you may need to tweak these over time. If something stops working, get in touch and we'll help you through it.
More Social Media Guides
Looking to screenshot other platforms? See our guides for Instagram, X/Twitter, and Facebook, or our complete social media screenshot guide.
Looking for a no-code solution? CaptureDeck lets you screenshot social media at scale without writing any code.