GET /candidates/search — Search the Cutshort Talent Pool

Use this endpoint to query the Cutshort talent pool with fine-grained filters. You can combine skill requirements, experience range, location preferences, salary caps, and AI quality scores to surface the most relevant candidates.

Endpoint

GET https://api.cutshort.io/v1/candidates/search

Query Parameters

string

required

Comma-separated list of skill names. Case-insensitive. Example: python,django,postgresql

integer

Minimum years of professional experience.

integer

Maximum years of experience.

string

City name (e.g., Bengaluru, Mumbai, Pune) or Remote.

boolean

When true, only returns candidates open to remote roles.

integer

Maximum salary expectation in INR (annual). Filters out candidates expecting more.

integer

Minimum AI quality score, on a scale of 0–100. Recommended: 65–70 for a good signal.

string

Comma-separated availability statuses: active, open, not_looking. Returns all statuses if omitted.

integer

Page number for paginated results. Default: 1.

integer

Number of results per page. Maximum: 50. Default: 20.

Example Request

curl -X GET 'https://api.cutshort.io/v1/candidates/search?skills=python,fastapi&experience_min=4&location=Bengaluru&quality_score_min=70' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

response = requests.get(
    "https://api.cutshort.io/v1/candidates/search",
    params={
        "skills": "python,fastapi",
        "experience_min": 4,
        "location": "Bengaluru",
        "quality_score_min": 70
    },
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

const params = new URLSearchParams({
  skills: 'python,fastapi',
  experience_min: '4',
  location: 'Bengaluru',
  quality_score_min: '70'
});

const response = await fetch(
  `https://api.cutshort.io/v1/candidates/search?${params}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const data = await response.json();

Response

Returns 200 OK with a paginated list of matching candidate summary objects.

{
  "total": 284,
  "page": 1,
  "per_page": 20,
  "data": [
    {
      "id": "cand_8f3kL9mN",
      "name": "Priya Menon",
      "headline": "Senior Python Engineer",
      "location": "Bengaluru",
      "experience_years": 5,
      "skills": ["Python", "FastAPI", "PostgreSQL", "Docker"],
      "quality_score": 82,
      "availability": "active",
      "salary_expectation_min": 2000000,
      "salary_expectation_max": 2800000,
      "profile_url": "https://cutshort.io/candidate/priya-menon"
    }
  ]
}

Response Fields

integer

Total number of matching candidates across all pages.

integer

The current page number.

integer

Number of results returned per page.

array

List of candidate summary objects matching your query.

string

Unique Cutshort candidate ID (e.g., cand_8f3kL9mN).

string

The candidate’s full name.

string

The candidate’s professional headline or current role title (e.g., Senior Python Engineer).

integer

Total years of professional experience.

array

List of skill name strings associated with the candidate’s profile.

integer

Minimum expected annual salary in INR.

integer

Maximum expected annual salary in INR.

integer

AI-generated quality score from 0 to 100. Higher scores indicate stronger candidate fit.

string

The candidate’s current job-search availability. One of active, open, or not_looking.

string

Direct URL to the candidate’s full Cutshort profile.

Overview

Candidates

Jobs

Sourcing

Webhooks

GET /candidates/search — Search the Cutshort Talent Pool

Endpoint

Query Parameters

Example Request

Response

Response Fields

​Endpoint

​Query Parameters

​Example Request

​Response

​Response Fields

Endpoint

Query Parameters

Example Request

Response

Response Fields