Use this file to discover all available pages before exploring further.
Products
API Endpoints
Embeddable UI IDs
The IELTS and TOEFL Single CTA Embeddable UI provides a streamlined, interactive solution for integrating language assessments directly within educational platforms. This embeddable UI allows students to practice specific IELTS and TOEFL writing tasks and receive instant, AI-driven feedback. It is designed for seamless integration at various stages of the user journey, from lead generation to in-class assessments, providing a versatile tool for edtech platforms, training centers, and classrooms.
Single-Click CTA: Provides instant access to TOEFL and IELTS writing tasks, allowing students to practice with authentic exam formats, including essay-based and graph-based prompts.
Instant Evaluations: Offers immediate feedback on submitted answers, powered by specialized Evaluations APIs for IELTS and TOEFL.
Customization Options: Allows UI customization to align with client branding, ensuring a cohesive experience for students.
Evaluations and Feedback
Overall Score: Provides students with a standardized score upon submission.
Holistic Evaluation Rubrics: Offers detailed scores across Task Response, Coherence & Cohesion, Grammatical Range, and Lexical Resource.
Objective Feedback: Interactive spelling and grammar suggestions help students identify and learn from mistakes.
Key Features of IELTS and TOEFL Single CTA Embeddable UI
Single-Click Access to Writing Tasks: Students can access IELTS and TOEFL writing tasks with a single click, instantly engaging with essay and graph-based prompts for a realistic test experience.
Instant Evaluations: Provides AI-powered, real-time evaluations upon submission, including:
Overall Score: Reflects the student’s performance.
Evaluation Rubrics: Detailed breakdown across key assessment categories.
Objective Feedback: Highlights spelling and grammar suggestions within the response.
Generate Answer Option: Offers sample answers for users exploring the evaluation features, useful in lead-generation scenarios. This option can be disabled in classroom or engagement settings.
Brand Customization: Customizable options for color, fonts, and layout allow alignment with client branding.
Versatile for Different Funnel Stages: Adaptable across lead generation, engagement, nurturing, and classroom scenarios to meet various educational needs.
Configurable for Specific Usage: Flexible setup for use as either a stand-alone assessment tool or an embedded feature within a larger educational platform.
We hope this documentation has provided a helpful overview of the IELTS and TOEFL Single CTA Embeddable UI. This tool can be integrated within 24 hours, delivering instant, standardized evaluations for TOEFL and IELTS tasks with single-click ease and customizable UI options to align with your brand. By using our embeddable solution, you can focus your resources on growth rather than building in-house capabilities, while gaining a versatile tool that enhances engagement and streamlines assessments across lead generation, classroom use, and more.We also offer additional API documentation:TOEFL Evaluations APIIELTS Evaluations APIFor further information, please reach out to us at info@crazygoldfish.com. We look forward to supporting your assessment needs!
Authorization and Link Generation: The client generates an embeddable UI link via the Embeddable UI API. This link can be embedded at various points along the user journey for seamless access to IELTS and TOEFL assessments.
Embedding and Customization: The embeddable link can be customized to match the client’s branding, ensuring a cohesive experience. The UI can be embedded on pages for lead capture, engagement, or classroom practice.
Answer Submission and Evaluation: Upon submitting an answer, students receive real-time evaluations powered by either the IELTS Evaluations API or the TOEFL Evaluations API, depending on the test type.
The Embeddable UI uses dedicated IELTS Evaluations API and TOEFL Evaluations API endpoints for tailored evaluations, in addition to the Embeddable UI API for generating links and embedding the user interface.
The Embeddable UI API handles the creation and customization of the embeddable UI links, allowing clients to embed TOEFL and IELTS assessments on their platforms seamlessly.
Endpoint: ‘/exams/embeddable-ui-link’
Purpose: Generates a unique link for embedding either the TOEFL or IELTS writing assessment.
Key Parameters:
Parameter
Type
Description
embeddable_ui_id
String
Identifier for the specific embeddable UI instance.
institute_id
String
Optional identifiers for tracking.
teacher_id
String
Optional identifiers for tracking.
parent_id
String
The parent’s ID.
student_id
String
Optional identifiers for tracking.
student_name
String
Name of the student using the link.
For your reference, the following table lists the embeddable IDs for IELTS and TOEFL:
embeddable_ui_id
Description
IE-AC-W-01
IELTS AC Writing: Task 1 - Writing a letter to respond to a situation
IE-AC-W-02
IELTS AC Writing: Task 2 - A point of view, argument, or problem which you need to discuss
IE-GT-W-01
IELTS Essentials Writing: Email Detailed - Describe some visual information in your own words
IE-GT-W-02
IELTS Essentials Writing: Academic Discussion - A point of view, argument, or problem which you need to discuss
TF-ES-W-01
TOEFL Essentials Writing: Build a Sentence
TF-ES-W-02
TOEFL Essentials Writing: Email Brief
TF-ES-W-03
TOEFL Essentials Writing: Email Detailed
TF-ES-W-04
TOEFL Essentials Writing: Describe a Photo
TF-ES-W-05
TOEFL Essentials Writing: Academic Discussion
TF-IB-W-01
TOEFL IBT Writing: Integrated Writing
TF-IB-W-02
TOEFL IBT Writing: Academic Discussion
Usage: Once generated, the link can be integrated on any page to provide instant access to TOEFL and IELTS assessments.
To access the Embeddable UI API, you will need an API token. API tokens are generated from the authentication API. Be sure to securely store your API token, as it is required for generating the test link.
Theme Colors: Adjust colors to match your platform.
Fonts: Select fonts from a predefined list or provide your own custom fonts.
Embeddable UI IDs are unique identifiers assigned to specific user interfaces tailored for various tasks within the TOEFL and IELTS assessments. These identifiers correspond to predefined configurations, ensuring seamless integration of assessment components into your platform. While a comprehensive catalog of these IDs is available, we also offer custom configurations upon request to meet specific requirements.
For your reference, the following table lists the IELTS and TOEFL embeddable UI IDs alongside their corresponding tasks:
How do I drop standardized IELTS/TOEFL assessments into my product via a secure link or iframe using the Embeddable UI?
Generate a secure link via the API with token-based auth and embed it in your app as an iframe. The embeddable surface handles multimodal capture and delivers instant, rubric-based feedback with audit trails. You can extend orchestration with REST/JSON APIs and webhooks for downstream workflows.
What authentication model does the Embeddable UI use, and how is session access secured?
The Embeddable UI uses token-based auth to generate secure, embeddable links. Tokens are validated server-side, so the UI loads only for authorized users and contexts you define. Pair this with your own user mapping to keep flows scoped and traceable across tenants or cohorts.
Which inputs does the Embeddable UI accept, and how are they evaluated?
It supports multimodal submissions—typed text, handwritten scans/images (including diagrams), audio, and video. The engine applies model-answer and rubric-based logic to return objective error flags, holistic scores (e.g., band descriptors for IELTS/TOEFL), and actionable guidance. Quality targets sit at 95% accuracy with optional human-in-the-loop review for edge cases.
How do I retrieve scores, section summaries, and model answers from an embedded session?
Use the Final Results API to fetch exam-level scores, section summaries, model answers, and step-wise marking. Responses also include teacher review metadata (e.g., isApproved) for auditability. For push-based patterns, pair the embeddable flow with webhooks or LMS-friendly exports.
Can I fully white‑label the Embeddable UI to match my LMS/ERP brand?
Yes—branding controls cover colors, fonts, and layout so the experience matches your product. The Single‑CTA embeddable UI is designed for white‑label deployments while retaining standardized evaluations and consistent rubrics. You keep your UX while the engine handles evaluation and feedback.
How is human‑in‑the‑loop review supported around the Embeddable UI?
Teachers can review AI scores, trigger re-checks, and approve or override results with audit logs. The Final Results API exposes review fields like isApproved so your systems can respect educator decisions. This preserves trust while maintaining targeted 95% accuracy at scale.
How do we align the embedded experience with CBSE/ICSE curricula and stay GDPR aligned?
Configure rubrics and content mappings to remain CBSE/ICSE aligned, and use privacy‑first defaults that keep data handling GDPR aligned. The system provides audit trails, compliance‑friendly dashboards, and standardized exports for institutional reporting. This lets you meet board expectations without custom builds.
What events or callbacks should developers use to orchestrate an end‑to‑end embedded flow?
Combine the Embeddable UI with REST/JSON APIs and webhooks to capture submission status, publish results, and sync to your LMS/ERP. Webhooks notify you when evaluations complete so you can retrieve structured feedback JSON or trigger follow‑up actions. Exports and reporting endpoints help keep analytics in lockstep across systems.
Does the Embeddable UI work for multi‑tenant, white‑label B2B platforms?
Yes—partners use the white‑label UI to enforce uniform evaluation across clients while rolling up analytics cleanly. Secure link generation and token‑based auth let you scope embeds per tenant and cohort. Data flows remain CBSE/ICSE/GDPR aligned with standardized exports and webhooks for enterprise governance.
Can we start with the Single‑CTA embeddable UI and later transition to deeper API orchestration?
Absolutely—teams often launch with the Single‑CTA Embeddable UI, then expand into REST/JSON APIs for custom workflows. You keep the same rubrics, feedback structures, and compliance posture while adding orchestration, webhooks, and reporting. This de‑risks adoption without rebuilding your stack.