Reef AI: ask for any data. Try it
Cutshort API

Cutshort jobs, companies and salaries for India, as JSON

endpoints
16
credits per call
0–2

Cutshort's own API is for employers who hire on the platform; it does not hand out the public job board.

/cutshort/v1

  • POST/cutshort/v1/search2 credits
  • POST/cutshort/v1/job1 credit
  • POST/cutshort/v1/similar-jobs1 credit
  • POST/cutshort/v1/company2 credits
  • POST/cutshort/v1/company-jobs2 credits
  • POST/cutshort/v1/company-search1 credit
  • POST/cutshort/v1/company-directory1 credit
  • POST/cutshort/v1/company-directories0 credits
  • POST/cutshort/v1/job-categories0 credits
  • POST/cutshort/v1/salary2 credits
16 active endpoints, on 0, 1 and 2 credit tiers.+6 more, every parameter ↓OpenAPI 3.0 spec ↗

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Cutshort API

6 of 16 endpoints, ready to run

View docs ↗

Search Cutshort jobs by skill and city

2 credits0 required · 3 optional
POST/cutshort/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Cutshort endpoints does ReefAPI ship?

16 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • search

    2 cr

    Search Cutshort jobs.

    required
    —
    optional
    query, location, remote, page, experience_years, min_salary_lakhs, max_salary_lakhs, role_type, remote_policy, company_type, posted_within_days, required_skills
  • job

    1 cr

    One Cutshort job ad in full.

    required
    job
    optional
    —
  • similar-jobs

    1 cr

    The 10 jobs Cutshort recommends next to a job ad, each in full (same fields as search).

    required
    job
    optional
    —
  • company

    2 cr

    Cutshort company profile.

    required
    company
    optional
    page
  • company-jobs

    2 cr

    A company's open Cutshort jobs, 10 per page (the site's page size) with the total and page count.

    required
    company
    optional
    page
  • company-search

    1 cr

    Find Cutshort companies by name (the site's own company search, 175,000+ companies).

    required
    query
    optional
    page, limit
  • company-directory

    1 cr

    A Cutshort company directory.

    required
    —
    optional
    category, location, page
  • company-directories

    0 cr

    Every Cutshort company directory (565.

    required
    —
    optional
    query, location, page
  • job-categories

    0 cr

    Every Cutshort job listing page (21,000+.

    required
    —
    optional
    query, location, remote, page
  • salary

    2 cr

    Cutshort salary data for a tech role in a city, remote or all India.

    required
    title
    optional
    location, experience_years, include_trends
  • salary-roles

    0 cr

    The roles Cutshort publishes salary pages for (37) and the locations each has (India, remote,…

    required
    —
    optional
    —
  • job-description

    1 cr

    A Cutshort job description template for a role (98 roles).

    required
    title
    optional
    —
  • job-description-roles

    0 cr

    Every Cutshort job description template (98 roles) with its slug and link.

    required
    —
    optional
    —
  • autocomplete

    1 cr

    Cutshort's own search-box suggestions.

    required
    query
    optional
    type, limit
  • locations

    0 cr

    The cities Cutshort has job listings and salary pages for, with the spellings each accepts.

    required
    —
    optional
    —
  • filters

    0 cr

    The fixed values Cutshort uses.

    required
    —
    optional
    —

Every parameter, every allowed value →

Missing a Cutshort endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Cutshort API works

Cutshort is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /cutshort/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
0 or 1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a skill and city to the pay band and the companies hiring

Search a skill in a city, open the ads you want, read each company's page, and compare with Cutshort's salary percentiles for the role.

01search?query=python&location=pune
GET/cutshort/v1/search?query=python&location=pune

50 full jobs a page: title, salary band, experience, skills, description, recruiter and company card, plus the listing's job count.

02job?job=<short_id>
GET/cutshort/v1/job?job=<short_id>

The ad as the job page shows it today, with its original posting date and live status.

03company?company=<company.alias>
GET/cutshort/v1/company?company=<company.alias>

Size band, funding stage, founding year, tech stack, hiring team, similar companies and open jobs.

04salary?title=data-scientist&location=bangalore
GET/cutshort/v1/salary?title=data-scientist&location=bangalore

Top 5, top 10 and top 20 percent pay for the role in that city, with the trend across cities and roles.

Open roles for one skill in one city with their advertised pay, set against the market pay for that role.

request
curl -X POST https://api.reefapi.com/cutshort/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"python","location":"bangalore"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "cutshort",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What a Cutshort field actually contains

Fields that read differently from how they look. Each row was measured on live Cutshort data on 2026-11-19.

FieldWhat it holds
salary.textThe salary line exactly as the job page prints it: "₹19L - ₹29L / yr", "Upto ₹60L / yr", "₹3000 - ₹4000 / mo", "Best in industry" or "… (ESOP available)". It matched the job page on 21 of 21 ads.
salary.min / salary.maxThe printed band in rupees per year, also for ads the page shows per month (period is then month and period_min / period_max hold the monthly figures). min is null on "Upto" bands.
salary.hidden_min / hidden_maxSet when the page prints "Best in industry": the band the employer chose not to show. 54 of 450 search rows. min and max are null on those rows.
salary.stored_min / stored_maxThe band stored on the job record. It can differ from the printed band: one ad printed ₹80L - ₹99L and stored 40 L - 99 L.
posted_at (search) vs posted_at (job)search rows carry the date of Cutshort's listing page, job carries the date of the job page. Cutshort re-dates an ad when the employer refreshes it, so the listing copy can be older: they differed on 21 of 21 ads, by minutes up to 13 days. jobposting_date_posted on job is the ad's original date.
list_total (search)The count in the listing heading ("4353+ Python Jobs in India"): every live job of that listing, unfiltered. Row filters never change it; total_scope says so in every answer. On big listings Cutshort serves fewer pages than that: 8 pages for Python, 15 for remote, 46 for all jobs.
filtered_on_page, rows_before_filtersRow filters (experience, salary, job type, remote policy, company type, posting age, skills) are applied only to the rows of the returned page; Cutshort does not offer these filters. filtered_on_page is then true and rows_before_filters is the page's size before narrowing: at least ₹20 L on Python page 1 kept 19 of 50.
last_page, has_nextCutshort does not say how many pages a listing has. last_page is filled once the end has been seen (a short page, or the page after a full one answering not found); until then has_next means "this page was full" and has_next_certain is false.
company.sizeA band, not a head count ("1000-5000"). Bands differ by company type: products 0-20 to 5000+, services 0-20 to 5000+, agencies 0-10 to 500+.
company.stage / fundingOne of Bootstrapped, Raised funding or Profitable. Cutshort does not publish investors or rounds.

Remote-only ads list no city: locations is empty and remote_policy is remote_only.

Coverage

Cutshort coverage, measured

Every number below comes from 230 live calls on 2026-11-19. 205 of 208 calls that should return data did, every action at 100 % except company-directory (37 of 40: one timeout before a fix, and two never-opened directories that were still being built and came back on the retry); the 22 calls meant to fail returned the right error.

Jobs

44,995 live jobs on 2026-11-19, on 21,060 listing pages: 3,700+ skills and roles for all of India, 14 cities and remote. Python: 4,341 in India, 1,864 in Bangalore, 919 remote.

Salary

37 to 49 of 50 ads per listing printed a band in rupees; the rest print "Best in industry" and return the hidden band separately. 10 of 2,223 ads offered ESOPs.

Accuracy

On 21 job pages from 7 listings the title, company, experience band, salary line and cities of the search row matched the page 21 of 21; the job action's title and salary 21 of 21, its posting date 20 of 21. All 21 ids opened the same job.

Paging

50 jobs a page, newest first, until Cutshort stops: 8 pages for Python, 15 for remote, 46 for all jobs. React.js in Pune: 414 rows for a listed 413. Consecutive pages shared 8 to 14 jobs because Cutshort caches each page separately.

Companies

175,096 companies in Cutshort's search, of which a name search serves the first 1,000 matches. 565 directories by industry and city, 50 companies a page. Company pages: type, size band and founding year on 9 of 9 checked, tech stack and FAQs on 3 of 9.

Salaries

37 roles in 14 cities, remote and all India, for 1 to 30 years of experience. Data scientist, Bangalore, 2 years: top 5 % ₹30 L, top 10 % ₹20 L, top 20 % ₹14 L. 98 job description templates.

Limits

No server-side filter for experience, salary or posting date: those are applied only to the rows of the returned page. No sort order other than newest first. No investors or funding rounds. Recruiter profile pages are not public; the recruiter's name and photo come with each ad. A listing or directory page not opened recently takes Cutshort 11 to 40 seconds to build once; past 38 seconds the call answers "still building, retry".

Use cases

What people build with Cutshort

The jobs this data is most often used for.

01

Track tech salaries in India: the advertised band of every new Python, React or DevOps job by city.

02

Feed a job board or alert service with full Cutshort ads, recruiter names and posting dates.

03

Build lists of hiring companies by industry and city with size band, funding stage and open-job count.

04

Benchmark pay for a role across 14 Indian cities and 1 to 30 years of experience.

16

endpoints

0/1/2

credits per call

Pricing

What Cutshort data costs

The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/cutshort/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"python","location":"bangalore"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/cutshort/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
        "query": "python",
        "location": "bangalore"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Cutshort.

Is there an official Cutshort API for job ads?▾

Cutshort offers an API to employers who hire on the platform, not a feed of its public job board. This API reads the public cutshort.io pages and returns JSON; no Cutshort account is needed.

Does it return the salary?▾

Yes, as the job page prints it, plus the figures in rupees. On 9 listings of 50 jobs each, 37 to 49 of 50 ads per listing showed a band; the rest print "Best in industry", and for those the band the employer hid comes back as hidden_min and hidden_max. 10 of 2,223 ads carried "ESOP available".

How do I search by skill and city?▾

query takes a skill or role (python, React.js, data scientist, devops engineer, product manager) and location takes one of 14 cities, remote, or nothing for all of India. Cutshort has a listing for each pair it publishes; a pair it does not have is refused with the cities that skill does have.

Which filters are there?▾

The listing itself is the site's only filter: skill or role, city or remote. The other filters (experience years, salary in lakhs, full-time or internship, remote policy, company type, days since posting, required skills) are applied only to the rows of the returned page; Cutshort does not offer them, and the answer says filtered_on_page with the row count before narrowing, while list_total stays the listing's unfiltered count. On Python page 1 (50 jobs): 3 years of experience kept 17, at least ₹20 L kept 18, remote only kept 12, product companies kept 4, posted in the last 7 days kept 7.

How deep can I page?▾

50 jobs a page, newest first, until Cutshort stops serving pages: 8 pages for Python in India, 15 for remote, 46 for all jobs; React.js in Pune ran to the end, 414 rows for a listed total of 413. Cutshort caches each page on its own, so page 1 can be newer than page 2: consecutive pages shared 8 to 14 of 50 jobs. Deduplicate by job_id.

Can I get a company's profile and open jobs?▾

Yes. company returns the profile with the hiring team and featured team, and its open jobs 10 at a time; company-jobs pages through them. Wissen Technology: 624 open jobs on 63 pages, 178 people in its hiring team. company accepts the company link, its alias or its name.

Where do the salary figures come from?▾

From Cutshort's salary pages: top 5, top 10 and top 20 percent pay in lakhs a year for 37 tech roles, in 14 cities, remote and all India. A data scientist in Bangalore with 2 years: ₹30 L, ₹20 L and ₹14 L; with 5 years: ₹47.5 L, ₹32.5 L and ₹25 L. The trend across cities and related roles comes with it.

How fast is it?▾

Median 1.0 s for a search page and 0.7 s for one job. A listing or company directory page nobody opened recently takes Cutshort itself 11 to 40 seconds to build the first time. Every call ends within 38 seconds: if the page is not ready by then the answer is a retryable "still building" error, and the next call gets the page in about a second (2 of 2 such retries: 3.6 s and 0.8 s).

What is the Cutshort API?▾

Cutshort API is a ReefAPI endpoint group for india tech jobs with salary bands from cutshort: job search by skill and city, full ads, company profiles and salary data. It returns live JSON through POST requests under /cutshort/v1.

Is the Cutshort API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Cutshort calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Cutshort login or account?▾

No login to Cutshort is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Cutshort data?▾

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Cutshort API use?▾

Cutshort actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Cutshort from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call cutshort actions with the same key, credit pool and JSON envelope used by normal REST requests.

Same key

32 Jobs & Hiring APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Cutshort, you are one call away from the rest of the category — no second contract, no second integration.

Already paying for something else?Cutshort vs Bright DataCutshort vs SerpApi
Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-19.