Site Audit

POST /v1/site-audit

curl -X POST https://api.snapsharp.dev/v1/site-audit \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://linear.app", "format": "json"}'

{
  "url": "https://linear.app",
  "screenshot_url": "data:image/png;base64,...",
  "extracted_at": "2026-03-27T12:00:00Z",

  "colors": {
    "primary": ["#5E6AD2", "#4B50C8"],
    "background": ["#000000", "#111111"],
    "text": ["#FFFFFF", "#B4B4B4"],
    "accent": ["#EB5757"],
    "all_unique": ["#000000", "#5E6AD2", "#FFFFFF", "..."]
  },

  "fonts": {
    "families": [
      { "name": "Inter", "usage": "body", "count": 147, "weights": [400, 500, 600, 700] },
      { "name": "JetBrains Mono", "usage": "code", "count": 23, "weights": [400] }
    ],
    "total_unique": 2
  },

  "headings": [
    {
      "tag": "h1",
      "text": "Linear is a better way to build products",
      "font_size": "56px",
      "font_weight": "700",
      "color": "#FFFFFF",
      "font_family": "Inter"
    }
  ],

  "typography": {
    "body_font_size": "16px",
    "body_line_height": "1.6",
    "heading_scale": [56, 40, 24, 20]
  },

  "stack": {
    "css_framework": "Tailwind CSS",
    "js_framework": "Next.js",
    "ui_library": null,
    "detection_confidence": 0.95,
    "signals": [
      { "tech": "Next.js", "signal": "__NEXT_DATA__ script tag found", "confidence": 0.95 },
      { "tech": "Tailwind CSS", "signal": "Utility class patterns detected", "confidence": 0.9 },
      { "tech": "Vercel", "signal": "x-vercel-id header detected", "confidence": 0.85 }
    ]
  },

  "meta": {
    "title": "Linear – A better way to build products",
    "description": "Linear streamlines issues, sprints, and product roadmaps...",
    "favicon_url": "https://linear.app/favicon.ico",
    "og_image": "https://linear.app/og-image.png",
    "language": "en",
    "viewport": "width=device-width, initial-scale=1"
  }
}

curl -X POST https://api.snapsharp.dev/v1/site-audit \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://linear.app", "format": "png"}' \
  --output site-book.png

curl -X POST https://api.snapsharp.dev/v1/site-audit \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://linear.app", "format": "pdf"}' \
  --output site-audit-linear.app.pdf

{
  "accessibility": {
    "images_without_alt": 3,
    "total_images": 24,
    "links_without_text": 1,
    "headings_order_valid": true,
    "lang_attribute": "en",
    "has_skip_link": false,
    "color_contrast_issues": 2,
    "aria_landmarks": ["banner", "main", "contentinfo"],
    "total_interactive_elements": 18,
    "interactive_without_label": 0
  }
}

// Node.js
import { SnapSharp } from '@snapsharp/sdk';

const snap = new SnapSharp('sk_live_...');
const audit = await snap.siteAudit('https://linear.app', {
  format: 'json',
  sections: ['colors', 'fonts', 'stack', 'accessibility'],
});

console.log(audit.stack.js_framework); // "Next.js"
console.log(audit.colors.primary);     // ["#5E6AD2", ...]
console.log(audit.accessibility.images_without_alt); // 3

# Python
from snapsharp import SnapSharp

snap = SnapSharp("sk_live_...")
audit = snap.site_audit(
    "https://linear.app",
    format="json",
    sections=["colors", "fonts", "stack", "accessibility"],
)
print(audit["stack"]["css_framework"])  # "Tailwind CSS"
print(audit["accessibility"]["headings_order_valid"])  # True

// Go
package main

import (
    "fmt"
    snapsharp "github.com/bogdanov-igor/snapsharp/sdk-go"
)

func main() {
    client := snapsharp.New("sk_live_...")
    audit, _ := client.SiteAudit("https://linear.app",
        &snapsharp.SiteAuditParams{Format: "json"})
    fmt.Println(audit.Stack.JSFramework) // "Next.js"
}

<?php
// PHP
use SnapSharp\SnapSharp;

$snap = new SnapSharp('sk_live_...');
$audit = $snap->siteAudit('https://linear.app', [
    'format' => 'json',
]);
echo $audit['stack']['css_framework']; // "Tailwind CSS"

# Ruby
require "snapsharp"

snap = SnapSharp.new("sk_live_...")
audit = snap.site_audit("https://linear.app", format: "json")
puts audit["stack"]["js_framework"] # "Next.js"