Essay Grader API

{
  "toolType": "essay-grader",
  "input": {
    "essay": "The American Revolution was a pivotal moment in world history. It began in 1775 when tensions between the thirteen American colonies and Great Britain reached a breaking point. The colonists were frustrated with British taxation policies, particularly the Stamp Act and the Tea Act, which they viewed as violations of their rights as English citizens.\n\nThe war lasted eight years and resulted in the formation of the United States of America...",
    "prompt": "Discuss the causes and effects of the American Revolution",
    "rubric": "Grade based on: thesis clarity (25%), evidence and examples (25%), organization (20%), grammar and mechanics (15%), analysis and critical thinking (15%)",
    "grade_level": "11th",
    "subject": "History"
  }
}

{
  "success": true,
  "toolType": "essay-grader",
  "userId": "user_abc123",
  "result": {
    "overall_score": 85,
    "grade": "B+",
    "feedback": {
      "strengths": [
        "Clear thesis statement that addresses the prompt",
        "Good use of specific historical examples",
        "Logical organization with clear topic sentences",
        "Strong conclusion that ties ideas together"
      ],
      "areas_for_improvement": [
        "Could benefit from more analysis of the long-term effects",
        "Some transitions between paragraphs could be smoother",
        "A few minor grammar issues (see details below)"
      ],
      "grammar_and_mechanics": {
        "score": 13,
        "max_score": 15,
        "issues": [
          "Line 3: 'were frustrated' - consider more varied verb choice",
          "Line 12: Missing comma after introductory phrase"
        ]
      },
      "content_analysis": {
        "thesis_clarity": {
          "score": 22,
          "max_score": 25,
          "comment": "Strong thesis that directly addresses the prompt. Could be more specific about which effects you'll discuss."
        },
        "evidence_and_examples": {
          "score": 23,
          "max_score": 25,
          "comment": "Excellent use of specific acts and events. More primary source references would strengthen the argument."
        },
        "organization": {
          "score": 18,
          "max_score": 20,
          "comment": "Well-organized with clear structure. Topic sentences effectively introduce each paragraph's main idea."
        },
        "analysis_and_critical_thinking": {
          "score": 12,
          "max_score": 15,
          "comment": "Good analysis of causes. Effects section would benefit from deeper exploration of economic and social impacts."
        }
      }
    },
    "rubric_scores": {
      "thesis_clarity": 22,
      "evidence_and_examples": 23,
      "organization": 18,
      "grammar_and_mechanics": 13,
      "analysis_and_critical_thinking": 12
    },
    "suggestions": [
      "Expand the effects section to include more about economic impacts on both Britain and America",
      "Consider adding a paragraph about the global influence of the American Revolution",
      "Review comma usage after introductory phrases",
      "Include at least one primary source quotation to strengthen your argument"
    ],
    "summary": "This is a well-written essay that demonstrates solid understanding of the American Revolution. Your thesis is clear and your use of historical examples is strong. To move from a B+ to an A, focus on deepening your analysis of the revolution's effects and incorporating more primary source evidence. Your writing mechanics are generally good, with just a few minor issues to address."
  }
}

{
  "toolType": "essay-grader",
  "input": {
    "essay": "[Essay text here...]",
    "quick_mode": true
  }
}

{
  "success": true,
  "toolType": "essay-grader",
  "userId": "user_abc123",
  "result": {
    "overall_score": 85,
    "grade": "B+",
    "summary": "This essay demonstrates good understanding of the topic with clear organization and solid examples. Main areas for improvement: deeper analysis and smoother transitions.",
    "top_suggestions": [
      "Expand your analysis in the second half",
      "Work on paragraph transitions",
      "Consider adding more specific evidence"
    ]
  }
}

{
  "toolType": "essay-grader",
  "input": {
    "essay": "[Full essay text]",
    "prompt": "The specific assignment question or prompt",
    "rubric": "The grading criteria from your teacher",
    "grade_level": "11th",
    "subject": "English Literature",
    "word_count_requirement": "1000-1200 words",
    "citation_style": "MLA"
  }
}

{
  "error": "Error message"
}