Get started
Quickstart
Take your first screenshot in about a minute. There are three ways in. Pick the one that suits you: they all do the same thing.
Using an AI assistant? Press Copy for AI and paste this page into your chat.
1Get your API key
Create a key in the dashboard, under Connect. It starts with lss_live_. You can copy it again from there any time. Keep it secret. Your account gets 50 free credits every month.
The examples on this page read the key from an environment variable, so it is not written in every command or saved in a file you share:
export LOCALSCREENSHOT_API_KEY="your key"
2Take a screenshot
Ask your AI
Add our MCP server to your AI tool, with your key in the Authorization header. Ask your AI (MCP) has the exact line for each tool. Then just ask:
Your AI gets three tools: take_screenshot, list_countries and get_credits.
Or call the API
Send the page address to /v1/screenshot. The answer is the image itself. Your key goes in the Authorization header, never in the address.
Or use the command line
One command takes the screenshot and saves the image. Command line (CLI) has the ways to install it and every option.
npx localscreenshot https://www.wikipedia.org -o shot.png
3Add what you need
Every option is one parameter. A few to start with:
| Option | What it does |
|---|---|
device=iphone_15 |
Capture the page as a phone sees it. |
full_page=true |
Capture the whole page, not only the visible part. |
block_cookie_banners=true |
Remove most cookie banners before the picture. |
country=DK |
Load the page from a country. 227 to choose from. |
format=pdf |
Save the page as a PDF. Also png, jpeg, webp. |
response=json |
Get a link to the image and the page details instead of the image. |
The full list is on Take a screenshot.
What it costs
- A screenshot uses 1 credit. From a chosen country, it uses 2.
- A failed screenshot is not charged. The number of failed screenshots per day is limited.
- Your 50 free credits come back each month and do not carry over. After your first month, your email address must be confirmed to keep getting them. Plan credits reset each month. Pack credits do not expire.
What it does not do. It does not sign in to websites, solve CAPTCHAs or get past paywalls. You get a clear error instead.