Add Screenshots API - Capture Website Screenshots
With Add Screenshots API, you can capture website screenshots easily and efficiently. Our API supports real-time GET requests and bulk requests using the HTTP POST method, making it simple to capture website screenshots in a variety of ways.
Whether you need to capture a single website screenshot or thousands, our API can handle your needs with ease. With a simple API key, you can start capturing website screenshots in no time.
Real-Time GET Requests
Our API supports real-time GET requests, which means that you can capture website screenshots instantly by simply requesting a URL with our API. This is great for capturing single screenshots on the fly or for creating a live screenshot of a website.
Bulk Requests using the HTTP POST Method
If you need to capture multiple website screenshots at once, our API also supports bulk requests using the HTTP POST method. This allows you to capture up to thousands of website screenshots at once, making it ideal for large-scale projects or automated workflows.
Integrating our API into your application is easy and seamless. You can use our API with popular programming languages and frameworks like PHP, Python, Ruby, and more. Sign up for our API today and start capturing website screenshots with ease.
Getting started with the Add Screenshots API
- API key overview
- API keys used on public websites
- API keys used by internal applications
- GET and POST Methods
- Usage Logs
- HTTP Response Codes
The Open API definition and Swagger UI is available at https://api.addscreenshots.com/
What is an API Key and Why Do You Need It to Take a Screenshot?
An API key is a credential used to identify the user, website, or application making a call to the Screenshot API. Each account has its own unique set of API keys, and using an API key allows for screenshot account information to be associated with the account.
Without an API key, the Screenshot API cannot authenticate the user and their account information cannot be linked to the screenshot request. In other words, an API key is required to ensure secure and authorized access to the Screenshot API.
If you're looking to use the Screenshot API to capture website screenshots, be sure to sign up for an account and obtain your own unique API key. With an API key, you can easily integrate our API into your application and start capturing website screenshots with ease.
Where can I find my website screenshot API key?
Visit the API Keys page to find your list of API keys. Need an account? Sign up to get started.
An example of the API keys page is shown below:
Why are there 4 API keys and which one should I use?
Each account with our Screenshot API will have four API keys with specific use cases:
| Name | Purpose | Use |
|---|---|---|
| Primary | This key is used internally to generate screenshots within your code or application for internal apps. | Internal Apps |
| Secondary | Similar to the primary key, this key is also used internally for generating screenshots within your code or application for internal apps. It serves as a backup in case the primary key was compromised and needs to be regenerated | Internal Apps |
| Public | This key is used on public websites in conjunction with a token signed by the secret key. | Public Websites |
| Secret | This key is used for signing a unique token of a screenshot request for internal apps. | Interal Apps |
If you're using our Screenshot API for internal applications where end-users cannot see the API key, use either the primary or secondary API key. For public websites, where end-users can potentially see or access the API key, use the public API key and a base64 token of the request with an HMAC SHA265 signature.
By using the appropriate API key for your specific use case, you can ensure secure and authorized access to the Screenshot API. If you have any questions about which API key to use or how to use it, please don't hesitate to contact our support team.
What happens if my API key is compromised or stolen?
If your Screenshot API key is compromised or stolen, it's important to take immediate action to secure your account and prevent unauthorized access. Fortunately, our Screenshot API makes it easy to regenerate a new API key and deactivate the old one.
Simply navigate to the API Keys screen in your account and click on the Regenerate icon next to the compromised API key. Within seconds, the old key will be deactivated and a brand-new key will be generated for your account.
By regenerating your API key, you can ensure the security of your account and prevent any potential misuse of your Screenshot API. If you suspect that your API key has been compromised or have any concerns about the security of your account, please contact our support team for assistance.
API keys for internal applications
Only use the Primary or Secondary API keys where end users cannot see the key. For example, used on your server for internal use.
How do I use the Primary or Secondary Screenshot API key?
To use the API for internal applications,
simply include the apikey in the query string or the x-api-key in the request header as shown below.
What is an example of using the primary/secondary API key in a URL query string?
The API key can included in the apikey query string as shown below:
// Line breaks added for readability
GET https://api.addscreenshots.com/screenshots
?apikey=YOUR_API_KEY
&url=example.com
Your API key can be found on the API Keys page.
Need an API Key? Sign up to get started.
For internal applications, replace YOUR_API_KEY with your own unique API Key.
For public facing websites or hotlinks, generate a signed URL.
What is an example of using the primary/secondary API key in a HTTP Header?
The API key can also be added in the HTTP request as a header with name x-api-key (apikey and x-apikey is also supported) and the value of the API key as shown below:
x-api-key: YOUR_API_KEY