resumes.fyi APIresumes.fyi ↗
Access 1900+ real resumes from resumes.fyi that passed screens at top tech companies. Filter by role, level, company, school, and verification status.
curl -X GET 'https://api.parse.bot/scraper/3526a972-388a-49e4-b3f3-ce1a8880114e/list_resumes?page=1&role=software-engineer&limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
List resumes with metadata and image URLs. Supports pagination and filtering by role, level, company, school, and verified status. Returns resume image URLs, user info, companies, skills, experiences, and education. Results are sorted by most-screened.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). |
| role | string | Filter by role slug. Accepted values: software-engineer, data-scientist, product-manager, product-designer, engineering-manager, data-analyst, other. |
| level | string | Filter by level. Accepted values: intern, new-grad, full-time, part-time, contract, freelance, no-experience. |
| limit | integer | Results per page (max 50). |
| school | string | Filter by school/university name. |
| company | string | Filter by company slug (e.g. google, meta, amazon). |
| verified_only | boolean | Only show verified resumes. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"limit": "integer - results per page",
"total": "integer - total number of matching resumes",
"resumes": "array of resume objects with username, user_id, first_name, last_name, resume_id, resume_image_url, role, role_slug, level, education, country, verified, like_count, view_count, created_at, company_name, companies, skills, experiences, educations, profile_urls, user_image",
"has_more": "boolean - whether more pages exist",
"total_pages": "integer - total number of pages"
},
"sample": {
"data": {
"page": 1,
"limit": 5,
"total": 1637,
"resumes": [
{
"role": "Software Engineer",
"level": "full-time",
"skills": [
"Academic Writing",
"App Developer"
],
"country": "United States",
"user_id": "659aa755-54c4-4ba9-90e3-7ebe79c63071",
"username": "ngothinh2511",
"verified": true,
"companies": [
{
"name": "IMC",
"slug": "imc",
"domain": "imc.com"
}
],
"education": "University of Houston",
"last_name": "Ngo",
"resume_id": "c92ccccb-d326-44e4-a6a7-a3ac9d8ec484",
"role_slug": "software-engineer",
"created_at": "2024-10-06T05:10:51.461Z",
"educations": [
{
"gpa": null,
"major": null,
"degree": "Bachelors of Science in Computer Science, Minor in Mathematics",
"school": "University of Houston"
}
],
"first_name": "Edward",
"like_count": 2,
"user_image": null,
"view_count": 1447,
"experiences": [
{
"company": "NASA",
"end_date": "2025-09-28",
"position": "Software Engineer Intern",
"start_date": "2024-09-01"
}
],
"company_name": "NASA",
"profile_urls": {
"github": "https://github.com/THINNGO2511",
"linkedin": "https://www.linkedin.com/in/ngothinh/"
},
"resume_image_url": "https://q1hlr76qehnlfpdb.public.blob.vercel-storage.com/resumes/c92ccccb-d326-44e4-a6a7-a3ac9d8ec484/r.png"
}
],
"has_more": true,
"total_pages": 328
},
"status": "success"
}
}About the resumes.fyi API
The resumes.fyi API exposes data from over 1,900 real resumes that cleared hiring screens at top tech companies, across 2 endpoints. list_resumes lets you paginate and filter the full catalog by role, experience level, company, school, and verification status, returning resume image URLs alongside structured metadata. get_resume retrieves a single resume in detail, including complete skill lists, education records, and company tags.
Browsing and Filtering Resumes
The list_resumes endpoint returns a paginated array of resume objects sortable by most-screened. Each item includes username, resume_id, resume_image_url, role, role_slug, level, and associated companies and education. You can narrow results with query parameters: role accepts slugs like software-engineer, data-scientist, product-manager, and product-designer; level accepts values like intern, new-grad, full-time, and contract; and company accepts slugs such as google, meta, or amazon. The verified_only boolean restricts results to resumes that carry verified status. Pagination is controlled via page (1-indexed) and limit (up to 50 per page), with total, total_pages, and has_more returned to support cursor-style traversal.
Retrieving a Single Resume
The get_resume endpoint accepts a username — obtainable from list_resumes results — and returns the full detail record for that resume. Response fields include skills (an array of strings), companies (array of objects with name, slug, and domain), educations (array with school, degree, major, and gpa), resume_image_url, role_slug, and the unique resume_id and user_id. This is the right endpoint when you need the complete skills list or full education history rather than the summary fields returned in list results.
Coverage and Scope
The dataset covers roles across software engineering, data science, product management, and product design. Experience levels span intern through freelance and contract. Resumes can be optionally filtered to those marked verified, which resumes.fyi uses to indicate the candidate successfully cleared a resume screen at a named company. The companies field on each resume reflects where the resume was accepted, not merely where the candidate worked.
- Analyze which skills appear most frequently on verified software-engineer resumes at FAANG companies by aggregating the
skillsarray across filtered results. - Build a resume benchmark tool that compares a user's education details against the
educationsfield from resumes at their target company. - Scrape resume image URLs via
resume_image_urlto create a visual gallery of accepted resumes for a specific role and level combination. - Generate a dataset of GPA distributions among new-grad hires at top tech firms using the
gpafield fromeducations. - Power a job-prep app that surfaces real resumes for a given
companyslug so candidates can study formats that passed screening. - Filter by
schoolparameter to identify which universities are most represented among verified resumes at specific companies. - Compare resume structures across
levelvalues (intern vs. full-time) to study how detail and length shift with seniority.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does resumes.fyi have an official developer API?+
What does `get_resume` return that `list_resumes` doesn't?+
get_resume returns the complete skills array, full educations records (including degree, major, and gpa), and the full companies array with domain fields. list_resumes returns a summary subset of these fields sufficient for browsing but not for detailed analysis.Does the API return the actual resume PDF or only an image?+
resume_image_url field, which points to an image rendering of the resume. PDF files are not exposed. You can fork this API on Parse and revise it to add a PDF download endpoint if the source makes that format available.Can I filter resumes by a specific skill, such as 'Python' or 'Figma'?+
role, level, company, school, and verified_only. Skill-level filtering is not a supported parameter. You can fork this API on Parse and revise it to add a skill-based filter endpoint.How fresh is the resume data, and how many resumes are available in total?+
total field in list_resumes responses always reflects the current count matching your filters. Freshness depends on when resumes.fyi's own catalog is updated; the API returns whatever is currently available in the catalog.