Resume Parser API

{
  "status": 200,
  "statusText": "OK",
  "message": "Resume uploaded and parsed successfully",
  "upload_id": 18,
  "resume_file": "resume_JOHN-DOE_18_1776874753.pdf",
  "schema": "jsonresume",
  "data": {
    "basics": {
      "name": "John Doe",
      "label": "Programmer",
      "image": "",
      "email": "john@gmail.com",
      "phone": "(912) 555-4321",
      "url": "https://johndoe.com",
      "summary": "A summary of John Doe…",
      "location": {
        "address": "2712 Broadway St",
        "postalCode": "CA 94115",
        "city": "San Francisco",
        "countryCode": "US",
        "region": "California"
      },
      "profiles": [{
        "network": "Twitter",
        "username": "john",
        "url": "https://twitter.com/john"
      }]
    },
    "work": [{
      "name": "Company",
      "position": "President",
      "url": "https://company.com",
      "startDate": "2013-01-01",
      "endDate": "2014-01-01",
      "summary": "Description…",
      "highlights": ["Started the company"]
    }],
    "education": [{
      "institution": "University",
      "url": "https://institution.com/",
      "area": "Software Development",
      "studyType": "Bachelor",
      "startDate": "2011-01-01",
      "endDate": "2013-01-01",
      "score": "4.0",
      "courses": ["DB1101 - Basic SQL"]
    }],
    "skills": [{
      "name": "Web Development",
      "level": "Master",
      "keywords": ["HTML", "CSS", "JavaScript"]
    }],
    "projects": [{
      "name": "Project",
      "startDate": "2019-01-01",
      "endDate": "2021-01-01",
      "description": "Description...",
      "highlights": ["Won award at AIHacks 2016"],
      "url": "https://project.com/"
    }],
    "certificates": [{
      "name": "Certificate",
      "date": "2021-11-07",
      "issuer": "Company",
      "url": "https://certificate.com"
    }],
    "awards": [{
      "title": "Award",
      "date": "2014-11-01",
      "awarder": "Company",
      "summary": "There is no spoon."
    }],
    "publications": [{
      "name": "Publication",
      "publisher": "Company",
      "releaseDate": "2014-10-01",
      "url": "https://publication.com",
      "summary": "Description…"
    }],
    "languages": [{
      "language": "English",
      "fluency": "Native speaker"
    }],
    "interests": [{
      "name": "Wildlife",
      "keywords": ["Ferrets", "Unicorns"]
    }],
    "references": [{
      "name": "Jane Doe",
      "reference": "Reference…"
    }],
    "volunteer": [{
      "organization": "Organization",
      "position": "Volunteer",
      "url": "https://organization.com/",
      "startDate": "2012-01-01",
      "endDate": "2013-01-01",
      "summary": "Description…",
      "highlights": ["Awarded 'Volunteer of the Month'"]
    }]
  },
  "ats_scores": {
    "overall_score": 75,
    "breakdown": {
      "contact_info": 80,
      "work_experience": 75,
      "education": 80,
      "skills": 70
    },
    "feedback": [
      "Add more quantitative achievements to your work experience.",
      "Consider adding links to your projects."
    ]
  }
}

curl http://localhost:5000/api/resume/18

{
  "status": 200,
  "statusText": "OK",
  "message": "Resume fetched successfully",
  "upload_id": 18,
  "resume_file": "resume_JOHN-DOE_18_1776874753.pdf",
  "schema": "jsonresume",
  "data": {
    "basics": {...},
    "work": [...],
    "education": [...],
    "skills": [...],
    "projects": [...],
    "certificates": [...],
    "awards": [...],
    "publications": [...],
    "languages": [...],
    "interests": [...],
    "references": [...],
    "volunteer": [...]
  },
  "ats_scores": {
    "overall_score": 75,
    "breakdown": {
      "contact_info": 80,
      "work_experience": 75,
      "education": 80,
      "skills": 70
    },
    "feedback": [
      "Add more quantitative achievements to your work experience.",
      "Consider adding links to your projects."
    ]
  }
}

curl http://localhost:5000/api/templates?category=modern

{
  "status": 200,
  "statusText": "OK",
  "message": "Templates fetched successfully",
  "data": {
    "total": 5,
    "page": 1,
    "limit": 10,
    "pages": 1,
    "templates": [
      {
        "id": 1,
        "slug": "minimalist-clean",
        "name": "The Minimalist",
        "description": "Clean, structured layout with emphasis on typography.",
        "category": "modern",
        "thumbnail": "http://localhost:5000/static/templates/thumb/1.png",
        "color_scheme": {
          "primary": "#2c3e50",
          "secondary": "#f7f9fa",
          "text": "#333333",
          "accent": "#2c3e50"
        },
        "font_family": "Inter, sans-serif",
        "layout": "two_column",
        "is_premium": false,
        "template_file": "resume_1_minimalist.html",
        "sections": ["summary", "experience", "education", "skills"],
        "tags": ["minimal", "corporate", "ats-friendly"],
        "render_url": "http://localhost:5000/api/templates/1/render",
        "preview_url": "http://localhost:5000/api/templates/1/preview"
      }
    ]
  }
}

curl http://localhost:5000/api/templates/3

{
  "status": 200,
  "data": {
    "total": 3,
    "categories": [
      { "name": "modern",   "count": 5 },
      { "name": "creative", "count": 3 },
      { "name": "classic",  "count": 2 }
    ]
  }
}

{
  "personal_information": {
    "full_name": "Poonam Batham",
    "email": "poonam@example.com",
    "phone": "+91-9399435171",
    "location": "Gwalior, India",
    "linkedin_profile": "linkedin.com/in/poonam",
    "portfolio_website": "poonam.dev"
  },
  "professional_summary": "Python Backend Developer with 3 years...",
  "work_experience": [
    {
      "job_title": "Agentic AI Engineer",
      "company": "SummitCode",
      "location": "Remote",
      "duration": "Jan 2026 - Present",
      "responsibilities": ["Built AI agents", "Integrated LLMs"]
    }
  ],
  "education": [
    {
      "degree": "B.E.",
      "institution": "ITM University",
      "location": "Gwalior",
      "end_year": "2018"
    }
  ],
  "projects": [
    {
      "name": "Order Management System",
      "description": "Backend with Flask + RBAC",
      "technologies": ["Flask", "MySQL"]
    }
  ],
  "hobbies": ["Reading", "Coding"],
  "skills": ["Python", "Django", "Flask"],
  "certifications": [
    {
      "name": "AWS Certified",
      "issuing_organization": "Amazon Web Services",
      "date_obtained": "2024"
    }
  ]
}

{ "upload_id": 18 }

import { useState, useEffect } from "react";

const API = "https://pdf-read-k3ow.onrender.com";

function useDebounce(value, delay = 400) {
  const [debounced, setDebounced] = useState(value);
  useEffect(() => {
    const t = setTimeout(() => setDebounced(value), delay);
    return () => clearTimeout(t);
  }, [value, delay]);
  return debounced;
}

export default function ResumeBuilder() {
  const [templateId, setTemplateId] = useState(1);
  const [formData, setFormData] = useState({
    personal_information: { full_name: "", email: "" },
    professional_summary: "",
    work_experience: [],
    education: [],
    projects: [],
    hobbies: [],
    skills: [],
    certifications: []
  });

  // Debounce so we don't hit the API on every keystroke
  const debounced = useDebounce(formData, 400);
  const [html, setHtml] = useState("");

  useEffect(() => {
    fetch(`${API}/api/templates/${templateId}/html`, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(debounced)
    })
      .then(r => r.text())
      .then(setHtml);
  }, [debounced, templateId]);

  return (
    <div style={{ display: "grid", gridTemplateColumns: "1fr 1fr" }}>
      <Form data={formData} onChange={setFormData} />
      <iframe srcDoc={html} style={{ width: "100%", height: "100vh", border: 0 }} />
    </div>
  );
}

import { WebView } from "react-native-webview";

const [html, setHtml] = useState("");

useEffect(() => {
  const timer = setTimeout(async () => {
    const res = await fetch(`${API}/api/templates/${id}/html`, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(formData)
    });
    setHtml(await res.text());
  }, 400);
  return () => clearTimeout(timer);
}, [formData, id]);

<WebView source={{ html }} style={{ flex: 1 }} />

{
  "status": 200,
  "statusText": "OK",
  "message": "Template rendered successfully",
  "data": {
    "template_id": 3,
    "template_name": "Dark Mode Dev",
    "html": "<!DOCTYPE html><html>...</html>"
  }
}

# Sample data (for template thumbnails)
http://localhost:5000/api/templates/1/preview

# Real user data
http://localhost:5000/api/templates/3/preview?upload_id=18

<WebView
  source={{ uri: `${API}/api/templates/${templateId}/preview?upload_id=${uploadId}` }}
  style={{ flex: 1 }}
/>

<iframe
  src={`${API}/api/templates/${id}/preview?upload_id=${uploadId}`}
  style={{ width: "100%", height: "100vh", border: 0 }}
/>

{
  "status": 400,
  "statusText": "Bad Request",
  "message": "Human-readable message",
  "data": {
    "data": {
      "resume_file": null,
      "resume_analysed": false,
      "parsed_data": {
        "status": "error",
        "message": "...",
        "code": "ERROR_CODE",
        "data": null
      }
    }
  }
}

import { useState, useEffect } from "react";

const API = "http://localhost:5000";

export default function ResumeApp() {
  const [templates, setTemplates] = useState([]);
  const [uploadId, setUploadId] = useState(null);
  const [selected, setSelected] = useState(null);

  useEffect(() => {
    fetch(`${API}/api/templates`)
      .then(r => r.json())
      .then(j => setTemplates(j.data.templates));
  }, []);

  const handleUpload = async (e) => {
    const file = e.target.files[0];
    const form = new FormData();
    form.append("file", file);
    form.append("user_id", "2");

    const res = await fetch(`${API}/api/upload-resume`, {
      method: "POST",
      body: form
    });
    const j = await res.json();
    // Extract upload_id from resume_file filename pattern
    const match = j.data.data.resume_file.match(/_(\d+)_\d+\.pdf$/);
    setUploadId(match ? match[1] : null);
  };

  return (
    <div>
      <input type="file" accept=".pdf" onChange={handleUpload} />

      <div style={{display:"grid",gridTemplateColumns:"repeat(3,1fr)",gap:16}}>
        {templates.map(t => (
          <div key={t.id} onClick={() => setSelected(t.id)} style={{cursor:"pointer"}}>
            <img src={t.thumbnail} alt={t.name} style={{width:"100%"}} />
            <h4>{t.name}</h4>
          </div>
        ))}
      </div>

      {selected && uploadId && (
        <iframe
          src={`${API}/api/templates/${selected}/preview?upload_id=${uploadId}`}
          style={{width:"100%",height:"800px",border:0}}
        />
      )}
    </div>
  );
}

import React, { useState, useEffect } from "react";
import { View, FlatList, Image, TouchableOpacity, Text } from "react-native";
import { WebView } from "react-native-webview";
import * as DocumentPicker from "expo-document-picker";

const API = "http://192.168.1.10:5000";

export default function ResumeScreen() {
  const [templates, setTemplates] = useState([]);
  const [uploadId, setUploadId] = useState(null);
  const [selected, setSelected] = useState(null);

  useEffect(() => {
    fetch(`${API}/api/templates`)
      .then(r => r.json())
      .then(j => setTemplates(j.data.templates));
  }, []);

  const pickAndUpload = async () => {
    const res = await DocumentPicker.getDocumentAsync({ type: "application/pdf" });
    if (res.canceled) return;
    const file = res.assets[0];

    const form = new FormData();
    form.append("file", { uri: file.uri, name: file.name, type: "application/pdf" });
    form.append("user_id", "2");

    const r = await fetch(`${API}/api/upload-resume`, {
      method: "POST",
      body: form,
      headers: { "Content-Type": "multipart/form-data" }
    });
    const j = await r.json();
    const m = j.data.data.resume_file.match(/_(\d+)_\d+\.pdf$/);
    setUploadId(m ? m[1] : null);
  };

  if (selected && uploadId) {
    return (
      <WebView
        source={{ uri: `${API}/api/templates/${selected}/preview?upload_id=${uploadId}` }}
        style={{ flex: 1 }}
      />
    );
  }

  return (
    <View style={{ flex: 1 }}>
      <TouchableOpacity onPress={pickAndUpload}>
        <Text>Upload Resume</Text>
      </TouchableOpacity>

      <FlatList
        data={templates}
        numColumns={2}
        keyExtractor={t => String(t.id)}
        renderItem={({ item }) => (
          <TouchableOpacity onPress={() => setSelected(item.id)}>
            <Image source={{ uri: item.thumbnail }} style={{ width: 150, height: 200 }} />
            <Text>{item.name}</Text>
          </TouchableOpacity>
        )}
      />
    </View>
  );
}