{% extends "base.html" %} {% block title %}API Documentation{% endblock %} {% block content %}

📘 Resume Ranker API Documentation

🔗 Endpoint

POST https://rankapply-api.hf.space/rank-resumes

🔐 Authentication

Include your API key in the Authorization header:

Authorization: Bearer your_api_key_here

Never share your API key publicly. Treat it like a password.

Request Parameters

📥 Example Request (cURL)

curl -X POST https://rankapply-api.hf.space/rank-resumes \
  -H "Authorization: Bearer your_api_key_here" \
  -F "resumes=@cv1.pdf" \
  -F "resumes=@cv2.pdf" \
  -F "job_description=We are hiring a backend engineer..."

📥 Example Request (Python)

import requests

headers = {
    "Authorization": "Bearer your_api_key_here"
}
files = [
    ('resumes', ('cv1.pdf', open('cv1.pdf', 'rb'), 'application/pdf')),
    ('resumes', ('cv2.pdf', open('cv2.pdf', 'rb'), 'application/pdf')),
]
data = {
    "job_description": "We are hiring a backend engineer..."
}

response = requests.post("https://rankapply-api.hf.space/rank-resumes", headers=headers, files=files, data=data)
print(response.json())

Sample Response

{
  "job_description": "We are hiring a backend engineer...",
  "ranked_resumes": [
    {
      "filename": "cv2.pdf",
      "score": 0.8745
    },
    {
      "filename": "cv1.pdf",
      "score": 0.6721
    }
  ]
}

Try It Now

{% if response %}

🔍 Resume Ranking Results

Job Description: {{ response.job_description }}

{% for r in response.ranked_resumes %} {% endfor %}
Filename Score
{{ r.filename }} {{ r.score }}
{% endif %}

← Back to Dashboard

{% endblock %}