Healthily

Symptom checking apps have become increasingly popular as people look for convenient ways to understand their health. While many rely on basic search features, the most effective solutions combine symptom recognition with expert medical guidance. Healthily's AI-Powered Symptom Checker stands out in this space by offering a comprehensive, clinically accurate assessment tool that helps users understand their symptoms and determine appropriate next steps. This article explores the technical capabilities and user experience of Healthily's Smart Symptom Checker API, highlighting how it transforms complex medical assessment into an intuitive digital health tool.

The Smart Symptom Checker API

Healthily's Smart Symptom Checker API transforms complex medical symptom assessment into an intuitive user experience through its powerful AI technology. The API empowers developers to integrate Healthily's diagnostic capabilities into their applications, creating dynamic user interfaces that guide individuals through personalized health evaluations.

At the core of the API are five key endpoints that enable comprehensive symptom checking functionality:

1. Login: Required to secure API access, this endpoint authenticates users and issues JWT tokens for subsequent interactions.

2. Logout: Invalidates access tokens, ensuring secure session management.

3. Chat: Facilitates the conversational experience, processing user inputs and delivering diagnostic insights.

4. Search Symptoms: Enables users to find relevant symptoms through a free-text search mechanism.

5. Search Articles: Connects users with Healthily's health library, providing background information and guidance.

By leveraging these endpoints, developers can create intuitive applications that help users check symptoms and manage over 100 conditions, just as the official Healthily app does. The API's robust security framework, including ephemeral JWT tokens and authentication through the HTTP Authorization header, ensures user data privacy while facilitating seamless interaction throughout the diagnostic process.

Symptom Checking Process

Step-by-Step Symptom Checking

The Healthily Symptom Checker employs an efficient three-step process to help users understand and address their health concerns.

Step 1: Symptom Entry

Users begin by describing their symptoms in their own words. This free-text input allows for flexible and comprehensive symptom reporting. The system processes multiple symptom inputs, building a detailed picture of the user's health status.

Step 2: Diagnostic Questioning

The AI then asks a series of questions to refine the diagnosis. These questions can range from straightforward queries about symptom duration and severity to more complex inquiries about medical history. The goal is to narrow down potential causes of the symptoms while keeping the process user-friendly.

Step 3: Personalized Report

At the conclusion of the assessment, users receive a personalized report. This report outlines possible causes of their symptoms and suggests appropriate next steps. Healthily's system is designed to provide clear, actionable information that helps users make informed decisions about their healthcare needs.

Technical Implementation

The Symptom Checker API supports these steps through its structured endpoint system. Users initiate the process by authenticating through the login endpoint, which provides the necessary access tokens for subsequent interactions. The system then processes the user's input through the chat endpoint, using AI to analyze symptoms and generate diagnostic questions. Finally, the chat endpoint compiles all information into a personalized report, which can be shared with healthcare providers or used for personal reference.

Technical Integration Details

The Healthily Symptom Checker API employs a well-structured endpoint system to facilitate seamless integration and interaction. The process begins with authentication through the login endpoint, which returns access_token and expires_in values essential for subsequent API operations. This initial login phase establishes secure access through the HTTP Authorization header, which requires both "token" and "bearer" components for verification.

Once authenticated, developers can utilize the chat endpoint to engage with Healthily's conversational AI technology. This core functionality processes user inputs, generates diagnostic questions, and compiles the final personalized report. Throughout the interaction, API calls operate on a challenge/response basis, with users posting requests and receiving JSON-formatted responses that adapt based on the current interaction stage. The chat endpoint requires the use of JWT access tokens in the HTTP Authorization header to maintain secure session management.

For symptom-related queries, the API offers a dedicated search endpoint that processes both complete and partial user inputs. This feature enables robust autocomplete functionality, allowing users to efficiently find relevant health information. Additionally, developers can access Healthily's comprehensive library through an article search endpoint, which returns targeted information based on recognized symptom identifiers. Together, these capabilities empower third-party applications to provide users with accurate, personalized health assessments while maintaining rigorous data privacy standards through ephemeral JWT tokens.

User Support and Information

The Healthily Symptom Checker has assisted over 3 million users with their health assessments since its launch in 2015. Built with clinical expertise, the tool processes user inputs and generates personalized reports that help users understand their symptoms and determine appropriate next steps.

The system manages over 1,300 recognized symptoms and employs advanced AI to tailor its responses to individual needs. Users can enter multiple symptoms using their own words, and the tool's conversational AI then asks simple questions to narrow down potential causes. The final report guides users on whether to manage their symptoms through self-care, visit a pharmacy, or consult a doctor.

Healthily maintains strong privacy standards, as no health data is retained. The company serves 5.5 million people worldwide and continues to expand its diagnostic capabilities while prioritizing user trust and confidentiality.

Development and Implementation

Healthily's Smart Symptom Checker API combines advanced AI with structured endpoint design to enable third-party integration while maintaining user privacy. The development process leverages an independent clinical advisory board to ensure medical accuracy while allowing the API to scale globally.

The API operates on a challenge/response model where users authenticate through the login endpoint to receive JWT tokens for secure session management. Each interaction requires the HTTP Authorization header with "token_type" and "bearer" components, while authentication occurs via the login endpoint. The system supports periodic token renewal to maintain secure sessions, ensuring data integrity throughout extended interactions.

The chat endpoint serves as the core functionality, processing all user inputs and managing the conversational flow. It handles both free-form and structured responses, compiling diagnostic information into personalized reports that guide users on appropriate next steps for their health management.

Healthily maintains rigorous privacy standards, with no health data retained after sessions. The API's comprehensive capabilities support over 3 million users and 1,300 recognized symptoms, making it a robust foundation for integrating advanced symptom checking functionality into various applications while upholding the highest data protection practices.