Resume SuperHero API Documentation

Authentication

All API requests require authentication using an API key. Include your API key in the request header:

X-API-Key: your_api_key_here

Get your free API key at theaisuperheroes.com/api/keys

Quick Start

1

Get Your API Key

Sign up for free and generate your API key from your dashboard. Free tier includes 100 calls/month.

2

Make Your First Call

Use curl, Python, or JavaScript to call any endpoint:

                            curl -X POST https://api.theaisuperheroes.com/v1/search-jobs \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Python Developer",
    "location": "remote"
  }'
                        

3

Deploy to Production

Integrate into your AI agent and start building resumes. See code examples below.

API Endpoints

POST /build-resume

Generate ATS-Optimized Resume

$0.50

per call

Generate a professionally formatted, ATS-optimized resume from user experience data. Automatically matches keywords from job descriptions.

Parameters

Parameter	Type	Description
user_name	string	required Full name of the user
email	string	required Email address for contact
target_role	string	required Target job title
job_description	string	Job posting text to optimize against
experience	array	Array of work experience entries
education	array	Array of education entries
skills	array	List of technical and professional skills

Example Request

POST /v1/build-resume

{
  "user_name": "Sarah Johnson",
  "email": "[email protected]",
  "phone": "+1-555-0100",
  "target_role": "Senior Product Manager",
  "job_description": "We're hiring a Senior PM with 5+ years experience...",
  "experience": [
    {
      "company": "Tech Corp",
      "title": "Product Manager",
      "start_date": "2021-01",
      "end_date": "Present",
      "bullets": [
        "Led product strategy resulting in 40% revenue growth",
        "Managed cross-functional team of 8 engineers and designers",
        "Launched 3 major features impacting 500k+ users"
      ]
    }
  ],
  "education": [
    {
      "school": "Stanford University",
      "degree": "BS",
      "field": "Computer Science",
      "year": "2018"
    }
  ],
  "skills": ["Product Management", "Agile", "Analytics", "User Research"]
}

Example Response

                            {
  "resume_url": "https://cdn.theaisuperheroes.com/resumes/sarah-johnson-2026.pdf",
  "ats_score": 94,
  "keyword_match_percentage": 87,
  "suggestions": [
    "Add quantified metrics to bullets 2-3",
    "Include 'Agile' and 'JIRA' in skills section",
    "Highlight budget management experience"
  ],
  "estimated_interviews": 25
}
                        

GET /search-jobs

Search Job Listings

$0.05

per call

Search real job listings from Indeed, LinkedIn, and other job boards. Filter by location, salary, experience level, and more.

Parameters

Parameter	Type	Description
query	string	required Job title or keyword
location	string	City/State or 'remote' (default: remote)
job_type	enum	fulltime, parttime, contract, internship
salary_min	number	Minimum annual salary in USD
max_results	number	Number of results to return (1-50, default: 10)

Example Request

                            GET /v1/search-jobs?query=Python+Developer&location=remote&job_type=fulltime&salary_min=120000&max_results=20
                        

Example Response

                            {
  "jobs": [
    {
      "job_id": "indeed_job_abc123",
      "title": "Senior Python Developer",
      "company": "Acme Tech Inc",
      "location": "Remote",
      "salary": "$150,000 - $180,000",
      "job_type": "fulltime",
      "description_snippet": "We're looking for an experienced Python developer...",
      "apply_url": "https://indeed.com/jobs?q=123",
      "posted_date": "2026-04-04T12:00:00Z",
      "match_score": 98
    }
  ],
  "total_results": 342,
  "search_time_ms": 245
}
                        

POST /auto-apply

Submit Job Application

$0.25

per call

Automatically submit a resume to a specific job listing. Handles cover letters, screening questions, and application tracking.

Parameters

Parameter	Type	Description
job_id	string	required Job ID from search results
resume_url	string	required URL to resume PDF
user_email	string	required Applicant email
auto_generate_cover_letter	boolean	Auto-generate personalized cover letter (default: true)

Example Request

POST /v1/auto-apply

{
  "job_id": "indeed_job_abc123",
  "resume_url": "https://cdn.theaisuperheroes.com/resumes/sarah-johnson.pdf",
  "user_email": "[email protected]",
  "auto_generate_cover_letter": true
}

Example Response

                            {
  "status": "submitted",
  "confirmation_id": "app_xyz789",
  "company": "Acme Tech Inc",
  "job_title": "Senior Python Developer",
  "applied_at": "2026-04-06T14:32:00Z",
  "tracking_url": "https://theaisuperheroes.com/apps/app_xyz789",
  "next_steps": "Company typically responds within 3-5 business days"
}
                        

GET /salary-research

Get Salary Data

$0.02

per call

Get comprehensive salary benchmarks, bonus ranges, and compensation data for any role and experience level.

Parameters

Parameter	Type	Description
job_title	string	required Job title to research
experience_level	enum	entry, mid, senior, lead, director, vp, executive
location	string	City/State or Country (default: US)
industry	string	Industry or vertical

Example Request

                            GET /v1/salary-research?job_title=Senior+Product+Manager&experience_level=senior&location=San+Francisco
                        

Example Response

                            {
  "job_title": "Senior Product Manager",
  "median_salary": 185000,
  "salary_low": 155000,
  "salary_high": 225000,
  "bonus_median": 15,
  "bonus_range": "10-25%",
  "equity_common": true,
  "total_compensation_median": 213000,
  "benefits_highlights": [
    "Health/Dental/Vision",
    "401(k) matching",
    "Stock options",
    "Remote work"
  ],
  "data_samples": 1247,
  "last_updated": "2026-04-06T00:00:00Z"
}
                        

POST /optimize-linkedin

Optimize LinkedIn Profile

$0.25

per call

Generate optimized LinkedIn headline, summary, and experience bullets to increase recruiter visibility and engagement.

Parameters

Parameter	Type	Description
current_title	string	required Current job title
target_role	string	Target position (optional)
skills	array	Current skills and expertise
tone	enum	professional, approachable, thought_leader, technical

Example Response

                            {
  "headline": "Senior Product Manager | AI/ML | B2B SaaS | Building Products at Scale",
  "headline_alternatives": [
    "Product Leader | AI/ML Systems | Former Meta Engineer | Now at TechCorp",
    "Senior PM - AI Platforms | 8+ Years | Shipped to 10M+ Users"
  ],
  "summary": "I build AI-powered products that scale. 8+ years driving adoption and growth...",
  "experience_bullets": [
    "Led AI feature adoption from 0→1, reaching 2M+ users in Q4",
    "Managed $15M+ budget across 3 product pillars"
  ],
  "skills_to_add": ["Large Language Models", "Prompt Engineering", "Gen AI"],
  "keywords_included": ["Product Strategy", "Cross-functional Leadership", "AI/ML"],
  "estimated_profile_strength": "advanced"
}
                        

Rate Limits

Default Rate Limit 100 requests/minute

Burst Limit 500 requests/15 min

Daily Limit 50,000 requests/24 hrs

HTTP Status Code 429 (Too Many Requests)

When rate limited, check the X-RateLimit-Reset header for when you can retry.

Code Examples

Python

import requests
import json

API_KEY = "your_api_key_here"
BASE_URL = "https://api.theaisuperheroes.com/v1"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json"
}

# Build a resume
resume_data = {
    "user_name": "Sarah Johnson",
    "email": "[email protected]",
    "target_role": "Senior Product Manager",
    "job_description": "We're hiring a Senior PM...",
    "experience": [
        {
            "company": "Tech Corp",
            "title": "Product Manager",
            "start_date": "2021-01",
            "end_date": "Present",
            "bullets": ["Led 40% revenue growth", "Managed team of 8"]
        }
    ],
    "skills": ["Product Management", "Agile", "Analytics"]
}

response = requests.post(
    f"{BASE_URL}/build-resume",
    headers=headers,
    json=resume_data
)

result = response.json()
print(f"Resume URL: {result['resume_url']}")
print(f"ATS Score: {result['ats_score']}")

# Search for jobs
jobs_response = requests.get(
    f"{BASE_URL}/search-jobs",
    headers=headers,
    params={
        "query": "Python Developer",
        "location": "remote",
        "max_results": 10
    }
)

jobs = jobs_response.json()
for job in jobs['jobs']:
    print(f"{job['title']} at {job['company']}")

JavaScript

const API_KEY = "your_api_key_here";
const BASE_URL = "https://api.theaisuperheroes.com/v1";

const headers = {
  "X-API-Key": API_KEY,
  "Content-Type": "application/json"
};

// Build a resume
async function buildResume(resumeData) {
  const response = await fetch(`${BASE_URL}/build-resume`, {
    method: "POST",
    headers,
    body: JSON.stringify(resumeData)
  });

  const result = await response.json();
  console.log(`Resume URL: ${result.resume_url}`);
  console.log(`ATS Score: ${result.ats_score}`);
  return result;
}

// Search for jobs
async function searchJobs(query, location) {
  const params = new URLSearchParams({
    query,
    location,
    max_results: 10
  });

  const response = await fetch(
    `${BASE_URL}/search-jobs?${params}`,
    { headers }
  );

  const jobs = await response.json();
  jobs.jobs.forEach(job => {
    console.log(`${job.title} at ${job.company}`);
  });
  return jobs;
}

// Auto apply to a job
async function applyToJob(jobId, resumeUrl) {
  const response = await fetch(`${BASE_URL}/auto-apply`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      job_id: jobId,
      resume_url: resumeUrl,
      user_email: "[email protected]",
      auto_generate_cover_letter: true
    })
  });

  return await response.json();
}

Affiliate Program

30%

Revenue Share

Monthly

Payouts

$50

Minimum Payout

Earn 30% commission on every API call from users you refer. Track real-time performance and get paid monthly via Stripe.

Join Affiliate Program

Getting Started

1. Sign Up

Create a free account at theaisuperheroes.com. Free tier includes 100 API calls per month.

2. Get Your API Key

Navigate to your dashboard and generate an API key. Store it securely and never share it publicly.

3. Make Your First Request

Use the code examples above to call any endpoint. Check the documentation for each endpoint's parameters and responses.

4. Scale Up

Upgrade to a paid plan as your needs grow. We offer flexible per-call pricing with no long-term contracts.

Support & Resources

Help & Support

24/7 support available via email

[email protected]

Status Page

Check API uptime and incident status

status.theaisuperheroes.com

Compliance

SOC2 Type II certified, GDPR & CCPA compliant

SLA

99.9% uptime guarantee with 500ms avg response time