Developer API v2.0

Stable

MyRarahaDeveloper API

Build powerful resume applications with our comprehensive RESTful API. Create, customize, and export professional resumes programmatically.

99.9%

API Uptime

<200ms

Avg Response

12+

Templates

50+

Endpoints

API Overview

The MyRaraha API enables developers to integrate professional resume building capabilities into their applications. Our RESTful API provides endpoints for resume creation, template management, export functionality, and more.

Resume Management

Create, update, delete, and retrieve resumes with full CRUD operations.

Template System

Access 12+ professional templates with customization options.

Export Formats

Generate PDF, DOCX, and HTML versions of resumes programmatically.

Base URL

https://api.myraraha.com/v2

Authentication

API Key Authentication

All API requests must include your API key in the Authorization header:

# Using curl

curl -H "Authorization: Bearer YOUR_API_KEY" \

https://api.myraraha.com/v2/resumes

OAuth 2.0 (Recommended)

For user-facing applications, use OAuth 2.0 with the authorization code flow:

// Redirect user to authorization URL

const authUrl = 'https://api.myraraha.com/oauth/authorize?'

+ 'client_id=YOUR_CLIENT_ID&'

+ 'response_type=code&'

+ 'scope=resumes:read resumes:write&'

+ 'redirect_uri=YOUR_REDIRECT_URI';

// Exchange code for access token

const tokenResponse = await fetch('/oauth/token', {

method: 'POST',

body: JSON.stringify({

grant_type: 'authorization_code',

code: authCode,

client_id: 'YOUR_CLIENT_ID',

client_secret: 'YOUR_CLIENT_SECRET'

})

});

Rate Limits

Standard Limits

Basic Plan

1,000/hour

Pro Plan

5,000/hour

Enterprise

20,000/hour

Response Headers

X-RateLimit-Limit: 5000

X-RateLimit-Remaining: 4999

X-RateLimit-Reset: 1640995200

HTTP/1.1 429 Too Many Requests

API Endpoints

Resume Management

GET

/resumesList all resumes

curl -H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/resumes?limit=10&offset=0"

POST

/resumesCreate new resume

curl -X POST \

-H "Authorization: Bearer $TOKEN" \

-H "Content-Type: application/json" \

-d '{"template_id": "modern", "title": "Software Engineer Resume"}' \

"https://api.myraraha.com/v2/resumes"

PUT

/resumes/{id}Update resume

curl -X PUT \

-H "Authorization: Bearer $TOKEN" \

-H "Content-Type: application/json" \

-d @resume_data.json \

"https://api.myraraha.com/v2/resumes/123"

DELETE

/resumes/{id}Delete resume

curl -X DELETE \

-H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/resumes/123"

Export & Generation

GET

/resumes/{id}/export/pdfGenerate PDF

curl -H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/resumes/123/export/pdf" \

--output resume.pdf

GET

/resumes/{id}/export/docxGenerate Word document

curl -H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/resumes/123/export/docx" \

--output resume.docx

Templates

GET

/templatesList available templates

curl -H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/templates"

Webhooks

Webhooks allow you to receive real-time notifications when events occur in your MyRaraha account.

Available Events

resume.created

resume.updated

resume.deleted

export.completed

export.failed

user.subscribed

user.unsubscribed

Webhook Payload Example

{
  "event": "resume.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "resume_id": "res_abc123",
    "user_id": "usr_def456",
    "template_id": "modern"
  }
}

SDKs & Libraries

JavaScript/Node.js

Official

Full-featured SDK for browser and Node.js environments.

Python

Official

Pythonic interface with async support and type hints.

Ruby

Community

Ruby gem with Rails integration and ActiveRecord support.

Quick Start Example (JavaScript)

// Install the SDK

npm install @myraraha/api-client

// Initialize client

import { MyRarahaAPI } from '@myraraha/api-client';

const client = new MyRarahaAPI({

apiKey: 'your-api-key',

environment: 'production' // or 'sandbox'

});

// Create a resume

const resume = await client.resumes.create({

templateId: 'modern',

title: 'My Professional Resume',

personalInfo: {

fullName: 'John Doe',

email: 'john@example.com',

phone: '+1-555-0123'

}

});

// Export to PDF

const pdfUrl = await client.resumes.exportToPDF(resume.id);

API Pricing

Starter

$29

per month

10,000 API calls/month

Basic templates

PDF export

Email support

Professional

$99

per month

50,000 API calls/month

All templates

PDF & DOCX export

Webhook support

Priority support

Enterprise

Custom

pricing

Unlimited API calls

Custom templates

All export formats

Advanced webhooks

Dedicated support

SLA guarantee

Usage-Based Pricing

Additional API calls beyond your plan limits are charged at $0.001 per call. Export operations (PDF/DOCX) count as 10 API calls each.

Interactive API Explorer

Test our API endpoints directly in your browser. No setup required - authenticate with your API key and start exploring.

API Explorer Coming Soon

Interactive API testing interface with real-time responses and code generation.

Live API testing

Code generation for multiple languages

Response validation and formatting

Ready to Start Building?

Join thousands of developers using MyRaraha API to build powerful resume applications.

API Overview

Resume Management

Create, update, delete, and retrieve resumes with full CRUD operations.

Template System

Access 12+ professional templates with customization options.

Export Formats

Generate PDF, DOCX, and HTML versions of resumes programmatically.

Base URL

https://api.myraraha.com/v2

Authentication

API Key Authentication

All API requests must include your API key in the Authorization header:

# Using curl

curl -H "Authorization: Bearer YOUR_API_KEY" \

https://api.myraraha.com/v2/resumes

OAuth 2.0 (Recommended)

For user-facing applications, use OAuth 2.0 with the authorization code flow:

// Redirect user to authorization URL

const authUrl = 'https://api.myraraha.com/oauth/authorize?'

+ 'client_id=YOUR_CLIENT_ID&'

+ 'response_type=code&'

+ 'scope=resumes:read resumes:write&'

+ 'redirect_uri=YOUR_REDIRECT_URI';

// Exchange code for access token

const tokenResponse = await fetch('/oauth/token', {

method: 'POST',

body: JSON.stringify({

grant_type: 'authorization_code',

code: authCode,

client_id: 'YOUR_CLIENT_ID',

client_secret: 'YOUR_CLIENT_SECRET'

})

});

API Endpoints

Resume Management

GET

/resumesList all resumes

curl -H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/resumes?limit=10&offset=0"

POST

/resumesCreate new resume

curl -X POST \

-H "Authorization: Bearer $TOKEN" \

-H "Content-Type: application/json" \

-d '{"template_id": "modern", "title": "Software Engineer Resume"}' \

"https://api.myraraha.com/v2/resumes"

PUT

/resumes/{id}Update resume

curl -X PUT \

-H "Authorization: Bearer $TOKEN" \

-H "Content-Type: application/json" \

-d @resume_data.json \

"https://api.myraraha.com/v2/resumes/123"

DELETE

/resumes/{id}Delete resume

curl -X DELETE \

-H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/resumes/123"

Export & Generation

GET

/resumes/{id}/export/pdfGenerate PDF

curl -H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/resumes/123/export/pdf" \

--output resume.pdf

GET

/resumes/{id}/export/docxGenerate Word document

curl -H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/resumes/123/export/docx" \

--output resume.docx

Templates

GET

/templatesList available templates

curl -H "Authorization: Bearer $TOKEN" \

"https://api.myraraha.com/v2/templates"

Webhooks

Webhooks allow you to receive real-time notifications when events occur in your MyRaraha account.

Available Events

resume.created

resume.updated

resume.deleted

export.completed

export.failed

user.subscribed

user.unsubscribed

Webhook Payload Example

{
  "event": "resume.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "resume_id": "res_abc123",
    "user_id": "usr_def456",
    "template_id": "modern"
  }
}

SDKs & Libraries

JavaScript/Node.js

Official

Full-featured SDK for browser and Node.js environments.

Python

Official

Pythonic interface with async support and type hints.

Ruby

Community

Ruby gem with Rails integration and ActiveRecord support.

Quick Start Example (JavaScript)

// Install the SDK

npm install @myraraha/api-client

// Initialize client

import { MyRarahaAPI } from '@myraraha/api-client';

const client = new MyRarahaAPI({

apiKey: 'your-api-key',

environment: 'production' // or 'sandbox'

});

// Create a resume

const resume = await client.resumes.create({

templateId: 'modern',

title: 'My Professional Resume',

personalInfo: {

fullName: 'John Doe',

email: 'john@example.com',

phone: '+1-555-0123'

}

});

// Export to PDF

const pdfUrl = await client.resumes.exportToPDF(resume.id);

API Pricing

Starter

$29

per month

10,000 API calls/month

Basic templates

PDF export

Email support

Professional

$99

per month

50,000 API calls/month

All templates

PDF & DOCX export

Webhook support

Priority support

Enterprise

Custom

pricing

Unlimited API calls

Custom templates

All export formats

Advanced webhooks

Dedicated support

SLA guarantee

Usage-Based Pricing

Additional API calls beyond your plan limits are charged at $0.001 per call. Export operations (PDF/DOCX) count as 10 API calls each.

Interactive API Explorer

Test our API endpoints directly in your browser. No setup required - authenticate with your API key and start exploring.

API Explorer Coming Soon

Interactive API testing interface with real-time responses and code generation.

Live API testing

Code generation for multiple languages

Response validation and formatting