{"info":{"_postman_id":"a117c3b3-d196-43b4-a9c8-178724b84660","name":"Axion AI API - Complete Web App","description":"<html><head></head><body><p>Complete API documentation for entire Axion AI web application. Axion AI is a comprehensive YouTube analytics platform that uses artificial intelligence to analyze video comments, generate insights, and help creators optimize their content strategy.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"39216526","collectionId":"a117c3b3-d196-43b4-a9c8-178724b84660","publishedId":"2sBXinFUwH","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-28T07:44:22.000Z"},"item":[{"name":"Authentication System","item":[{"name":"Register User","id":"b2fdad6c-ce39-4b77-a188-f9af7c5b5e83","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"email\": \"john@example.com\",\n  \"password\": \"password123\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/api/auth/register","description":"<p>Register a new user account with automatic JWT token generation.</p>\n","urlObject":{"path":["api","auth","register"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b2fdad6c-ce39-4b77-a188-f9af7c5b5e83"},{"name":"User Login","id":"b3180a26-840b-4222-92f2-776f522fb4b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"email\": \"john@example.com\",\n  \"password\": \"password123\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/api/auth/login","description":"<p>Authenticate user credentials and set JWT cookie.</p>\n","urlObject":{"path":["api","auth","login"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b3180a26-840b-4222-92f2-776f522fb4b6"},{"name":"User Logout","id":"1e516b28-1e2a-4a28-a6c3-8cb1b83063ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:3000/api/auth/logout","description":"<p>Clear authentication cookie and terminate session.</p>\n","urlObject":{"path":["api","auth","logout"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"1e516b28-1e2a-4a28-a6c3-8cb1b83063ae"},{"name":"Get Current User","id":"87adfe73-b143-4c49-a644-ef97ca4fc5cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/auth/me","description":"<p>Returns current user profile information.</p>\n","urlObject":{"path":["api","auth","me"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"87adfe73-b143-4c49-a644-ef97ca4fc5cf"}],"id":"49c490ea-d97f-43bb-80b0-a6ba72486f35","description":"<p>User authentication and authorization system with registration, login, logout, and session management.</p>\n","_postman_id":"49c490ea-d97f-43bb-80b0-a6ba72486f35"},{"name":"User Profile Management","item":[{"name":"Get User Profile","id":"d0d0185a-7fbd-4ff2-9039-dc39393a98dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/user/profile","description":"<p>Returns comprehensive user profile with all settings and integrations.</p>\n","urlObject":{"path":["api","user","profile"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d0d0185a-7fbd-4ff2-9039-dc39393a98dd"},{"name":"Update User Profile","id":"06351c48-dc3c-4b18-961b-cc830e4063a1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"name\": \"Updated Name\",\n  \"email\": \"newemail@example.com\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/api/user/profile","description":"<p>Updates user profile information.</p>\n","urlObject":{"path":["api","user","profile"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"06351c48-dc3c-4b18-961b-cc830e4063a1"}],"id":"c9e0ddbe-88c9-47d3-87ef-b3172bf8cb8b","description":"<p>User profile and settings management including YouTube integration and preferences.</p>\n","_postman_id":"c9e0ddbe-88c9-47d3-87ef-b3172bf8cb8b"},{"name":"YouTube Integration","item":[{"name":"Connect YouTube (OAuth)","id":"befd59d9-00d6-46ce-9a1f-cccc5ea8949e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/auth/youtube","description":"<p>Starts YouTube OAuth 2.0 flow to connect user's channel.</p>\n","urlObject":{"path":["api","auth","youtube"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"befd59d9-00d6-46ce-9a1f-cccc5ea8949e"},{"name":"Disconnect YouTube","id":"d52e3c05-a0b7-4966-8f2a-5d1b008da66c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:3000/api/auth/disconnect-youtube","description":"<p>Removes YouTube integration and clears all related data.</p>\n","urlObject":{"path":["api","auth","disconnect-youtube"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d52e3c05-a0b7-4966-8f2a-5d1b008da66c"},{"name":"Get YouTube Status","id":"efdfcb99-acc9-472f-a5f5-5aca17ec69eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/youtube/status","description":"<p>Returns YouTube integration status and channel information.</p>\n","urlObject":{"path":["api","youtube","status"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"efdfcb99-acc9-472f-a5f5-5aca17ec69eb"},{"name":"Get Channel Videos","id":"bcb7743e-2934-41fc-b9de-3093326c4b7d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/youtube/videos","description":"<p>Returns all videos from connected YouTube channel.</p>\n","urlObject":{"path":["api","youtube","videos"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"bcb7743e-2934-41fc-b9de-3093326c4b7d"},{"name":"Get Video Comments","id":"9bdc614d-55ca-4328-87fa-853efabed2c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/youtube/comments?videoId=dQw4w9WgXcQ","description":"<p>Retrieves comments for a specific video with sentiment analysis.</p>\n","urlObject":{"path":["api","youtube","comments"],"host":["http://localhost:3000"],"query":[{"description":{"content":"<p>YouTube video ID</p>\n","type":"text/plain"},"key":"videoId","value":"dQw4w9WgXcQ"}],"variable":[]}},"response":[],"_postman_id":"9bdc614d-55ca-4328-87fa-853efabed2c3"},{"name":"Get Channel Stats","id":"0ee2823f-3e19-49b4-b26c-175674f05778","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/youtube/stats","description":"<p>Returns comprehensive channel statistics and analytics.</p>\n","urlObject":{"path":["api","youtube","stats"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"0ee2823f-3e19-49b4-b26c-175674f05778"}],"id":"38398be2-d06b-412b-b521-5353afaaa673","description":"<p>YouTube channel integration with OAuth 2.0 authentication and data synchronization.</p>\n","_postman_id":"38398be2-d06b-412b-b521-5353afaaa673"},{"name":"AI-Powered Features","item":[{"name":"Generate Video Report","id":"9a7bdb0f-562a-456d-aa14-ebee531701dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/youtube/report/dQw4w9WgXcQ","description":"<p>Creates comprehensive AI analysis report for a specific video.</p>\n","urlObject":{"path":["api","youtube","report","dQw4w9WgXcQ"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"9a7bdb0f-562a-456d-aa14-ebee531701dd"},{"name":"Generate Smart Replies","id":"af18f5fa-90cc-43ad-bf30-1fc2422ccb8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"comments\": [\n    {\n      \"id\": \"comment123\",\n      \"text\": \"Great tutorial! Can you make one on React?\",\n      \"author\": \"John\"\n    }\n  ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/api/youtube/smart-replies","description":"<p>Creates AI-powered, contextual responses to comments.</p>\n","urlObject":{"path":["api","youtube","smart-replies"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"af18f5fa-90cc-43ad-bf30-1fc2422ccb8f"},{"name":"Generate Video Ideas","id":"fd4d2b6e-6a9a-4c52-8c10-9bb371b70726","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"count\": 5,\n  \"category\": \"tutorial\",\n  \"targetAudience\": \"beginners\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/api/dashboard/ideas/generate","description":"<p>Creates AI-powered video content ideas based on channel analysis.</p>\n","urlObject":{"path":["api","dashboard","ideas","generate"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"fd4d2b6e-6a9a-4c52-8c10-9bb371b70726"},{"name":"AI Chat Assistant","id":"3477b5e4-df6a-416c-8ce9-ddf0327e4f26","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"message\": \"What's my best performing video and why?\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/api/youtube/chat","description":"<p>Interactive AI assistant for channel analytics and insights.</p>\n","urlObject":{"path":["api","youtube","chat"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"3477b5e4-df6a-416c-8ce9-ddf0327e4f26"}],"id":"bfa66649-001a-43c7-878a-f08a0ed40cf3","description":"<p>Advanced AI capabilities for content analysis, generation, and insights.</p>\n","_postman_id":"bfa66649-001a-43c7-878a-f08a0ed40cf3"},{"name":"Dashboard & Settings","item":[{"name":"Get Settings","id":"48b54628-7387-4c91-93d2-03230973245b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/dashboard/settings","description":"<p>Returns all user settings and preferences.</p>\n","urlObject":{"path":["api","dashboard","settings"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"48b54628-7387-4c91-93d2-03230973245b"},{"name":"Update Settings","id":"2fd77dd8-c157-46a1-8ba2-9c54f9686322","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"emailNotifications\": true,\n  \"weeklyDigest\": false,\n  \"negativeSentimentAlerts\": false,\n  \"language\": \"hi\",\n  \"theme\": \"dark\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/api/dashboard/settings","description":"<p>Updates user preferences and settings.</p>\n","urlObject":{"path":["api","dashboard","settings"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"2fd77dd8-c157-46a1-8ba2-9c54f9686322"}],"id":"32b556a7-db38-4068-b5c8-eb040899abde","description":"<p>Dashboard settings and configuration for user preferences and app settings.</p>\n","_postman_id":"32b556a7-db38-4068-b5c8-eb040899abde"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["// Auto-set JWT token from cookie if available","if (!pm.environment.get('jwt_token') && pm.cookies.has('axion_auth')) {","    pm.environment.set('jwt_token', pm.cookies.get('axion_auth'));","}","","// Add request timestamp for debugging","pm.environment.set('request_timestamp', new Date().toISOString());","","// Increment request counter","const counter = pm.environment.get('request_counter') || 0;","pm.environment.set('request_counter', parseInt(counter) + 1);"],"id":"e342211e-ed06-4ca3-a146-5808472604db"}},{"listen":"test","script":{"type":"text/javascript","exec":["// Success response validation","if (pm.response.code >= 200 && pm.response.code < 300) {","    pm.test('Status code is successful', () => {","        pm.expect(pm.response.code).to.be.oneOf([200, 201, 204]);","    });","    ","    // Check for JSON response","    try {","        const jsonData = pm.response.json();","        pm.test('Response is valid JSON', () => {","            pm.expect(jsonData).to.be.an('object');","        });","        ","        // Check for success field if present","        if (jsonData.success !== undefined) {","            pm.test('Success field is true', () => {","                pm.expect(jsonData.success).to.be.true;","            });","        }","    } catch (e) {","        console.log('Response is not JSON:', e.message);","    }","} else {","    pm.test('Error response handled', () => {","        pm.expect(pm.response.code).to.be.oneOf([400, 401, 403, 404, 429, 500]);","    });","}","","// Response time check","pm.test('Response time < 2000ms', () => {","    pm.expect(pm.response.responseTime).to.be.below(2000);","});"],"id":"7ee57329-3e8a-40cc-9aa2-2a0d881c51c8"}}],"variable":[{"key":"base_url","value":"http://localhost:3000","description":"API Base URL - Set to http://localhost:3000 for development or https://api.axionix.ai for production"},{"key":"jwt_token","value":"","description":"JWT Authentication Token - Auto-populated from axion_auth cookie after login"},{"key":"video_id","value":"dQw4w9WgXcQ","description":"YouTube Video ID - Default: Rick Astley video for testing"},{"key":"channel_id","value":"UCuAXFkgsw1L7xaCfndhlJqA","description":"YouTube Channel ID - Default: Example channel ID"},{"key":"request_counter","value":"0","description":"Request Counter - Auto-incremented for debugging"},{"key":"request_timestamp","value":"","description":"Request Timestamp - Auto-set to ISO timestamp for each request"}]}