Capture Website Screenshots Effortlessly with Cognitive Actions

23 Apr 2025
Capture Website Screenshots Effortlessly with Cognitive Actions

In today's digital landscape, capturing website screenshots is essential for various applications, from monitoring web performance to creating visual documentation. The shreejalmaharjan-27/website-screenshot Cognitive Actions provide a straightforward way to automate this process. With customizable options for dimensions and wait time, these pre-built actions allow developers to integrate screenshot capabilities seamlessly into their applications.

Prerequisites

Before diving into the integration of Cognitive Actions, ensure you have:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of making API requests.
  • A development environment set up with access to the Python programming language and the requests library.

Authentication typically involves passing your API key in the headers of your request, ensuring that your requests are authorized.

Cognitive Actions Overview

Capture Website Screenshot

The Capture Website Screenshot action allows you to take a screenshot of any specified website. You can customize the width, height, and even set a wait duration before the screenshot is captured. The default dimensions are set to 1920x1080 pixels.

Input

The input schema for this action requires a URL of the website to capture, along with optional parameters for width, height, and wait duration. Here’s a breakdown of the required and optional fields:

  • websiteUrl (required): The URL of the website from which to capture the screenshot.
  • width (optional): The width of the screenshot in pixels. Default is 1920.
  • height (optional): The height of the screenshot in pixels. Default is 1080.
  • waitDuration (optional): The duration to wait in seconds before capturing the screenshot. Default is 0.

Example Input:

{
  "width": 1920,
  "height": 1080,
  "websiteUrl": "https://google.com"
}

Output

Upon a successful request, the action returns a URL to the captured screenshot image. For example:

Example Output:

https://assets.cognitiveactions.com/invocations/fcd2c951-dd23-44e5-9ce6-152afb53de5f/8009068f-5ad8-4574-a20b-68aad61ba948.png

This URL points to the screenshot, which can be used directly in your applications.

Conceptual Usage Example (Python)

Here’s how you might implement the Capture Website Screenshot action in Python:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"  # Hypothetical endpoint

action_id = "3dfbdb65-3509-4539-b8cf-e1c78e0718b6"  # Action ID for Capture Website Screenshot

# Construct the input payload based on the action's requirements
payload = {
    "width": 1920,
    "height": 1080,
    "websiteUrl": "https://google.com"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}  # Hypothetical structure
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this code snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload variable is structured to match the action's input requirements. The request is sent to the hypothetical endpoint, and upon a successful response, the screenshot URL is printed.

Conclusion

The Capture Website Screenshot action from the shreejalmaharjan-27/website-screenshot Cognitive Actions enables developers to easily automate the process of capturing website images. With customizable options for size and wait duration, integrating this functionality into your applications can enhance user experience and provide valuable visual insights.

Consider exploring additional use cases, such as integrating screenshots into automated reports, monitoring website changes over time, or creating visual documentation for user guides. Happy coding!

← Back to All Articles