Scraper API · Page Summary

Page Summary

POST /api/summary

https://api.sneakypeekai.com

Send a public page address in the JSON body and get a structured brief: title, a human-readable summary paragraph, key points, topics, audience, insights, and related fields. You may also send optional proxy, userAgent, and viewport for that request.

Uses 1 credit plus 1 request from your per-minute and daily caps. Only one scraper job runs at a time on this host. Credits refund on HTTP 4xx/5xx.

Authentication

Authenticate requests by sending your API key in the X-API-Key HTTP request header.

Mint and manage API keys in your Sneaky Peek AI Account → API Keys.

X-API-Key: $API_KEY

Parameters

Name	In	Type	Required	Notes
`X-API-Key`	header	`string`	yes	Your API key. Missing or wrong key returns 401.
`url`	body	`string`	yes	Public web page address (http or https).
`proxy`	body	`string`	no	Optional proxy URL for this request.
`userAgent`	body	`string`	no	Optional browser user agent for this request. user_agent is also accepted. Leave out to use the current desktop browser user agent.
`viewport`	body	`object or string`	no	Optional size as {"width":1920,"height":1080} or 1920x1080.

Request Example (curl)

curl -X POST "https://api.sneakypeekai.com/api/summary" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

Success Response Example (200 OK)

{
  "success": true,
  "url": "https://example.com",
  "finalUrl": "https://example.com/",
  "title": "Example Domain",
  "author": "",
  "publisher": "IANA",
  "pageType": "docs",
  "language": "en",
  "publishedAt": "",
  "summary": "This page explains example.com, a reserved domain used for documentation and examples.",
  "keyPoints": ["example.com is reserved for documentation"],
  "topics": ["documentation"],
  "audience": "Developers looking for a safe example URL",
  "insights": ["The page is a short reference, not a product or news article"],
  "callToAction": "",
  "timestamp": "2026-08-23T18:00:00.000Z"
}

Common Error Status Codes

Status Code	When / Description
`400`	The page address is missing or is not a public http or https site.
`401`	The API key is missing or invalid.
`402`	Insufficient credits for this call.
`408`	The page took too long to fetch or summarize.
`429`	You hit a key limit, another job is running, or the AI provider quota is exhausted (message includes 'quota exhausted').
`500`	The page could not be summarized.