take_screenshot
See a public web page the way a person does. Renders the URL in a real browser with ads and cookie banners removed and returns the image inline (PNG unless format is set; pdf comes back as base64 text), followed by a line with the captures left this month. Use device for a phone or tablet view and full_page for the whole page. To read the words, use extract_content. Most pages take a few seconds; a page still loading after about 30 seconds is captured as it stands. Uses one capture. Pass fresh: false to accept a free copy of the same URL and options captured in the last 24 hours. Public URLs only: localhost and private network addresses are refused.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public page to capture: a full URL starting with https:// or http:// | |
| delay | No | Extra milliseconds to wait after the page loads, 0-10000 (default: 0) | |
| fresh | No | Default true: render the page now (uses one capture). false: a copy of the same URL and options captured in the last 24 hours may be returned for free; the result then says when it was captured. | |
| width | No | Viewport width in CSS pixels, 320-3840 (default: 1280). Ignored when device is set. | |
| device | No | Phone, tablet or laptop preset (overrides width and height): iphone_14 (390x844), iphone_15_pro (393x852), pixel_7 (412x915), ipad_pro (1024x1366), macbook_pro (1440x900) | |
| format | No | Output format: png (default), jpeg, webp, or pdf | |
| height | No | Viewport height in CSS pixels, 200-10000 (default: 800). Ignored when device is set. | |
| quality | No | JPEG and WebP quality, 1-100 (default: 90). Ignored for png. | |
| block_ads | No | Block ads and trackers (default: true) | |
| dark_mode | No | Ask the page for its dark color scheme (default: false) | |
| full_page | No | Capture the whole scrollable page instead of one screen (default: false). Very tall pages are cut at about 32,000 px (about 8,000 px for webp, less with phone presets). | |
| user_agent | No | Custom User-Agent string. A capture with a custom user agent is always rendered new. | |
| click_selector | No | CSS selector to click before the capture | |
| hide_selectors | No | Comma-separated CSS selectors to hide before the capture | |
| block_cookie_banners | No | Remove cookie consent banners (default: true). false always renders a new capture. |