AI-Powered · GPT-4o Vision — GoScreenAPI

Screenshot + AI Analysis in One API Call

Q: What does the AI analysis return?

Four fields: alt_text (a concise image description), description (a detailed paragraph), page_type (e.g. homepage, blog post, e-commerce), and detected_elements (an array of UI components found on the page).

Q: Which AI model powers the analysis?

GPT-4o Vision by OpenAI. It's the same model used in ChatGPT's vision mode — highly accurate for web page understanding.

Q: How many credits does it cost?

AI analysis costs 2 credits per request (1 for the screenshot + 1 for the AI analysis). If the AI step fails, only 1 credit is deducted.

Q: Is it available on the free plan?

No. AI analysis requires a paid plan. The analyze parameter is ignored on free accounts and returns a 403 error.

Q: Can I use a custom prompt?

Yes. Pass analyze_prompt with your own instructions (up to 1000 characters) to get domain-specific analysis instead of the default structured output.

Q: What happens if the AI analysis fails?

The screenshot still completes successfully. The analysis field will be null and only 1 credit is deducted. AI errors never fail the screenshot job.

Q: Does it work with batch requests?

Yes. Add analyze: true to individual items in a batch request. Each analyze: true item counts as 2 credits toward the batch total.

Q: Can I analyze a specific element?

Yes. Combine selector with analyze: true to capture and analyze a specific HTML element — perfect for analyzing charts, hero sections, or product cards.

Add <code style="background:rgba(99,102,241,0.15);color:#a5b4fc;padding:2px 6px;border-radius:4px;font-size:0.9em">analyze: true</code> to any screenshot request and get back structured AI analysis — alt text, description, page type, and detected elements — powered by GPT-4o Vision.

Get API Key → View Docs

✓ 250 free screenshots/month ✓ No credit card required ✓ REST API · JSON

curl

curl -X POST 'https://goscreenapi.com/api/v1/screenshot' \
  -H 'X-API-Key: gsc_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://stripe.com",
    "analyze": true
  }'

// Response
{
  "status": "completed",
  "image_url": "https://cdn.goscreenapi.com/...",
  "analysis": {
    "alt_text": "Stripe homepage with hero banner and pricing CTA",
    "description": "A fintech landing page with a dark hero section, navigation bar, and prominent call-to-action buttons.",
    "page_type": "landing page",
    "detected_elements": ["navigation", "hero banner", "CTA button", "pricing section", "footer"]
  }
}

Features

Everything you need.
Nothing you don't.

One Parameter

Just add analyze: true to any existing screenshot request. No new endpoints, no extra setup.

GPT-4o Vision

Structured Output

Always returns alt_text, description, page_type, and detected_elements as a clean JSON object.

Custom Prompts

Override the default analysis with your own prompt via analyze_prompt for domain-specific insights.

Graceful Fallback

If AI analysis fails for any reason, the screenshot still completes. analysis is null, not an error.

Batch Compatible

Works with the Batch API — analyze up to 50 screenshots in a single request.

Use Cases

Built for real workflows

From solo developers to enterprise teams — GoScreenAPI fits into any stack.

Accessibility Automation

Auto-generate alt text for screenshots at scale — no manual labeling needed.

AI Agents & LLMs

Give your AI pipeline structured visual context about any webpage without writing vision code.

Content Classification

Automatically classify pages by type — homepage, blog, e-commerce, dashboard, login — at scale.

SEO & Auditing

Detect key page elements and structure for automated SEO and UX audits.

API Reference

Key Parameters

Full reference at goscreenapi.com/docs

Parameter	Type	Description
`analyze`	boolean	Enable AI analysis of the screenshot (paid plans only)
`analyze_prompt`	string	Custom analysis prompt (max 1000 chars). Overrides default.
`url`	string	Target URL to capture and analyze (required)
`full_page`	boolean	Capture full scrollable page before analysis
`selector`	string	Analyze a specific element instead of the full page
`async`	boolean	Process in background — analysis included in webhook payload

View full API reference →

Why GoScreenAPI

Speed. Scale. Simplicity.

< 3s

Avg. response time

Sync mode results in under 3 seconds for most pages.

99.9%

Uptime SLA

Production-grade reliability with redundant infrastructure.

150 req/min

Rate limit (Pro)

Handle high-volume workloads without throttling.

FAQ

Common questions