AI-powered child personality assessment and parenting insights API
KidGuide.ai provides an API for AI-powered child personality assessments and parenting insights. The API helps parents understand their child's unique personality traits, learning style, strengths, and areas for growth through comprehensive questionnaires and AI-generated assessments.
Base URL: https://www.kidguide.ai
API Version: 1.0.0
Supported Languages: English (en), Japanese (ja)
All API endpoints (except public documentation) require Bearer token authentication via Supabase Auth.
Authorization: Bearer <your-supabase-jwt-token>
Obtain a token by authenticating through Supabase Auth. Include the token in the Authorization header for all authenticated requests.
POST /api/auth/send-emailSend magic link email for authentication
GET /api/kidsList all child profiles for authenticated user
POST /api/kidsCreate a new child profile (free tier: 1 kid limit)
GET /api/kids/{id}Get specific child profile
DELETE /api/kids/{id}Soft delete a child profile
GET /api/kids/{id}/exportExport all data for a child
GET /api/questions?locale=enGet all assessment questions (supports locale parameter)
GET /api/responses?kid_id={uuid}Get all responses for a kid
POST /api/responsesSubmit an answer to an assessment question
GET /api/responses/{id}Get a specific response
GET /api/responses/{id}/countGet count of responses for a kid
⚠️ Requires Subscription
POST /api/assessment/generateGenerate personality assessment from responses
GET /api/assessments/{kid_id}Get assessment for a kid
⚠️ Requires Subscription
POST /api/chatSend a message to AI assistant about a child
GET /api/chat/{kid_id}Get chat history for a kid
GET /api/user/profileGet authenticated user's profile
GET /api/subscription/portalGet subscription management portal URL
POST /api/feedbackSubmit user feedback
Many endpoints support localization through a locale query parameter. Supported values are:
en - English (default)ja - Japanese (日本語)GET /api/questions?locale=ja
POST /api/chat
{
"kid_id": "...",
"message": "...",
"locale": "ja"
}All API responses are in JSON format. Successful responses return data directly, while errors return an error object:
// Success
{
"id": "...",
"name": "Emma",
...
}
// Error
{
"error": "Unauthorized",
"message": "Missing authentication token"
}KidGuide.ai is designed to be easily discoverable by AI agents and LLMs. The following resources are available:
These files provide comprehensive information about the API, service capabilities, and usage guidelines for AI agents.
For API support, questions, or feedback: