Skip to main content
GET
Search talent database

Authorizations

Authorization
string
header
required

Workspace-scoped API key. Prefix: cs_live_. Eval keys (self-serve from Cutshort → Settings → Integrations → API Key) can search and get candidate details within small quotas; production keys add job posting and candidate messaging with higher limits.

Query Parameters

q
string

NLP / AI search query. Rewritten then embedded for semantic ranking. Can be combined with structured filters.

Maximum string length: 50000
inresume
string

Lucene boolean over full resume text. Use quoted phrases, OR within synonym groups, AND between groups, e.g. ("React" OR "React.js") AND ("TypeScript"). This is the way to express skill requirements — there is no separate skills parameter.

locations
string

Desired work locations (dash-separated, URL-encoded)

currlocation
string

Candidate's current location (same encoding as locations)

minexp
string

Min experience (years, decimal ok)

maxexp
string

Max experience (years)

minsal
string

Min current CTC (INR)

maxsal
string

Max current CTC (INR). Always include to cap results.

canjoinin
string

Max days to join (e.g. 30)

onNoticePeriodOrNotWorking
string

true = only candidates on notice period or not working

eduPed
string

Education pedigree tiers, dash-separated: tier1plus (IIT/IIM top), tier1, tier2. Example: tier1plus-tier1

startupExp
string

Startup background, dash-separated: funded_startup, other_startup

not_itExp
string

Exclude IT-services background, dash-separated: largeITServices, otherITServices

entrExp
string

Entrepreneurship background, dash-separated: cofounder, earlyEmployee

domainTags
string

Industry/domain background, dash-separated. Values: banking_and_finance, healthcare, ecommerce, computer_security, travel, edtech_education, gaming, consumer_internet, b2b_saas, software_product, gcc. High-confidence matching is always applied.

profileAttributesMode
enum<string>

'or' = profile attributes (eduPed, startupExp, entrExp, domainTags) match ANY instead of ALL. Default (omitted): all supplied profile attributes must match.

Available options:
or
activity
string

Candidate activity recency: active-3-months or active-6-months

page
integer
default:1
Required range: x >= 1
pageSize
integer
default:10

Results per page (default 10, max 20)

Required range: 1 <= x <= 20

Response

Search results (index-served triage hits; no identity fields)

results
object[]
page
integer
pageSize
integer

Requested page size (default 10, max 20)

totalCount
integer
searchType
enum<string>
Available options:
structured,
ai