Our API enables you to assess both questions and answers according to TOEFL examination standards. Whether for Essentials or IBT, this API allows you to submit questions and answers in various multimedia formats, providing scores, feedback, improvement suggestions, and objective error detection.

Customize the evaluation with your own rubrics for tailored assessments.

TOEFL

Evaluation API

​
Question Types:

Assessment Type CodeDescription
TF-ES-W-01TOEFL Essentials Writing: Build a Sentence
TF-ES-W-02TOEFL Essentials Writing: Email Brief
TF-ES-W-03TOEFL Essentials Writing: Email Detailed
TF-ES-W-04TOEFL Essentials Writing: Describe a Photo
TF-ES-W-05TOEFL Essentials Writing: Academic Discussion
TF-IB-W-01TOEFL IBT Writing: Integrated Writing
TF-IB-W-02TOEFL IBT Writing: Academic Discussion

Currently, this API is available exclusively for evaluating Writing Skills for TOEFL Essentials and IBT.

​
Key Features

  • Automated Grading : Efficiently grade TOEFL writing tasks with high accuracy.

  • Detailed Feedback : Receive comprehensive feedback, including suggestions for improvement and objective error detection.

  • Customization : Customize the evaluation with your own rubrics.

  • Multimedia Support : Submit questions and answers in text, audio, image, and video formats.

  • Scalability : Handle large volumes of evaluations during peak times without compromising speed or accuracy.

  • Integration : Seamlessly integrate with other educational tools and platforms to create a cohesive evaluation ecosystem.

​
Endpoints

1

Submit Evaluation Request

Submit a request for evaluation directly by providing questions and respective answers in a json format. The API generates an evaluation report based on the provided data, and returns an acknowledgment along with an evaluation ID.

POST /v1/toefl/evaluation
2

Get Specific Evaluation Report

Retrieve a specific evaluation report using its unique identifier (ID). Clients can access past evaluations or reference specific reports by providing the evaluation ID.

GET /v1/toefl/evaluation
3

Get All Evaluation Reports

Retrieve all the evaluation report or for a specific set of handwritten notes. Clients can provide parameters such as student name, class, subject, and date of evaluation to filter the results.

GET /v1/toefl/evaluation/{id}

​
Sample Request

curl --location 'https://api-staging.crazygoldfish.com/v1/toefl/evaluation' \

--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImhhcnNoaXQiLCJ1c2VyX2lkIjoxLCJ1c2VyX3JvbGUiOiJUZWFjaGVyIiwiaXNfYWN0aXZlIjp0cnVlLCJjbGllbnRfaWQiOjEsImV4cCI6MTczMjAwOTczNn0.y0Qp9K5YLx01X0YWW3oDQWwyir4f5rgL-LKSh0cJKPM' \

--header 'Content-Type: application/json' \

--data '{

  "client_id": "1",

  "institution_id": "inst_456",

  "teacher_id": "string",

  "parent_id": "string",

  "student_id": "123",

  "exam_type": "IS",

  "student_name": "crazygoldfish",

  "image_urls": [

    "string"

  ],

  "evaluation_text": [

    {

      "question_text": "Write your personal opinion on the academic topic. answer the question based on the discussion.Minimum of 100 words \n Academic Discussion Professor John: Many universities offer online courses as an alternative to traditional classroom-based learning. Do you think online courses provide the same quality of education as traditional classroom-based learning? Why or why not? Use examples and details in your response.Jason: I believe online courses can provide a similar quality of education as traditional classroom-based learning. With advanced technology and interactive platforms, students can access high-quality lectures, engage in virtual discussions, and submit assignments online, often at their own pace and convenience. So, personally, I think that online courses provide the same quality of education as traditional classroom-based learning while being more accessible. \n Anna: In my opinion, online courses offer convenience and flexibility, but they often fall short of delivering the same quality of education as traditional classroom-based learning. In a traditional classroom setting, students can actively engage in discussions, ask questions, and receive immediate feedback from professors, which facilitates deeper understanding and retention of the material. While online courses offer certain advantages, such as accessibility, they often lack the personalized attention and immersive learning experience provided by traditional classroom-based learning.",

      "question_multimedia_url": "string",

      "answer_text": "In fact, online courses could provide the same quality of education similar to the one a student will experience in a classroom.But it all depends on how they are designed and delivered. eg universities employing advanced technology with interactive platforms are able to offer quality lectures, virtual discussions, and online assignments. These ingredients allow learning at a self-determined pace which is essential for people who have other commitments, such as work or family. Moreover, the flexibility and accessibilities of online courses could let more types of students be involved in the learning process, enriching it for everyone. For example, suppose some student lives in a remote area and is unable to commute to any university. With the help of online courses, he or she can obtain top-class education. At the same time, it is also necessary to be aware of the negative side, like the impossibility of immediate feedback and interaction with professors and peers, which is more available in a traditional class.",

      "question_type": "TF-IB-W-02",

      "question_section": "writing",

      "question_number": "2",

      "question_id": "2"

    }

  ]

}'