Screenshot API
for C# and .NET

using System.Net.Http;
using System.Web;

var query = HttpUtility.ParseQueryString(string.Empty);
query["url"] = "https://example.com";
query["format"] = "png";
query["width"] = "1280";
query["height"] = "800";

using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(60) };
http.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("SNAPRENDER_API_KEY"));

var response = await http.GetAsync($"https://app.snap-render.com/v1/screenshot?{query}");

if (!response.IsSuccessStatusCode)
{
    // Body is JSON: {"error":{"code":"...","message":"...","status":429}}
    throw new InvalidOperationException(
        $"SnapRender {(int)response.StatusCode}: {await response.Content.ReadAsStringAsync()}");
}

await File.WriteAllBytesAsync("screenshot.png", await response.Content.ReadAsByteArrayAsync());

using System.Net;
using System.Text.Json;

public sealed class SnapRenderClient
{
    private readonly HttpClient _http;

    public SnapRenderClient(HttpClient http, IConfiguration config)
    {
        _http = http;
        _http.BaseAddress = new Uri("https://app.snap-render.com");
        _http.DefaultRequestHeaders.Add("X-API-Key", config["SnapRender:ApiKey"]);
        _http.Timeout = TimeSpan.FromSeconds(60);
    }

    public async Task<byte[]> CaptureAsync(string url, IDictionary<string, string>? options = null, CancellationToken ct = default)
    {
        var parts = new List<string> { $"url={Uri.EscapeDataString(url)}" };
        foreach (var (key, value) in options ?? new Dictionary<string, string>())
            parts.Add($"{key}={Uri.EscapeDataString(value)}");

        var response = await _http.GetAsync($"/v1/screenshot?{string.Join("&", parts)}", ct);

        if (response.IsSuccessStatusCode)
        {
            if (response.Headers.TryGetValues("X-Cache", out var cache))
                Console.WriteLine($"cache: {cache.First()}");
            return await response.Content.ReadAsByteArrayAsync(ct);
        }

        var json = await response.Content.ReadAsStringAsync(ct);
        var error = JsonDocument.Parse(json).RootElement.GetProperty("error");
        var code = error.GetProperty("code").GetString();
        var message = error.GetProperty("message").GetString();

        throw response.StatusCode switch
        {
            // RATE_LIMITED: per-minute burst, retry after a minute. QUOTA_EXCEEDED: monthly limit, do not retry.
            HttpStatusCode.TooManyRequests => new InvalidOperationException($"{code}: {message}"),
            // INVALID_URL, BLOCKED_URL, or a bad key: fix the input.
            HttpStatusCode.BadRequest or HttpStatusCode.Unauthorized => new ArgumentException($"{code}: {message}"),
            _ => new HttpRequestException($"SnapRender {(int)response.StatusCode} {code}: {message}"),
        };
    }
}

// Program.cs
builder.Services.AddHttpClient<SnapRenderClient>();

// Anywhere with DI
var jpeg = await snapRender.CaptureAsync("https://example.com", new Dictionary<string, string>
{
    ["format"] = "jpeg", ["quality"] = "85", ["full_page"] = "true",
    ["device"] = "iphone_15_pro", ["dark_mode"] = "true",
    ["cache"] = "true", ["cache_ttl"] = "3600",
});

app.MapGet("/reports/{id}/pdf", async (string id, SnapRenderClient snapRender) =>
{
    var pdf = await snapRender.CaptureAsync($"https://example.com/reports/{id}", new Dictionary<string, string>
    {
        ["format"] = "pdf", ["full_page"] = "true", ["width"] = "1024",
    });
    return Results.File(pdf, "application/pdf", $"report-{id}.pdf");
});