{"openapi":"3.1.0","info":{"title":"Pagesnap API","version":"1.1.0","description":"Turn public HTTP(S) URLs into Markdown, structured data, images, PDFs, crawls, diffs, and monitors. Anonymous, API-key, agent-protocol, and x402 payment surfaces are described from the same runtime contract.","contact":{"url":"https://pagesnap.142-93-197-141.sslip.io/support"},"license":{"name":"Service terms","url":"https://pagesnap.142-93-197-141.sslip.io/terms"},"x-guidance":"For keyless USDC requests, call an /x402/v1 route once without payment, decode PAYMENT-REQUIRED, then retry the same request with PAYMENT-SIGNATURE."},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","servers":[{"url":"https://pagesnap.142-93-197-141.sslip.io"}],"tags":[{"name":"Content","description":"Reading and rendering"},{"name":"Crawl","description":"Site crawls and asynchronous jobs"},{"name":"Diff","description":"Two-page comparison"},{"name":"Monitors","description":"Persisted change monitoring"},{"name":"Account","description":"Keys, usage, referrals"},{"name":"Billing","description":"Checkout and receipts"},{"name":"Support","description":"Capability-based support tickets"},{"name":"Status","description":"Public health and stats"},{"name":"x402","description":"Keyless USDC per-call payment"},{"name":"Agents","description":"MCP and A2A protocols"},{"name":"Discovery","description":"Machine-readable discovery resources"}],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"ps_live_…","description":"Pagesnap API key."},"apiHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"apiQuery":{"type":"apiKey","in":"query","name":"key","description":"Compatibility only; headers avoid key leakage in URLs."},"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 exact EIP-3009 USDC authorization on Base; X-PAYMENT is a legacy alias."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["MISSING_URL","INVALID_URL","INVALID_ACTIONS","MISSING_HTML","MISSING_URLS","BATCH_TOO_LARGE","BAD_REQUEST","INVALID_KEY","KEY_REQUIRED","KEY_DISABLED","BLOCKED_URL","TIMEOUT","ACTION_FAILED","TOO_LARGE","RESULT_TOO_LARGE","UNSUPPORTED","UNSUPPORTED_MEDIA","RATE_LIMITED","TARGET_BUSY","ANON_GLOBAL_QUOTA","DAILY_QUOTA","MONTHLY_QUOTA","CONCURRENCY","KEY_LIMIT","KEY_SPIKE_LIMIT","BUSY","ENGINE_UNAVAILABLE","NAV_FAILED","HTTP_ERROR","BROWSER_ERROR","JOB_QUEUE_FULL","JOB_NOT_FOUND","JOB_NOT_READY","RESULT_UNAVAILABLE","INVALID_MODE","MONITOR_LIMIT","MONITOR_NOT_FOUND","MONITOR_RUNNING","MONITOR_PAUSED","PLAN_INTERVAL","SNAPSHOT_TOO_LARGE","INVALID_INTERVAL","INVALID_THRESHOLD","INVALID_SELECTOR","INVALID_PLAN","CHECKOUT_CONTEXT_REQUIRED","CHECKOUT_KEY_LIMIT","CHECKOUT_IP_LIMIT","BILLING_UNAVAILABLE","INVOICE_UNAVAILABLE","ORDER_NOT_FOUND","INVOICE_NOT_FOUND","PAYMENT_REPLAY","FACILITATOR_UNAVAILABLE","SETTLEMENT_UNVERIFIED","TICKET_LIMIT","NOT_FOUND","INTERNAL"]},"message":{"type":"string"},"reason":{"type":"string","enum":["bot_protection","interactive_challenge","ip_policy_or_geo_block"]},"upstream_status":{"type":"integer","minimum":100,"maximum":599}}}}},"Actions":{"type":"array","maxItems":10,"items":{"oneOf":[{"type":"object","additionalProperties":false,"required":["type","selector"],"properties":{"type":{"enum":["click","hover","hide","remove"]},"selector":{"type":"string","minLength":1,"maxLength":1000}}},{"type":"object","additionalProperties":false,"required":["type","selector","value"],"properties":{"type":{"const":"fill"},"selector":{"type":"string","minLength":1,"maxLength":1000},"value":{"type":"string","maxLength":100000}}},{"type":"object","additionalProperties":false,"required":["type","selector","value"],"properties":{"type":{"const":"select"},"selector":{"type":"string","minLength":1,"maxLength":1000},"value":{"oneOf":[{"type":"string","maxLength":10000},{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","maxLength":10000}}]}}},{"type":"object","additionalProperties":false,"required":["type","key"],"properties":{"type":{"const":"press"},"selector":{"type":"string","minLength":1,"maxLength":1000},"key":{"type":"string","minLength":1,"maxLength":100}}},{"type":"object","additionalProperties":false,"required":["type"],"oneOf":[{"required":["selector"]},{"anyOf":[{"required":["x"]},{"required":["y"]}]}],"properties":{"type":{"const":"scroll"},"selector":{"type":"string","minLength":1,"maxLength":1000},"x":{"type":"number","minimum":-100000,"maximum":100000},"y":{"type":"number","minimum":-100000,"maximum":100000}}},{"type":"object","additionalProperties":false,"required":["type","ms"],"properties":{"type":{"const":"wait"},"ms":{"type":"integer","minimum":0,"maximum":5000}}},{"type":"object","additionalProperties":false,"required":["type","selector"],"properties":{"type":{"const":"wait_for"},"selector":{"type":"string","minLength":1,"maxLength":1000},"state":{"type":"string","enum":["attached","detached","visible","hidden"],"default":"visible"}}},{"type":"object","additionalProperties":false,"required":["type","width","height"],"properties":{"type":{"const":"set_viewport"},"width":{"type":"integer","minimum":200,"maximum":3840},"height":{"type":"integer","minimum":200,"maximum":10000}}}]}},"ReadResult":{"type":"object","required":["ok"],"additionalProperties":true,"properties":{"ok":{"const":true},"title":{"type":"string"},"finalUrl":{"type":"string","format":"uri"},"markdown":{"type":"string"},"text":{"type":"string"},"html":{"type":"string"},"tokensEstimate":{"type":"integer","minimum":0},"rawBytes":{"type":"integer","minimum":0,"description":"Fetched or rendered source bytes before extraction."},"pdfPages":{"type":"integer","minimum":1},"pdfPagesProcessed":{"type":"integer","minimum":0},"noTextLayer":{"type":"boolean","description":"True when a PDF contains no extractable text layer; Pagesnap does not pretend OCR occurred."},"truncated":{"type":"boolean"},"links":{"type":"array","items":{"type":"object"}},"images":{"type":"array","items":{"type":"object"}}}},"MetaResult":{"type":"object","required":["ok"],"additionalProperties":true,"properties":{"ok":{"const":true},"title":{"type":"string"},"description":{"type":"string"},"image":{"type":["string","null"]},"favicon":{"type":["string","null"]},"siteName":{"type":["string","null"]},"canonical":{"type":["string","null"]},"finalUrl":{"type":"string"},"status":{"type":"integer"},"author":{"type":["string","null"]},"publishedTime":{"type":["string","null"]},"twitter":{"type":"object"}}},"ExtractResult":{"type":"object","required":["ok"],"additionalProperties":true,"properties":{"ok":{"const":true},"jsonLd":{"type":"array","items":{}},"microdata":{"type":"array","items":{}},"rdfa":{"type":"array","items":{}},"products":{"type":"array","items":{}},"articles":{"type":"array","items":{}},"breadcrumbs":{"type":"array","items":{}},"faqs":{"type":"array","items":{}}}},"BatchResult":{"type":"object","required":["ok","count","results"],"properties":{"ok":{"type":"boolean"},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","required":["url","ok"],"additionalProperties":true,"properties":{"url":{"type":"string"},"ok":{"type":"boolean"},"content":{},"error":{"type":"string"}}}}}},"CrawlPage":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string"},"finalUrl":{"type":"string"},"title":{"type":"string"},"depth":{"type":"integer"},"markdown":{"type":"string"}}},"CrawlResult":{"type":"object","required":["pages","stats","robots"],"properties":{"pages":{"type":"array","items":{"$ref":"#/components/schemas/CrawlPage"}},"stats":{"type":"object","additionalProperties":true},"robots":{"type":"object","additionalProperties":true}}},"LlmsTxtResult":{"type":"object","required":["llms_txt","llms_full_txt","pages","stats","robots"],"properties":{"llms_txt":{"type":"string"},"llms_full_txt":{"type":"string"},"pages":{"type":"array","items":{"$ref":"#/components/schemas/CrawlPage"}},"stats":{"type":"object","additionalProperties":true},"robots":{"type":"object","additionalProperties":true}}},"CrawlAccepted":{"type":"object","required":["job_id","status_url"],"properties":{"job_id":{"type":"string"},"status_url":{"type":"string"}}},"CrawlJob":{"type":"object","required":["status","progress","result_url"],"properties":{"status":{"type":"string","enum":["queued","running","done","failed"]},"progress":{"type":["object","null"],"additionalProperties":true},"result_url":{"type":["string","null"]},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"VisualDiff":{"type":"object","required":["ok","mode","percent_changed","bounding_boxes","diff_image","urls"],"properties":{"ok":{"const":true},"mode":{"const":"visual"},"percent_changed":{"type":"number"},"bounding_boxes":{"type":"array","items":{"type":"object"}},"diff_image":{"type":"string","format":"uri"},"urls":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":2}}},"TextDiff":{"type":"object","required":["ok","mode","percent_changed","added","removed"],"properties":{"ok":{"const":true},"mode":{"const":"text"},"percent_changed":{"type":"number"},"added":{"type":"array","items":{"type":"string"}},"removed":{"type":"array","items":{"type":"string"}}}},"MonitorInput":{"type":"object","additionalProperties":true,"required":["url"],"properties":{"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"mode":{"type":"string","enum":["text","visual","meta"],"default":"text"},"interval":{"type":"string","enum":["1h","6h","24h"],"default":"24h"},"selector":{"type":"string","maxLength":1000},"threshold_percent":{"type":"number","minimum":0,"maximum":100,"default":1},"webhook_url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"screenshot_options":{"type":"object","properties":{"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"width":{"type":"integer","minimum":200,"maximum":3840,"default":1280},"height":{"type":"integer","minimum":200,"maximum":10000,"default":800},"full_page":{"type":"boolean","default":false},"format":{"type":"string","enum":["png","jpeg","jpg","webp"],"default":"png"},"quality":{"type":"integer","minimum":1,"maximum":100,"default":80},"scale":{"type":"number","minimum":1,"maximum":3,"default":1},"dark":{"type":"boolean","default":false},"wait":{"type":"integer","minimum":0,"maximum":10000,"default":0},"wait_until":{"type":"string","enum":["load","domcontentloaded","networkidle"]},"block_ads":{"type":"boolean","default":true},"hide_cookie_banners":{"type":"boolean","default":true},"timeout":{"type":"integer","minimum":3000,"maximum":45000,"default":25000},"selector":{"type":"string","maxLength":200},"device":{"type":"string","maxLength":40},"user_agent":{"type":"string","maxLength":300},"actions":{"$ref":"#/components/schemas/Actions"},"lang":{"type":"string","maxLength":35,"default":"en-US"},"timezone":{"type":"string","default":"UTC"}}}}},"Monitor":{"type":"object","required":["id","url","mode","interval","threshold_percent","status"],"additionalProperties":true,"properties":{"id":{"type":"string"},"url":{"type":"string"},"mode":{"type":"string","enum":["text","visual","meta"]},"interval":{"type":"string","enum":["1h","6h","24h"]},"selector":{"type":["string","null"]},"threshold_percent":{"type":"number"},"webhook_url":{"type":["string","null"]},"webhook_enabled":{"type":"boolean"},"webhook_failures":{"type":"integer"},"webhook_note":{"type":["string","null"]},"screenshot_options":{"type":"object"},"status":{"type":"string","enum":["active","paused"]},"paused_reason":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"next_check_at":{"type":"string","format":"date-time"},"last_checked_at":{"type":["string","null"]},"last_changed_at":{"type":["string","null"]},"last_check":{"type":["object","null"]}}},"MonitorWithSecret":{"allOf":[{"$ref":"#/components/schemas/Monitor"},{"type":"object","required":["webhook_secret"],"properties":{"webhook_secret":{"type":"string","writeOnly":true}}}]},"MonitorWithChecks":{"allOf":[{"$ref":"#/components/schemas/Monitor"},{"type":"object","properties":{"checks":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"ts":{"type":"string","format":"date-time"},"changed":{"type":"boolean"},"percent":{"type":"number"},"error":{"type":["string","null"]},"snapshot_url":{"type":["string","null"]},"diff_url":{"type":["string","null"]}}}}}}]},"MonitorCheckResult":{"allOf":[{"$ref":"#/components/schemas/Monitor"},{"type":"object","properties":{"check":{"type":"object","properties":{"ts":{"type":"string","format":"date-time"},"changed":{"type":"boolean"},"percent":{"type":"number"},"snapshot_url":{"type":["string","null"]},"diff_url":{"type":["string","null"]},"webhook":{"type":["object","null"]}}}}}]},"KeyCreated":{"type":"object","required":["ok","key","plan","trial","limits"],"additionalProperties":true,"properties":{"ok":{"const":true},"key":{"type":"string","writeOnly":true},"plan":{"type":"string","enum":["free","pro"]},"trial":{"type":"boolean"},"plan_expires_at":{"type":["integer","null"],"description":"Unix milliseconds; normally seven days after creation for a trial."},"limits":{"type":"object"},"referral_bonus":{"type":"object"}}},"LinkGrant":{"type":"object","required":["page_url","status","granted_at","pro_expires_at","last_checked_at","next_check_at"],"properties":{"page_url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"status":{"type":"string","enum":["active","missing","error"]},"granted_at":{"type":"integer"},"pro_expires_at":{"type":"integer"},"last_checked_at":{"type":"integer"},"next_check_at":{"type":"integer"}}},"LinkGrantResponse":{"type":"object","required":["ok","plan","grant"],"properties":{"ok":{"const":true},"plan":{"const":"pro"},"grant":{"$ref":"#/components/schemas/LinkGrant"},"dashboard":{"type":"string","format":"uri"}}},"Account":{"type":"object","required":["ok","plan","limits","usage"],"additionalProperties":true,"properties":{"ok":{"const":true},"plan":{"type":"string"},"trial":{"type":"boolean"},"trial_days_remaining":{"type":"integer"},"link_grant":{"anyOf":[{"$ref":"#/components/schemas/LinkGrant"},{"type":"null"}]},"limits":{"type":"object"},"usage":{"type":"object"},"orders":{"type":"array","items":{"type":"object"}},"referral":{"type":["object","null"]}}},"CheckoutOption":{"type":"object","required":["chain","chain_id","token","address","amount","pay_uri"],"properties":{"chain":{"type":"string"},"chain_id":{"type":"integer"},"token":{"type":"string"},"contract":{"type":["string","null"]},"address":{"type":"string"},"amount":{"type":"string"},"pay_uri":{"type":"string"}}},"Checkout":{"type":"object","required":["ok","order_id","pay_url","status_url","amount_usd","expires_at","options"],"properties":{"ok":{"const":true},"order_id":{"type":"string"},"pay_url":{"type":"string"},"status_url":{"type":"string"},"amount_usd":{"type":"number"},"expires_at":{"type":"string","format":"date-time"},"options":{"type":"array","items":{"$ref":"#/components/schemas/CheckoutOption"}}}},"CheckoutStatus":{"type":"object","required":["status","plan"],"additionalProperties":true,"properties":{"status":{"type":"string"},"plan":{"type":"string"},"plan_expires_at":{"type":["string","null"],"format":"date-time"},"tx":{"type":["object","string","null"]},"shortfall":{"type":["object","null"]}}},"SupportInput":{"type":"object","additionalProperties":false,"required":["subject","message"],"properties":{"subject":{"type":"string","minLength":1,"maxLength":160},"category":{"type":"string","enum":["general","technical","billing","takedown","oss"],"default":"general"},"message":{"type":"string","minLength":1,"maxLength":5000},"contact":{"type":"string","maxLength":200},"key_prefix":{"type":"string","maxLength":16,"description":"Never send a complete API key."}}},"SupportTicketResponse":{"type":"object","required":["ok","ticket"],"additionalProperties":true,"properties":{"ok":{"const":true},"ticket_url":{"type":"string"},"ticket":{"type":"object","additionalProperties":true},"messages":{"type":"array","items":{"type":"object"}}}},"StatusRatio":{"type":"object","required":["percent","total","ok"],"properties":{"percent":{"type":["number","null"]},"total":{"type":"integer"},"ok":{"type":"integer"}}},"Status":{"type":"object","required":["ok","generated_at","status","uptime","daily","latency","queues"],"properties":{"ok":{"type":"boolean"},"generated_at":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["operational","degraded"]},"uptime":{"type":"object","properties":{"today":{"$ref":"#/components/schemas/StatusRatio"},"last_7_days":{"$ref":"#/components/schemas/StatusRatio"},"last_30_days":{"$ref":"#/components/schemas/StatusRatio"},"last_90_days":{"$ref":"#/components/schemas/StatusRatio"}}},"daily":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string","format":"date"},"ok":{"type":"integer"},"total":{"type":"integer"},"percent":{"type":["number","null"]}}}},"latency":{"type":"object"},"queues":{"type":"object"},"latest_incident":{"type":["object","null"]}}},"JsonRpcRequest":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{},"method":{"type":"string"},"params":{"type":"object"}}},"JsonRpcResponse":{"type":"object","required":["jsonrpc","id"],"properties":{"jsonrpc":{"const":"2.0"},"id":{},"result":{},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}},"responses":{"BadRequest":{"description":"Invalid or missing input.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Missing or invalid credentials.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Disabled key, plan restriction, or blocked target.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Timeout":{"description":"Target or action timed out.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"Current resource state conflicts with the request.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"TooLarge":{"description":"Request or stored result is too large.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"UnsupportedMedia":{"description":"Unsupported request content type.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unprocessable":{"description":"Input is understood but unsupported or cannot be processed.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Caller, quota, concurrency, or target-host limit reached.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Resource not found or expired.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Internal":{"description":"Internal failure.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"UpstreamFailure":{"description":"Target or rendering engine failed.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Capacity, facilitator, billing, or engine temporarily unavailable.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds to wait when supplied."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"x-pagesnap-limits":{"quotaUnits":{"read":1,"screenshot":1,"pdf":1,"meta":1,"extract":1,"render":1,"diff":2,"batch":"one per URL","crawl":"one per reserved page","llmsTxt":"one per reserved page","monitorCheck":1},"planCrawlCaps":{"anon":5,"free":25,"starter":50,"pro":200,"scale":200},"synchronousCrawlPages":25,"target":{"perMin":60,"concurrency":3},"monitorCaps":{"free":2,"starter":10,"pro":50,"scale":200},"jobRetentionHours":24,"temporaryLinkHours":1},"paths":{"/v1/read":{"get":{"operationId":"readUrl","summary":"Read a public URL","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["markdown","md","text","html","json","aria","links"],"default":"markdown"},"description":"Output representation. md aliases markdown; aria forces browser rendering."},{"name":"render","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Force browser rendering."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":20000},"description":"Overall timeout."},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Extra post-load wait."},{"name":"links","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Include links in JSON output."},{"name":"images","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Include images in JSON output."},{"name":"full","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Extract the full body rather than main content."},{"name":"max_chars","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":2000000},"description":"Truncate Markdown at this character count and return a marker."},{"name":"page_markers","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"For PDFs, add optional <!-- page N --> markers."},{"name":"actions","in":"query","required":false,"schema":{"type":"string","contentMediaType":"application/json"},"description":"JSON-encoded array of at most 10 pre-capture actions. Prefer a POST JSON body."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"Extracted page content.","content":{"text/markdown":{"schema":{"type":"string"}},"text/plain":{"schema":{"type":"string"}},"text/html":{"schema":{"type":"string"}},"text/yaml":{"schema":{"type":"string","description":"ARIA accessibility snapshot."}},"application/json":{"schema":{"$ref":"#/components/schemas/ReadResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}},"post":{"operationId":"readUrlPost","summary":"Read a URL with a JSON options body","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"description":"Query parameters and body fields are merged; body values win.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["url"],"properties":{"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"format":{"type":"string","enum":["markdown","md","text","html","json","aria","links"],"default":"markdown"},"render":{"type":"boolean","default":false},"timeout":{"type":"integer","minimum":3000,"maximum":45000,"default":20000},"wait":{"type":"integer","minimum":0,"maximum":10000,"default":0},"links":{"type":"boolean","default":true},"images":{"type":"boolean","default":true},"full":{"type":"boolean","default":false},"max_chars":{"type":"integer","minimum":100,"maximum":2000000},"page_markers":{"type":"boolean","default":false},"actions":{"$ref":"#/components/schemas/Actions"},"lang":{"type":"string","maxLength":35,"default":"en-US"},"timezone":{"type":"string","default":"UTC"}}}}}},"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"Extracted page content.","content":{"text/markdown":{"schema":{"type":"string"}},"text/plain":{"schema":{"type":"string"}},"text/html":{"schema":{"type":"string"}},"text/yaml":{"schema":{"type":"string","description":"ARIA accessibility snapshot."}},"application/json":{"schema":{"$ref":"#/components/schemas/ReadResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/screenshot":{"get":{"operationId":"screenshotUrl","summary":"Capture a public URL","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"width","in":"query","required":false,"schema":{"type":"integer","minimum":200,"maximum":3840,"default":1280},"description":"Viewport width in CSS pixels."},{"name":"height","in":"query","required":false,"schema":{"type":"integer","minimum":200,"maximum":10000,"default":800},"description":"Viewport height."},{"name":"full_page","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Capture the full scrollable page."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["png","jpeg","jpg","webp"],"default":"png"},"description":"Image format; jpg aliases jpeg."},{"name":"quality","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":80},"description":"JPEG/WebP quality."},{"name":"scale","in":"query","required":false,"schema":{"type":"number","minimum":1,"maximum":3,"default":1},"description":"Device scale factor."},{"name":"dark","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Emulate dark color scheme."},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Extra post-load wait in milliseconds."},{"name":"wait_until","in":"query","required":false,"schema":{"type":"string","enum":["load","domcontentloaded","networkidle"]},"description":"Navigation completion event."},{"name":"block_ads","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Block known ad/tracker requests."},{"name":"hide_cookie_banners","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Hide common cookie banners."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":25000},"description":"Overall timeout in milliseconds."},{"name":"selector","in":"query","required":false,"schema":{"type":"string","maxLength":200},"description":"CSS selector to clip."},{"name":"device","in":"query","required":false,"schema":{"type":"string","maxLength":40},"description":"Playwright device name."},{"name":"user_agent","in":"query","required":false,"schema":{"type":"string","maxLength":300},"description":"Custom user agent."},{"name":"actions","in":"query","required":false,"schema":{"type":"string","contentMediaType":"application/json"},"description":"JSON-encoded array of at most 10 pre-capture actions. Prefer a POST JSON body."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"Screenshot bytes.","content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}},"post":{"operationId":"screenshotUrlPost","summary":"Capture a URL with a JSON options body","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["url"],"properties":{"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"width":{"type":"integer","minimum":200,"maximum":3840,"default":1280},"height":{"type":"integer","minimum":200,"maximum":10000,"default":800},"full_page":{"type":"boolean","default":false},"format":{"type":"string","enum":["png","jpeg","jpg","webp"],"default":"png"},"quality":{"type":"integer","minimum":1,"maximum":100,"default":80},"scale":{"type":"number","minimum":1,"maximum":3,"default":1},"dark":{"type":"boolean","default":false},"wait":{"type":"integer","minimum":0,"maximum":10000,"default":0},"wait_until":{"type":"string","enum":["load","domcontentloaded","networkidle"]},"block_ads":{"type":"boolean","default":true},"hide_cookie_banners":{"type":"boolean","default":true},"timeout":{"type":"integer","minimum":3000,"maximum":45000,"default":25000},"selector":{"type":"string","maxLength":200},"device":{"type":"string","maxLength":40},"user_agent":{"type":"string","maxLength":300},"actions":{"$ref":"#/components/schemas/Actions"},"lang":{"type":"string","maxLength":35,"default":"en-US"},"timezone":{"type":"string","default":"UTC"}}}}}},"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"Screenshot bytes.","content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/pdf":{"get":{"operationId":"pdfUrl","summary":"Render a public URL as PDF","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["A4","A3","A5","Letter","Legal","Tabloid"],"default":"A4"},"description":"Paper size."},{"name":"landscape","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Landscape orientation."},{"name":"margin","in":"query","required":false,"schema":{"type":"string","maxLength":30,"default":"10mm"},"description":"One CSS length used on all sides."},{"name":"print_background","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Print backgrounds."},{"name":"scale","in":"query","required":false,"schema":{"type":"number","minimum":0.1,"maximum":2,"default":1},"description":"Print scale."},{"name":"page_ranges","in":"query","required":false,"schema":{"type":"string","maxLength":50},"description":"Chromium page-range expression, for example 1-3,5."},{"name":"device","in":"query","required":false,"schema":{"type":"string","maxLength":40},"description":"Playwright device name."},{"name":"header","in":"query","required":false,"schema":{"type":"string","maxLength":2048},"description":"Sanitized header template."},{"name":"footer","in":"query","required":false,"schema":{"type":"string","maxLength":2048},"description":"Sanitized footer template."},{"name":"page_numbers","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Add Page X of Y; cannot be combined with footer."},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Extra post-load wait."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":30000},"description":"Overall timeout."},{"name":"actions","in":"query","required":false,"schema":{"type":"string","contentMediaType":"application/json"},"description":"JSON-encoded array of at most 10 pre-capture actions. Prefer a POST JSON body."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"PDF bytes.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}},"post":{"operationId":"pdfUrlPost","summary":"Render a URL as PDF with a JSON options body","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["url"],"properties":{"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"format":{"type":"string","enum":["A4","A3","A5","Letter","Legal","Tabloid"],"default":"A4"},"landscape":{"type":"boolean","default":false},"margin":{"type":"string","maxLength":30,"default":"10mm"},"print_background":{"type":"boolean","default":true},"scale":{"type":"number","minimum":0.1,"maximum":2,"default":1},"page_ranges":{"type":"string","maxLength":50},"wait":{"type":"integer","minimum":0,"maximum":10000,"default":0},"timeout":{"type":"integer","minimum":3000,"maximum":45000,"default":30000},"device":{"type":"string","maxLength":40},"header":{"type":"string","maxLength":2048},"footer":{"type":"string","maxLength":2048},"page_numbers":{"type":"boolean","default":false},"actions":{"$ref":"#/components/schemas/Actions"},"lang":{"type":"string","maxLength":35,"default":"en-US"},"timezone":{"type":"string","default":"UTC"}}}}}},"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"PDF bytes.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/meta":{"get":{"operationId":"getMeta","summary":"Get link-preview metadata","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"Metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/extract":{"get":{"operationId":"extractStructured","summary":"Extract structured page data","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":20000},"description":"Overall timeout."}],"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"JSON-LD, microdata, RDFa-lite, social metadata, and normalized entities.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/r/{url}":{"get":{"operationId":"readShortcut","summary":"Read shortcut","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"url","in":"path","required":true,"schema":{"type":"string"},"description":"A slash-containing HTTP(S) URL appended after /r/."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["markdown","md","text","html","json","aria","links"],"default":"markdown"},"description":"Output representation. md aliases markdown; aria forces browser rendering."},{"name":"render","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Force browser rendering."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":20000},"description":"Overall timeout."},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Extra post-load wait."},{"name":"links","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Include links in JSON output."},{"name":"images","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Include images in JSON output."},{"name":"full","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Extract the full body rather than main content."},{"name":"max_chars","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":2000000},"description":"Truncate Markdown at this character count and return a marker."},{"name":"page_markers","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"For PDFs, add optional <!-- page N --> markers."},{"name":"actions","in":"query","required":false,"schema":{"type":"string","contentMediaType":"application/json"},"description":"JSON-encoded array of at most 10 pre-capture actions. Prefer a POST JSON body."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"Extracted page content.","content":{"text/markdown":{"schema":{"type":"string"}},"text/plain":{"schema":{"type":"string"}},"text/html":{"schema":{"type":"string"}},"text/yaml":{"schema":{"type":"string","description":"ARIA accessibility snapshot."}},"application/json":{"schema":{"$ref":"#/components/schemas/ReadResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/s/{url}":{"get":{"operationId":"screenshotShortcut","summary":"Screenshot shortcut","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"url","in":"path","required":true,"schema":{"type":"string"},"description":"A slash-containing HTTP(S) URL appended after /s/."},{"name":"width","in":"query","required":false,"schema":{"type":"integer","minimum":200,"maximum":3840,"default":1280},"description":"Viewport width in CSS pixels."},{"name":"height","in":"query","required":false,"schema":{"type":"integer","minimum":200,"maximum":10000,"default":800},"description":"Viewport height."},{"name":"full_page","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Capture the full scrollable page."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["png","jpeg","jpg","webp"],"default":"png"},"description":"Image format; jpg aliases jpeg."},{"name":"quality","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":80},"description":"JPEG/WebP quality."},{"name":"scale","in":"query","required":false,"schema":{"type":"number","minimum":1,"maximum":3,"default":1},"description":"Device scale factor."},{"name":"dark","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Emulate dark color scheme."},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Extra post-load wait in milliseconds."},{"name":"wait_until","in":"query","required":false,"schema":{"type":"string","enum":["load","domcontentloaded","networkidle"]},"description":"Navigation completion event."},{"name":"block_ads","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Block known ad/tracker requests."},{"name":"hide_cookie_banners","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Hide common cookie banners."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":25000},"description":"Overall timeout in milliseconds."},{"name":"selector","in":"query","required":false,"schema":{"type":"string","maxLength":200},"description":"CSS selector to clip."},{"name":"device","in":"query","required":false,"schema":{"type":"string","maxLength":40},"description":"Playwright device name."},{"name":"user_agent","in":"query","required":false,"schema":{"type":"string","maxLength":300},"description":"Custom user agent."},{"name":"actions","in":"query","required":false,"schema":{"type":"string","contentMediaType":"application/json"},"description":"JSON-encoded array of at most 10 pre-capture actions. Prefer a POST JSON body."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"Screenshot bytes.","content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/render":{"post":{"operationId":"renderHtml","summary":"Render supplied HTML","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["html"],"properties":{"html":{"type":"string","minLength":1,"maxLength":1500000},"type":{"type":"string","enum":["png","jpeg","jpg","webp","pdf"],"default":"png"},"width":{"type":"integer","minimum":200,"maximum":3840,"default":1280},"height":{"type":"integer","minimum":200,"maximum":10000,"default":800},"full_page":{"type":"boolean","default":false},"format":{"type":"string","enum":["A4","A3","A5","Letter","Legal","Tabloid"],"default":"A4"},"quality":{"type":"integer","minimum":1,"maximum":100,"default":80},"scale":{"type":"number","minimum":0.1,"maximum":2,"default":1},"dark":{"type":"boolean","default":false},"wait":{"type":"integer","minimum":0,"maximum":10000,"default":0},"wait_until":{"type":"string","enum":["load","domcontentloaded","networkidle"]},"block_ads":{"type":"boolean","default":true},"hide_cookie_banners":{"type":"boolean","default":true},"timeout":{"type":"integer","minimum":3000,"maximum":45000,"default":30000},"selector":{"type":"string","maxLength":200},"device":{"type":"string","maxLength":40},"user_agent":{"type":"string","maxLength":300},"actions":{"$ref":"#/components/schemas/Actions"},"lang":{"type":"string","maxLength":35,"default":"en-US"},"timezone":{"type":"string","default":"UTC"},"landscape":{"type":"boolean","default":false},"margin":{"type":"string","maxLength":30,"default":"10mm"},"print_background":{"type":"boolean","default":true},"page_ranges":{"type":"string","maxLength":50},"header":{"type":"string","maxLength":2048},"footer":{"type":"string","maxLength":2048},"page_numbers":{"type":"boolean","default":false}}}}}},"x-pagesnap-quota":{"units":1,"cacheHitsCharged":true},"responses":{"200":{"description":"Rendered image or PDF.","content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/batch":{"post":{"operationId":"batchRead","summary":"Read multiple URLs","tags":["Content"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"description":"Effective max items is the caller plan maxBatch.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["urls"],"properties":{"urls":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096}},"format":{"type":"string","enum":["markdown","text","json"],"default":"markdown"},"options":{"type":"object"}}}}}},"x-pagesnap-quota":{"units":"one-per-url","cacheHitsCharged":true},"responses":{"200":{"description":"Per-URL results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/crawl":{"post":{"operationId":"crawlSite","summary":"Crawl a public site","tags":["Crawl"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"description":"Crawl request. Plan caps: anonymous 5, free 25, starter 50, pro 200, scale 200.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"limit":{"type":"integer","minimum":1,"maximum":200,"default":20},"max_depth":{"type":"integer","minimum":0,"maximum":20,"default":3},"same_origin":{"type":"boolean","default":true},"include":{"oneOf":[{"type":"string","maxLength":500},{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","maxLength":500}}]},"exclude":{"oneOf":[{"type":"string","maxLength":500},{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","maxLength":500}}]},"use_sitemap":{"type":"boolean","default":true},"format":{"type":"string","enum":["markdown","json"],"default":"markdown"}}}}}},"x-pagesnap-quota":{"units":"one-per-reserved-page","cacheHitsCharged":true},"responses":{"200":{"description":"Synchronous crawl (effective limit at most 25).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrawlResult"}}}},"202":{"description":"Asynchronous crawl accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrawlAccepted"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/llms-txt":{"post":{"operationId":"generateLlmsTxt","summary":"Generate llms.txt and llms-full.txt","tags":["Crawl"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"description":"Generate llms.txt files using crawl plan caps, robots.txt, sitemaps, filters, and per-host delays.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"limit":{"type":"integer","minimum":1,"maximum":200,"default":20},"include":{"oneOf":[{"type":"string","maxLength":500},{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","maxLength":500}}]},"exclude":{"oneOf":[{"type":"string","maxLength":500},{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","maxLength":500}}]},"format":{"type":"string","enum":["json","txt"],"default":"json"}}}}}},"x-pagesnap-quota":{"units":"one-per-reserved-page","cacheHitsCharged":true},"responses":{"200":{"description":"Generated files. format=txt returns only llms.txt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LlmsTxtResult"}},"text/plain":{"schema":{"type":"string"}}}},"202":{"description":"Asynchronous generation accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrawlAccepted"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/jobs/{job_id}":{"get":{"operationId":"getCrawlJob","summary":"Poll a crawl job","tags":["Crawl"],"security":[],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","pattern":"^crawl_[A-Za-z0-9_-]{20,40}$"},"description":"Unguessable crawl job capability ID."}],"responses":{"200":{"description":"Job state and progress.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrawlJob"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/jobs/{job_id}/result":{"get":{"operationId":"getCrawlJobResult","summary":"Download a completed crawl or llms.txt generation","tags":["Crawl"],"security":[],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","pattern":"^crawl_[A-Za-z0-9_-]{20,40}$"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["ndjson","txt","full"]},"description":"Crawl supports ndjson; llms.txt jobs support txt or full."}],"responses":{"200":{"description":"Stored result (retained 24 hours, maximum 32 MiB).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CrawlResult"},{"$ref":"#/components/schemas/LlmsTxtResult"}]}},"application/x-ndjson":{"schema":{"type":"string"}},"text/plain":{"schema":{"type":"string"}}}},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/Internal"}}}},"/v1/diff":{"get":{"operationId":"diffUrls","summary":"Compare two public pages","tags":["Diff"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"url_a","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"url_b","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"mode","in":"query","required":false,"schema":{"type":"string","enum":["visual","text"],"default":"visual"},"description":"Comparison mode."},{"name":"width","in":"query","required":false,"schema":{"type":"integer","minimum":200,"maximum":3840,"default":1280},"description":"Viewport width in CSS pixels."},{"name":"height","in":"query","required":false,"schema":{"type":"integer","minimum":200,"maximum":10000,"default":800},"description":"Viewport height."},{"name":"full_page","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Capture the full scrollable page."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["png","jpeg","jpg","webp"],"default":"png"},"description":"Image format; jpg aliases jpeg."},{"name":"quality","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":80},"description":"JPEG/WebP quality."},{"name":"scale","in":"query","required":false,"schema":{"type":"number","minimum":1,"maximum":3,"default":1},"description":"Device scale factor."},{"name":"dark","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Emulate dark color scheme."},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Extra post-load wait in milliseconds."},{"name":"wait_until","in":"query","required":false,"schema":{"type":"string","enum":["load","domcontentloaded","networkidle"]},"description":"Navigation completion event."},{"name":"block_ads","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Block known ad/tracker requests."},{"name":"hide_cookie_banners","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Hide common cookie banners."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":25000},"description":"Overall timeout in milliseconds."},{"name":"selector","in":"query","required":false,"schema":{"type":"string","maxLength":200},"description":"CSS selector to clip."},{"name":"device","in":"query","required":false,"schema":{"type":"string","maxLength":40},"description":"Playwright device name."},{"name":"user_agent","in":"query","required":false,"schema":{"type":"string","maxLength":300},"description":"Custom user agent."},{"name":"actions","in":"query","required":false,"schema":{"type":"string","contentMediaType":"application/json"},"description":"JSON-encoded array of at most 10 pre-capture actions. Prefer a POST JSON body."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":2,"cacheHitsCharged":true},"responses":{"200":{"description":"Visual or text comparison.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/VisualDiff"},{"$ref":"#/components/schemas/TextDiff"}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/monitors":{"post":{"operationId":"createMonitor","summary":"Create a persisted monitor","tags":["Monitors"],"security":[{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorInput"}}}},"responses":{"201":{"description":"Monitor; webhook_secret appears only here.","content":{"application/json":{"schema":{"type":"object","required":["ok","monitor"],"properties":{"ok":{"const":true},"monitor":{"$ref":"#/components/schemas/MonitorWithSecret"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}},"get":{"operationId":"listMonitors","summary":"List monitors","tags":["Monitors"],"security":[{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"responses":{"200":{"description":"Owned monitors.","content":{"application/json":{"schema":{"type":"object","required":["ok","monitors"],"properties":{"ok":{"const":true},"monitors":{"type":"array","items":{"$ref":"#/components/schemas/Monitor"}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/monitors/{monitor_id}":{"get":{"operationId":"getMonitor","summary":"Get a monitor and recent checks","tags":["Monitors"],"security":[{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","pattern":"^mon_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Monitor and up to 50 checks.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"monitor":{"$ref":"#/components/schemas/MonitorWithChecks"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}},"delete":{"operationId":"deleteMonitor","summary":"Delete a monitor and snapshots","tags":["Monitors"],"security":[{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","pattern":"^mon_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Deleted monitor ID.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"deleted":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/monitors/{monitor_id}/check":{"post":{"operationId":"checkMonitor","summary":"Run a monitor check now","tags":["Monitors"],"security":[{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string"}}],"x-pagesnap-quota":{"units":1},"responses":{"200":{"description":"Monitor and check result.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"monitor":{"$ref":"#/components/schemas/MonitorCheckResult"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/monitors/{monitor_id}/pause":{"post":{"operationId":"pauseMonitor","summary":"Pause a monitor","tags":["Monitors"],"security":[{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paused monitor.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"monitor":{"$ref":"#/components/schemas/Monitor"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/monitors/{monitor_id}/resume":{"post":{"operationId":"resumeMonitor","summary":"Resume a monitor","tags":["Monitors"],"security":[{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Active monitor.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"monitor":{"$ref":"#/components/schemas/Monitor"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/keys":{"post":{"operationId":"createKey","summary":"Create an API key with an eligible 7-day Pro trial","tags":["Account"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string","maxLength":80},"email":{"type":"string","format":"email","maxLength":200},"ref":{"type":"string","description":"Optional referral code; its daily bonus begins after the Pro trial."}}}}}},"responses":{"201":{"description":"Raw key shown once, trial status, plan limits, and referral data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyCreated"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/link-verify":{"post":{"operationId":"verifyLinkGrant","summary":"Verify a public link and grant 90 days of Pro","description":"Fetches through the SSRF-safe HTTP path without browser rendering. Visible anchors, including nofollow, and raw URLs in rendered GitHub READMEs are accepted. Each page and key can earn once; one grant per requester IP hash per 30 days.","tags":["Account"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["key","page_url"],"properties":{"key":{"type":"string","writeOnly":true,"pattern":"^ps_live_"},"page_url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096}}}}}},"responses":{"200":{"description":"Pro link grant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkGrantResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"}}}},"/v1/me":{"get":{"operationId":"getAccount","summary":"Get plan, usage, orders, receipts, and referral data","tags":["Account"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"responses":{"200":{"description":"Caller account or anonymous usage.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/usage":{"get":{"operationId":"getUsage","summary":"Alias of /v1/me","tags":["Account"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"responses":{"200":{"description":"Caller account or anonymous usage.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/checkout":{"post":{"operationId":"createCheckout","summary":"Create a crypto upgrade invoice","tags":["Billing"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["plan"],"properties":{"plan":{"type":"string","enum":["starter","pro","scale"]},"key":{"type":"string","description":"Raw API key; omit when an authorization header identifies it."}}}}}},"responses":{"201":{"description":"Wallet-ready invoice.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Checkout"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/checkout/{order_id}":{"get":{"operationId":"getCheckout","summary":"Poll payment and plan activation","tags":["Billing"],"security":[],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Invoice and activation state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutStatus"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/pay/{order_id}/receipt.html":{"get":{"operationId":"getReceiptHtml","summary":"Get an HTML payment receipt","tags":["Billing"],"security":[],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Private-cacheable HTML receipt.","content":{"text/html":{"schema":{"type":"string"}}}},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/pay/{order_id}/receipt.pdf":{"get":{"operationId":"getReceiptPdf","summary":"Get a PDF payment receipt","tags":["Billing"],"security":[],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Private-cacheable PDF receipt.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Unprocessable"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/pay/{order_id}/status":{"get":{"operationId":"getPayPageStatus","summary":"Poll payment status from the browser pay flow","tags":["Billing"],"security":[],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Invoice and activation state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutStatus"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/support":{"post":{"operationId":"createSupportTicket","summary":"Open an accountless support ticket","tags":["Support"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportInput"}}}},"responses":{"201":{"description":"Ticket and unguessable capability URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportTicketResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/support/{ticket_id}":{"get":{"operationId":"getSupportTicket","summary":"Get a support ticket by capability ID","tags":["Support"],"security":[],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"string","pattern":"^t_[A-Za-z0-9_-]{32}$"}}],"responses":{"200":{"description":"Ticket and messages.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportTicketResponse"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/support/{ticket_id}/messages":{"post":{"operationId":"addSupportTicketMessage","summary":"Add a requester message","tags":["Support"],"security":[],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"string","pattern":"^t_[A-Za-z0-9_-]{32}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["message"],"properties":{"message":{"type":"string","minLength":1,"maxLength":5000}}}}}},"responses":{"201":{"description":"Updated ticket.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportTicketResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/stats":{"get":{"operationId":"getPublicStats","summary":"Get aggregate public service stats","tags":["Status"],"security":[],"responses":{"200":{"description":"Live aggregate counters.","content":{"application/json":{"schema":{"type":"object","required":["ok","generated_at"],"additionalProperties":true,"properties":{"ok":{"const":true},"generated_at":{"type":"string","format":"date-time"},"uptime":{"type":"string"},"inflight":{"type":"integer"}}}}}}}}},"/v1/status":{"get":{"operationId":"getPublicStatus","summary":"Get public uptime and latency status","tags":["Status"],"security":[],"responses":{"200":{"description":"60-second cached operational snapshot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Status"}}}}}}},"/healthz":{"get":{"operationId":"healthcheck","summary":"Get detailed process and engine health","tags":["Status"],"security":[],"responses":{"200":{"description":"Healthy.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Engine unhealthy.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/tmp/{name}":{"get":{"operationId":"getTemporaryResult","summary":"Download a temporary result","tags":["Content"],"security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]+\\.(png|jpe?g|webp|pdf|txt|json)$"}}],"responses":{"200":{"description":"Temporary file, normally valid one hour.","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}},"/x402/v1/read":{"get":{"operationId":"readUrlX402","summary":"Read a URL paid per call","tags":["x402"],"security":[{"x402":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["markdown","md","text","html","json","aria","links"],"default":"markdown"},"description":"Output representation. md aliases markdown; aria forces browser rendering."},{"name":"render","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Force browser rendering."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":20000},"description":"Overall timeout."},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Extra post-load wait."},{"name":"links","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Include links in JSON output."},{"name":"images","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Include images in JSON output."},{"name":"full","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Extract the full body rather than main content."},{"name":"max_chars","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":2000000},"description":"Truncate Markdown at this character count and return a marker."},{"name":"page_markers","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"For PDFs, add optional <!-- page N --> markers."},{"name":"actions","in":"query","required":false,"schema":{"type":"string","contentMediaType":"application/json"},"description":"JSON-encoded array of at most 10 pre-capture actions. Prefer a POST JSON body."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":0,"paidSeparately":true},"responses":{"200":{"description":"Extracted page content.","content":{"text/markdown":{"schema":{"type":"string"}},"text/plain":{"schema":{"type":"string"}},"text/html":{"schema":{"type":"string"}},"text/yaml":{"schema":{"type":"string","description":"ARIA accessibility snapshot."}},"application/json":{"schema":{"$ref":"#/components/schemas/ReadResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"x402 v2 exact payment required, invalid, or replayed. Decode PAYMENT-REQUIRED, sign the selected Base USDC requirement, and retry the request unchanged with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"required":true,"schema":{"type":"string"},"description":"Base64-encoded x402 payment requirements."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price":{"mode":"fixed","currency":"USD","amount":"0.002"}}}},"/x402/v1/screenshot":{"get":{"operationId":"screenshotUrlX402","summary":"Capture a URL paid per call","tags":["x402"],"security":[{"x402":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"width","in":"query","required":false,"schema":{"type":"integer","minimum":200,"maximum":3840,"default":1280},"description":"Viewport width in CSS pixels."},{"name":"height","in":"query","required":false,"schema":{"type":"integer","minimum":200,"maximum":10000,"default":800},"description":"Viewport height."},{"name":"full_page","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Capture the full scrollable page."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["png","jpeg","jpg","webp"],"default":"png"},"description":"Image format; jpg aliases jpeg."},{"name":"quality","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":80},"description":"JPEG/WebP quality."},{"name":"scale","in":"query","required":false,"schema":{"type":"number","minimum":1,"maximum":3,"default":1},"description":"Device scale factor."},{"name":"dark","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Emulate dark color scheme."},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Extra post-load wait in milliseconds."},{"name":"wait_until","in":"query","required":false,"schema":{"type":"string","enum":["load","domcontentloaded","networkidle"]},"description":"Navigation completion event."},{"name":"block_ads","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Block known ad/tracker requests."},{"name":"hide_cookie_banners","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Hide common cookie banners."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":25000},"description":"Overall timeout in milliseconds."},{"name":"selector","in":"query","required":false,"schema":{"type":"string","maxLength":200},"description":"CSS selector to clip."},{"name":"device","in":"query","required":false,"schema":{"type":"string","maxLength":40},"description":"Playwright device name."},{"name":"user_agent","in":"query","required":false,"schema":{"type":"string","maxLength":300},"description":"Custom user agent."},{"name":"actions","in":"query","required":false,"schema":{"type":"string","contentMediaType":"application/json"},"description":"JSON-encoded array of at most 10 pre-capture actions. Prefer a POST JSON body."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":0,"paidSeparately":true},"responses":{"200":{"description":"Screenshot bytes.","content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"x402 v2 exact payment required, invalid, or replayed. Decode PAYMENT-REQUIRED, sign the selected Base USDC requirement, and retry the request unchanged with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"required":true,"schema":{"type":"string"},"description":"Base64-encoded x402 payment requirements."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/x402/v1/pdf":{"get":{"operationId":"pdfUrlX402","summary":"Render a PDF paid per call","tags":["x402"],"security":[{"x402":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["A4","A3","A5","Letter","Legal","Tabloid"],"default":"A4"},"description":"Paper size."},{"name":"landscape","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Landscape orientation."},{"name":"margin","in":"query","required":false,"schema":{"type":"string","maxLength":30,"default":"10mm"},"description":"One CSS length used on all sides."},{"name":"print_background","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Print backgrounds."},{"name":"scale","in":"query","required":false,"schema":{"type":"number","minimum":0.1,"maximum":2,"default":1},"description":"Print scale."},{"name":"page_ranges","in":"query","required":false,"schema":{"type":"string","maxLength":50},"description":"Chromium page-range expression, for example 1-3,5."},{"name":"device","in":"query","required":false,"schema":{"type":"string","maxLength":40},"description":"Playwright device name."},{"name":"header","in":"query","required":false,"schema":{"type":"string","maxLength":2048},"description":"Sanitized header template."},{"name":"footer","in":"query","required":false,"schema":{"type":"string","maxLength":2048},"description":"Sanitized footer template."},{"name":"page_numbers","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Add Page X of Y; cannot be combined with footer."},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Extra post-load wait."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":30000},"description":"Overall timeout."},{"name":"actions","in":"query","required":false,"schema":{"type":"string","contentMediaType":"application/json"},"description":"JSON-encoded array of at most 10 pre-capture actions. Prefer a POST JSON body."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35,"default":"en-US","examples":["en-US","ja-JP"]},"description":"Safe BCP-47 language tag."},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"UTC","examples":["UTC","America/New_York"]},"description":"UTC or an IANA time zone supported by the runtime."}],"x-pagesnap-quota":{"units":0,"paidSeparately":true},"responses":{"200":{"description":"PDF bytes.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"x402 v2 exact payment required, invalid, or replayed. Decode PAYMENT-REQUIRED, sign the selected Base USDC requirement, and retry the request unchanged with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"required":true,"schema":{"type":"string"},"description":"Base64-encoded x402 payment requirements."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/x402/v1/meta":{"get":{"operationId":"getMetaX402","summary":"Get metadata paid per call","tags":["x402"],"security":[{"x402":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."}],"x-pagesnap-quota":{"units":0,"paidSeparately":true},"responses":{"200":{"description":"Metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"x402 v2 exact payment required, invalid, or replayed. Decode PAYMENT-REQUIRED, sign the selected Base USDC requirement, and retry the request unchanged with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"required":true,"schema":{"type":"string"},"description":"Base64-encoded x402 payment requirements."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price":{"mode":"fixed","currency":"USD","amount":"0.002"}}}},"/x402/v1/extract":{"get":{"operationId":"extractStructuredX402","summary":"Extract structured data paid per call","tags":["x402"],"security":[{"x402":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"description":"Public HTTP(S) URL; a missing scheme is accepted by the core /v1 URL endpoints and interpreted as HTTPS."},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","minimum":3000,"maximum":45000,"default":20000},"description":"Overall timeout."}],"x-pagesnap-quota":{"units":0,"paidSeparately":true},"responses":{"200":{"description":"Structured extraction.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"x402 v2 exact payment required, invalid, or replayed. Decode PAYMENT-REQUIRED, sign the selected Base USDC requirement, and retry the request unchanged with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"required":true,"schema":{"type":"string"},"description":"Base64-encoded x402 payment requirements."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price":{"mode":"fixed","currency":"USD","amount":"0.002"}}}},"/x402/v1/crawl":{"post":{"operationId":"crawlSiteX402","summary":"Crawl paid per requested page","tags":["x402"],"security":[{"x402":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},"limit":{"type":"integer","minimum":1,"maximum":25,"default":20},"max_depth":{"type":"integer","minimum":0,"maximum":20,"default":3},"same_origin":{"type":"boolean","default":true},"include":{"oneOf":[{"type":"string","maxLength":500},{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","maxLength":500}}]},"exclude":{"oneOf":[{"type":"string","maxLength":500},{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","maxLength":500}}]},"use_sitemap":{"type":"boolean","default":true},"format":{"type":"string","enum":["markdown","json"],"default":"markdown"}}}}}},"x-pagesnap-quota":{"units":0,"paidSeparately":true},"responses":{"200":{"description":"Synchronous crawl result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrawlResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"x402 v2 exact payment required, invalid, or replayed. Decode PAYMENT-REQUIRED, sign the selected Base USDC requirement, and retry the request unchanged with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"required":true,"schema":{"type":"string"},"description":"Base64-encoded x402 payment requirements."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price":{"mode":"dynamic","basis":"per-requested-page","currency":"USD","amount":"0.002","minimum":"0.002","maximum":"0.050"}}}},"/x402/v1/render":{"post":{"operationId":"renderHtmlX402","summary":"Render HTML paid per call","tags":["x402"],"security":[{"x402":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["html"],"properties":{"html":{"type":"string","minLength":1,"maxLength":1500000},"type":{"type":"string","enum":["png","jpeg","jpg","webp","pdf"],"default":"png"},"width":{"type":"integer","minimum":200,"maximum":3840,"default":1280},"height":{"type":"integer","minimum":200,"maximum":10000,"default":800},"full_page":{"type":"boolean","default":false},"format":{"type":"string","enum":["A4","A3","A5","Letter","Legal","Tabloid"],"default":"A4"},"quality":{"type":"integer","minimum":1,"maximum":100,"default":80},"scale":{"type":"number","minimum":0.1,"maximum":2,"default":1},"dark":{"type":"boolean","default":false},"wait":{"type":"integer","minimum":0,"maximum":10000,"default":0},"wait_until":{"type":"string","enum":["load","domcontentloaded","networkidle"]},"block_ads":{"type":"boolean","default":true},"hide_cookie_banners":{"type":"boolean","default":true},"timeout":{"type":"integer","minimum":3000,"maximum":45000,"default":30000},"selector":{"type":"string","maxLength":200},"device":{"type":"string","maxLength":40},"user_agent":{"type":"string","maxLength":300},"actions":{"$ref":"#/components/schemas/Actions"},"lang":{"type":"string","maxLength":35,"default":"en-US"},"timezone":{"type":"string","default":"UTC"},"landscape":{"type":"boolean","default":false},"margin":{"type":"string","maxLength":30,"default":"10mm"},"print_background":{"type":"boolean","default":true},"page_ranges":{"type":"string","maxLength":50},"header":{"type":"string","maxLength":2048},"footer":{"type":"string","maxLength":2048},"page_numbers":{"type":"boolean","default":false}}}}}},"x-pagesnap-quota":{"units":0,"paidSeparately":true},"responses":{"200":{"description":"Rendered image or PDF.","content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"x402 v2 exact payment required, invalid, or replayed. Decode PAYMENT-REQUIRED, sign the selected Base USDC requirement, and retry the request unchanged with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"required":true,"schema":{"type":"string"},"description":"Base64-encoded x402 payment requirements."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"408":{"$ref":"#/components/responses/Timeout"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamFailure"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/mcp":{"get":{"operationId":"mcpGet","summary":"MCP Streamable HTTP transport","description":"Stateless MCP endpoint. GET/DELETE are transport methods; POST carries JSON-RPC. Available tools: read_url, crawl_site, screenshot_url, pdf_url, get_meta, extract_structured, create_monitor, list_monitors, usage, upgrade_plan.","tags":["Agents"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"responses":{"200":{"description":"MCP transport response."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/Internal"}}},"post":{"operationId":"mcpPost","summary":"Call MCP tools","tags":["Agents"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"MCP JSON-RPC request."}}}},"responses":{"200":{"description":"MCP JSON-RPC response.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/Internal"}}},"delete":{"operationId":"mcpDelete","summary":"Close an MCP transport","tags":["Agents"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"responses":{"200":{"description":"MCP transport response."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/Internal"}}}},"/a2a":{"post":{"operationId":"a2a","summary":"A2A 1.0 JSON-RPC task endpoint","description":"Supports SendMessage, GetTask, ListTasks, CancelTask and legacy message/send, tasks/get, tasks/cancel. SendMessage accepts 1–8 TextPart/DataPart values and the six content skills advertised by the agent card.","tags":["Agents"],"security":[{},{"bearer":[]},{"apiHeader":[]},{"apiQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"JSON-RPC result or error. Protocol errors remain HTTP 200.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"413":{"$ref":"#/components/responses/TooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMedia"},"500":{"$ref":"#/components/responses/Internal"}}}},"/.well-known/agent-card.json":{"get":{"operationId":"agentCard","summary":"Get the A2A agent card","tags":["Discovery"],"security":[],"responses":{"200":{"description":"A2A 1.0 agent card.","content":{"application/json":{"schema":{"type":"object"}}}},"304":{"description":"Not modified."}}}},"/.well-known/jwks.json":{"get":{"operationId":"agentJwks","summary":"Get A2A card signing keys","tags":["Discovery"],"security":[],"responses":{"200":{"description":"JSON Web Key Set for Agent Card signatures.","content":{"application/json":{"schema":{"type":"object"}}}},"304":{"description":"Not modified."}}}},"/.well-known/api-catalog":{"get":{"operationId":"apiCatalog","summary":"Get the RFC 9727 API catalog","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Linkset API catalog.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"ETag":{"schema":{"type":"string"}}}},"304":{"description":"Not modified."}}}},"/.well-known/security.txt":{"get":{"operationId":"securityTxt","summary":"Get the security contact policy","tags":["Discovery"],"security":[],"responses":{"200":{"description":"RFC-style security contact text.","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/.well-known/x402":{"get":{"operationId":"x402Manifest","summary":"List x402 resources","tags":["Discovery"],"security":[],"responses":{"200":{"description":"x402 resource manifest.","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"integer"},"resources":{"type":"array","items":{"type":"string","format":"uri"}},"instructions":{"type":"string"}}}}}},"304":{"description":"Not modified."}}}},"/.well-known/ard.json":{"get":{"operationId":"ardManifest","summary":"Get the Agentic Resource Discovery manifest","tags":["Discovery"],"security":[],"responses":{"200":{"description":"ARD JSON-LD manifest.","content":{"application/json":{"schema":{"type":"object"}}}},"304":{"description":"Not modified."}}}},"/.well-known/ai-catalog.json":{"get":{"operationId":"aiCatalog","summary":"Alias of the ARD manifest","tags":["Discovery"],"security":[],"responses":{"200":{"description":"ARD JSON-LD manifest.","content":{"application/json":{"schema":{"type":"object"}}}},"304":{"description":"Not modified."}}}},"/badge.svg":{"get":{"operationId":"poweredByBadge","summary":"Get the static Powered by Pagesnap badge","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Immutable SVG badge.","content":{"image/svg+xml":{"schema":{"type":"string"}}}}}}},"/humans.txt":{"get":{"operationId":"humansTxt","summary":"Get human/operator disclosure","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Plain-text disclosure.","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"operationId":"llmsTxt","summary":"Get the concise LLM-facing API index","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Plain-text API index.","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms-full.txt":{"get":{"operationId":"llmsFullTxt","summary":"Get compiled full documentation","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Compiled plain-text documentation.","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/og/{hash}.png":{"get":{"operationId":"ogImage","summary":"Get an immutable generated Open Graph image","tags":["Discovery"],"security":[],"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}}],"responses":{"200":{"description":"PNG image.","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}},"/openapi.json":{"get":{"operationId":"openapiJson","summary":"Get this OpenAPI document as JSON","tags":["Discovery"],"security":[],"responses":{"200":{"description":"OpenAPI 3.1 document.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/openapi.yaml":{"get":{"operationId":"openapiYaml","summary":"Get this OpenAPI document as YAML","tags":["Discovery"],"security":[],"responses":{"200":{"description":"OpenAPI 3.1 YAML.","content":{"application/yaml":{"schema":{"type":"string"}}}}}}}}}