Screenshot API SDKs

JavaScript Screenshot API SDK

The SnapAPI JavaScript SDK supports Node.js 16 and later and modern browser environments with native fetch support. Install it with npm install snapapi-js or yarn add snapapi-js. Import the SnapAPI class and initialize it with your API key from the environment: import SnapAPI from 'snapapi-js'; const client = new SnapAPI(process.env.SNAPAPI_KEY). The screenshot method returns a Promise that resolves to a Buffer containing the PNG image bytes. The scrape method returns a Promise that resolves to a plain object with title, description, text, and html fields. The extract method accepts a schema definition object and returns a Promise that resolves to a structured object with the extracted fields. All methods accept an options object that maps directly to the SnapAPI query parameters, with camelCase property names for readability: { fullPage: true, delay: 2000, width: 1280, format: 'webp' }. The SDK includes TypeScript type definitions for all methods, options, and return types with full IntelliSense support in VS Code and other TypeScript-aware editors.

The JavaScript SDK handles common integration concerns automatically. Retry logic retries failed requests up to three times with exponential backoff for 429 rate limit and 5xx server error responses. Error normalization wraps all API errors in a SnapAPIError class with machine-readable code, human-readable message, and the HTTP status code, making it straightforward to catch and handle specific error types without inspecting raw HTTP responses. Response parsing handles the three response formats — binary, base64, and url — transparently based on the response_type parameter value, returning the appropriate type from each method call. The SDK is open source at github.com/Sleywill/snapapi-js and accepts community contributions through GitHub pull requests.

Python Screenshot API SDK

The SnapAPI Python SDK supports Python 3.8 and later. Install it with pip install snapapi-python. Import the SnapAPI client and initialize it with your API key: from snapapi import SnapAPI; client = SnapAPI(os.environ["SNAPAPI_KEY"]). The screenshot method returns bytes containing the PNG image data in synchronous mode. An async variant is available through the AsyncSnapAPI class that uses httpx internally and provides the same interface with async/await syntax for integration into asyncio applications. The Python SDK includes type hints for all method signatures and return types, compatible with mypy and pyright for static type checking in typed Python codebases. Pydantic models for the response types enable automatic validation and IDE autocomplete for the JSON response fields returned by the scrape and extract endpoints.

The Python SDK integrates cleanly with the requests and httpx HTTP libraries for applications that need to mix SnapAPI calls with other HTTP requests in the same client session. Pass a custom httpx.Client or requests.Session instance to the SnapAPI constructor to share connection pools and proxy configuration with other HTTP calls in the application. The session sharing pattern is particularly useful in web scraping pipelines that call both SnapAPI for rendered screenshots and custom HTTP requests for raw HTML fetching, keeping all outbound HTTP through a single configured client with consistent timeout and proxy settings.

Go Screenshot API SDK

The SnapAPI Go SDK supports Go 1.18 and later with generics. Install it with go get github.com/Sleywill/snapapi-go. Import the package and create a client with snapapi.NewClient(os.Getenv("SNAPAPI_KEY")). The Screenshot method returns a byte slice containing the PNG image data and an error value following Go's standard error handling conventions. The Scrape method returns a ScrapeResult struct with Title, Description, Text, and HTML string fields. All methods accept a context.Context as the first argument for cancellation and deadline propagation, enabling proper timeout handling in server applications. The Go SDK uses net/http internally with connection keep-alive enabled by default, and accepts a custom *http.Client for integration with applications that configure their own transport settings for proxy support, custom TLS, or connection pool tuning.

PHP Screenshot API SDK

The SnapAPI PHP SDK requires PHP 8.0 or later and the Guzzle HTTP library. Install it with composer require snapapi/snapapi-php. Create a client instance with new SnapAPI\Client($_ENV["SNAPAPI_KEY"]) and call the screenshot method with a target URL and optional parameters array. The method returns a Psr\Http\Message\StreamInterface containing the PNG image data, compatible with the PSR-7 HTTP message interfaces used throughout the PHP ecosystem. The PHP SDK includes PHPDoc annotations for all methods, enabling IDE autocomplete in PhpStorm and VS Code with PHP Intelephense. A Laravel service provider is included that automatically registers the SnapAPI client as a singleton in the Laravel application container, bound to the SNAPAPI_KEY value from the .env configuration file.

Swift and Kotlin SDKs

The SnapAPI Swift SDK targets iOS 15+, macOS 12+, and supports Swift Package Manager. Add the package URL https://github.com/Sleywill/snapapi-swift to Xcode or Package.swift and import SnapAPISwift. The async screenshot(url:options:) function returns Data containing the PNG image or throws a SnapAPIError. The SDK is compatible with both UIKit and SwiftUI applications and includes Combine publishers for applications using reactive patterns. The SnapAPI Kotlin SDK targets Android API level 21 and later, published to Maven Central as com.snapapi:snapapi-kotlin. The SDK uses Kotlin Coroutines with suspend functions for all API calls, integrates with OkHttp for HTTP client configuration, and includes Kotlin Flow variants of all methods for reactive stream integration in modern Android applications using Flow for data streams.