Testers.AI API

Authentication

All endpoints accept an optional API key. Without a key, requests fall back to the free tier with reduced limits.

Methods

CORS

All endpoints return Access-Control-Allow-Origin: * and support OPTIONS preflight requests.

Bug Detection

Send a screenshot and get back a list of bugs found by 30+ specialized AI testing agents. Each bug includes priority, type, reasoning, and a ready-to-use fix prompt.

Request Body (JSON)

Example Request

curl -X POST \
  https://us-central1-taiser-476406.cloudfunctions.net/main/api/test \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tst_live_your_key_here" \
  -d '{
    "screenshot_base64": "iVBORw0KGgo...",
    "url": "https://example.com"
  }'

Response

{
  "success": true,
  "bugs": [
    {
      "bug_title": "Missing alt text on hero image",
      "bug_type": ["Accessibility", "WCAG"],
      "bug_priority": 8,
      "bug_confidence": 9,
      "bug_reasoning_why_a_bug": "Screen readers cannot describe...",
      "suggested_fix": "Add descriptive alt attribute...",
      "fix_prompt": "Add alt text to img.hero-image..."
    }
  ],
  "metadata": {
    "url": "https://example.com",
    "total_bugs": 12,
    "tier": "free"
  }
}

Tier Limits

Test Case Generation

Generate comprehensive QA test cases from a screenshot. Returns structured test suites with steps, expected results, and priority levels.

Request Body (JSON)

Example Request

curl -X POST \
  https://us-central1-taiser-476406.cloudfunctions.net/main/api/generate-test-cases-custom \
  -H "Content-Type: application/json" \
  -d '{
    "artifact": "iVBORw0KGgo...",
    "token": "tst_live_your_key_here",
    "customPrompt": "Focus on login and checkout flows",
    "testCaseCount": 10,
    "outputFormat": "json"
  }'

Response

{
  "success": true,
  "test_suites": [
    {
      "suite_name": "Login Flow Tests",
      "priority": "critical",
      "test_cases": [
        {
          "test_id": "TC-001",
          "test_name": "Valid login with correct credentials",
          "objective": "Verify user can log in...",
          "preconditions": ["User account exists"],
          "steps": [
            { "step": 1, "action": "Navigate to login page", "expected_result": "Login form displayed" }
          ],
          "priority": "critical",
          "tags": ["login", "authentication"]
        }
      ]
    }
  ],
  "metadata": { "total_test_cases": 10, "tier": "pro" }
}

Tier Limits

Persona Feedback

Get realistic user feedback from diverse AI-generated personas. Each persona provides scores, praise, complaints, and detailed first-person feedback.

Request Body (FormData)

Response

{
  "success": true,
  "persona_feedback": [
    {
      "name": "Sarah Chen",
      "age": 34,
      "gender": "female",
      "background": "Product manager at a SaaS company",
      "tech_proficiency": "expert",
      "feedback": "The landing page immediately...",
      "scores": {
        "design": 8, "usability": 7, "content": 9,
        "trust": 8, "accessibility": 6, "overall": 8
      },
      "top_praise": "Clear value proposition",
      "top_complaint": "Pricing page is hard to find",
      "would_return": true,
      "would_recommend": true
    }
  ],
  "overall_score": 7.8,
  "metadata": { "num_personas": 2, "tier": "free" }
}

Tier Limits

Pricing & Rate Limits

All endpoints work without authentication on the free tier. Upgrade for higher limits and full results.

Error Handling

All errors return a consistent JSON structure with a user-friendly message and technical details.

HTTP Status Codes

Error Response Format

{
  "success": false,
  "error": "screenshot_base64 is required",
  "error_type": "ValueError",
  "error_detail": "Missing required parameter in request body"
}

Infrastructure